FileDocCategorySizeDatePackage
TextCatalogReader.javaAPI DocJava SE 6 API7924Tue Jun 10 00:23:00 BST 2008com.sun.org.apache.xml.internal.resolver.readers

TextCatalogReader

public class TextCatalogReader extends Object implements com.sun.org.apache.xml.internal.resolver.readers.CatalogReader
Parses plain text Catalog files.

This class reads plain text Open Catalog files.

see
Catalog
author
Norman Walsh Norman.Walsh@Sun.COM
version
1.0

Fields Summary
protected InputStream
catfile
The input stream used to read the catalog
protected int[]
stack
Character lookahead stack. Reading a catalog sometimes requires up to two characters of lookahead.
protected Stack
tokenStack
Token stack. Recognizing an unexpected catalog entry requires the ability to "push back" a token.
protected int
top
The current position on the lookahead stack
protected boolean
caseSensitive
Are keywords in the catalog case sensitive?
Constructors Summary
public TextCatalogReader()
Construct a CatalogReader object.


         
     
Methods Summary
protected voidfinalize()
The destructor.

Makes sure the catalog file is closed.

    if (catfile != null) {
      try {
	catfile.close();
      } catch (IOException e) {
	// whatever...
      }
    }
    catfile = null;
  
public booleangetCaseSensitive()

    return caseSensitive;
  
protected intnextChar()
Return the next logical character from the input stream.

return
The next (logical) character from the input stream. The character may be buffered from a previous lookahead.
throws
IOException If an error occurs reading from the stream.

    if (top < 0) {
      return catfile.read();
    } else {
      return stack[top--];
    }
  
protected java.lang.StringnextToken()
Return the next token in the catalog file.

FYI: This code does not throw any sort of exception for a file that contains an n

return
The Catalog file token from the input stream.
throws
IOException If an error occurs reading from the stream.

    String token = "";
    int ch, nextch;

    if (!tokenStack.empty()) {
      return (String) tokenStack.pop();
    }

    // Skip over leading whitespace and comments
    while (true) {
      // skip leading whitespace
      ch = catfile.read();
      while (ch <= ' ") {      // all ctrls are whitespace
	ch = catfile.read();
	if (ch < 0) {
	  return null;
	}
      }

      // now 'ch' is the current char from the file
      nextch = catfile.read();
      if (nextch < 0) {
	return null;
      }

      if (ch == '-" && nextch == '-") {
	// we've found a comment, skip it...
	ch = ' ";
	nextch = nextChar();
	while ((ch != '-" || nextch != '-") && nextch > 0) {
	  ch = nextch;
	  nextch = nextChar();
	}

	if (nextch < 0) {
	  throw new CatalogException(CatalogException.UNENDED_COMMENT,
				     "Unterminated comment in catalog file; EOF treated as end-of-comment.");
	}

	// Ok, we've found the end of the comment,
	// loop back to the top and start again...
      } else {
	stack[++top] = nextch;
	stack[++top] = ch;
	break;
      }
    }

    ch = nextChar();
    if (ch == '"" || ch == '\'") {
      int quote = ch;
      while ((ch = nextChar()) != quote) {
	char[] chararr = new char[1];
	chararr[0] = (char) ch;
	String s = new String(chararr);
	token = token.concat(s);
      }
      return token;
    } else {
      // return the next whitespace or comment delimited
      // string
      while (ch > ' ") {
	nextch = nextChar();
	if (ch == '-" && nextch == '-") {
	  stack[++top] = ch;
	  stack[++top] = nextch;
	  return token;
	} else {
	  char[] chararr = new char[1];
	  chararr[0] = (char) ch;
	  String s = new String(chararr);
	  token = token.concat(s);
	  ch = nextch;
	}
      }
      return token;
    }
  
public voidreadCatalog(com.sun.org.apache.xml.internal.resolver.Catalog catalog, java.lang.String fileUrl)
Start parsing a text catalog file. The file is actually read and parsed as needed by nextEntry.

param
fileUrl The URL or filename of the catalog file to process
throws
MalformedURLException Improper fileUrl
throws
IOException Error reading catalog file

    URL catURL = null;

    try {
      catURL = new URL(fileUrl);
    } catch (MalformedURLException e) {
      catURL = new URL("file:///" + fileUrl);
    }

    URLConnection urlCon = catURL.openConnection();
    try {
      readCatalog(catalog, urlCon.getInputStream());
    } catch (FileNotFoundException e) {
      catalog.getCatalogManager().debug.message(1, "Failed to load catalog, file not found",
						catURL.toString());
    }
  
public voidreadCatalog(com.sun.org.apache.xml.internal.resolver.Catalog catalog, java.io.InputStream is)


    catfile = is;

    if (catfile == null) {
      return;
    }

    Vector unknownEntry = null;

    try {
      while (true) {
	String token = nextToken();

	if (token == null) {
	  if (unknownEntry != null) {
	    catalog.unknownEntry(unknownEntry);
	    unknownEntry = null;
	  }
	  catfile.close();
	  catfile = null;
	  return;
	}

	String entryToken = null;
	if (caseSensitive) {
	  entryToken = token;
	} else {
	  entryToken = token.toUpperCase();
	}

	try {
	  int type = CatalogEntry.getEntryType(entryToken);
	  int numArgs = CatalogEntry.getEntryArgCount(type);
	  Vector args = new Vector();

	  if (unknownEntry != null) {
	    catalog.unknownEntry(unknownEntry);
	    unknownEntry = null;
	  }

	  for (int count = 0; count < numArgs; count++) {
	    args.addElement(nextToken());
	  }

	  catalog.addEntry(new CatalogEntry(entryToken, args));
	} catch (CatalogException cex) {
	  if (cex.getExceptionType() == CatalogException.INVALID_ENTRY_TYPE) {
	    if (unknownEntry == null) {
	      unknownEntry = new Vector();
	    }
	    unknownEntry.addElement(token);
	  } else if (cex.getExceptionType() == CatalogException.INVALID_ENTRY) {
	    catalog.getCatalogManager().debug.message(1, "Invalid catalog entry", token);
	    unknownEntry = null;
	  } else if (cex.getExceptionType() == CatalogException.UNENDED_COMMENT) {
	    catalog.getCatalogManager().debug.message(1, cex.getMessage());
	  }
	}
      }
    } catch (CatalogException cex2) {
      if (cex2.getExceptionType() == CatalogException.UNENDED_COMMENT) {
	catalog.getCatalogManager().debug.message(1, cex2.getMessage());
      }
    }
  
public voidsetCaseSensitive(boolean isCaseSensitive)

    caseSensitive = isCaseSensitive;