The XML DTD Parser API
<!ENTITY % name "John White" >signaling an error if an external parameter entity declaration, like:
<!ENTITY % ISOLat2 SYSTEM "http://www.xml.com/iso/isolat2-xml.entities" >is met. Future versions will be able to parse and handle external parameter entity declarations.
<![ INCLUDE [ ... ]]> <![ IGNORE [ ... ]]>
<?xml version="1.0" encoding="UTF-16"?>
The parser is fully compliant with the current XML specification, unless otherwise is stated, for instance it is able to parse Unicode text, provided the {@link java.io.Reader java.io.Reader} used to instantiate the parser is correctly set up.
The structure of the package:
The parser was written using JavaCC (Java Compiler Compiler) - an automated tool to generate Java programming language parsers.
This package consists of the following classes and files:
JAVA_UNICODE_ESCAPE = false; UNICODE_INPUT = false; USER_CHAR_STREAM = false;Note that this class is not fully JavaCC generated.
The following example parses the XML DTD file dtd-document.dtd and constructs the corresponding {@link org.exolab.castor.xml.dtd.DTDdocument XML DTD document} object dtd.
FileInputStream inputStream;
InputStreamReader reader;
InputCharStream charStream;
DTDInitialParser initialParser;
String intermedResult;
StringReader strReader;
DTDParser parser;
DTDdocument dtd;
// instantiate input byte stream, associated with the input file
inputStream = new FileInputStream( "dtd-document.dtd" );
// instantiate character reader from the input file byte stream
reader = new InputStreamReader( inputStream, "US-ASCII" );
// instantiate char stream for initial parser from the input reader
charStream = new InputCharStream( reader );
// instantiate initial parser
initialParser = new DTDInitialParser( charStream );
// get result of initial parsing - DTD text document with parameter
// entity references expanded
intermedResult = initialParser.Input();
// construct StringReader from the intermediate parsing result
strReader= new StringReader( intermedResult );
// instantiate char stream for the main parser
charStream = new InputCharStream( strReader );
// instantiate main parser
parser = new DTDParser( charStream );
// parse intermediate parsing result with the main parser
// and get corresponding DTD document oblect
dtd = parser.Input();