org.apache.xerces.parsers
Class DTDConfiguration

java.lang.Object
  extended by org.apache.xerces.util.ParserConfigurationSettings
      extended by org.apache.xerces.parsers.BasicParserConfiguration
          extended by org.apache.xerces.parsers.DTDConfiguration
All Implemented Interfaces:
XMLComponentManager, XMLParserConfiguration, XMLPullParserConfiguration
Direct Known Subclasses:
StandardParserConfiguration

public class DTDConfiguration
extends BasicParserConfiguration
implements XMLPullParserConfiguration

This is the DTD-only parser configuration. It extends the basic configuration with a standard set of parser components appropriate to DTD-centric validation. Since the Xerces2 reference implementation document and DTD scanner implementations are capable of acting as pull parsers, this configuration implements the XMLPullParserConfiguration interface.

In addition to the features and properties recognized by the base parser configuration, this class recognizes these additional features and properties:

Version:
$Id: DTDConfiguration.java 548192 2007-06-18 03:34:19Z mrglavas $
Author:
Arnaud Le Hors, IBM, Andy Clark, IBM, Neil Graham, IBM

Constructor Summary
DTDConfiguration()
          Default constructor.
DTDConfiguration(SymbolTable symbolTable)
          Constructs a parser configuration using the specified symbol table.
DTDConfiguration(SymbolTable symbolTable, XMLGrammarPool grammarPool)
          Constructs a parser configuration using the specified symbol table and grammar pool.
DTDConfiguration(SymbolTable symbolTable, XMLGrammarPool grammarPool, XMLComponentManager parentSettings)
          Constructs a parser configuration using the specified symbol table, grammar pool, and parent settings.
 
Method Summary
 void cleanup()
          If the application decides to terminate parsing before the xml document is fully parsed, the application should call this method to free any resource allocated during parsing.
 boolean parse(boolean complete)
          Parses the document in a pull parsing fashion.
 void parse(XMLInputSource source)
          Parses the specified input source.
 void setInputSource(XMLInputSource inputSource)
          Sets the input source for the document to parse.
 void setLocale(java.util.Locale locale)
          Set the locale to use for messages.
 
Methods inherited from class org.apache.xerces.parsers.BasicParserConfiguration
getDocumentHandler, getDTDContentModelHandler, getDTDHandler, getEntityResolver, getErrorHandler, getLocale, setDocumentHandler, setDTDContentModelHandler, setDTDHandler, setEntityResolver, setErrorHandler, setFeature, setProperty
 
Methods inherited from class org.apache.xerces.util.ParserConfigurationSettings
addRecognizedFeatures, addRecognizedProperties, getFeature, getProperty
 
Methods inherited from class java.lang.Object
equals, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
 
Methods inherited from interface org.apache.xerces.xni.parser.XMLParserConfiguration
addRecognizedFeatures, addRecognizedProperties, getDocumentHandler, getDTDContentModelHandler, getDTDHandler, getEntityResolver, getErrorHandler, getFeature, getLocale, getProperty, setDocumentHandler, setDTDContentModelHandler, setDTDHandler, setEntityResolver, setErrorHandler, setFeature, setProperty
 

Constructor Detail

DTDConfiguration

public DTDConfiguration()
Default constructor.


DTDConfiguration

public DTDConfiguration(SymbolTable symbolTable)
Constructs a parser configuration using the specified symbol table.

Parameters:
symbolTable - The symbol table to use.

DTDConfiguration

public DTDConfiguration(SymbolTable symbolTable,
                        XMLGrammarPool grammarPool)
Constructs a parser configuration using the specified symbol table and grammar pool.

REVISIT: Grammar pool will be updated when the new validation engine is implemented.

Parameters:
symbolTable - The symbol table to use.
grammarPool - The grammar pool to use.

DTDConfiguration

public DTDConfiguration(SymbolTable symbolTable,
                        XMLGrammarPool grammarPool,
                        XMLComponentManager parentSettings)
Constructs a parser configuration using the specified symbol table, grammar pool, and parent settings.

REVISIT: Grammar pool will be updated when the new validation engine is implemented.

Parameters:
symbolTable - The symbol table to use.
grammarPool - The grammar pool to use.
parentSettings - The parent settings.
Method Detail

setLocale

public void setLocale(java.util.Locale locale)
               throws XNIException
Set the locale to use for messages.

Specified by:
setLocale in interface XMLParserConfiguration
Overrides:
setLocale in class BasicParserConfiguration
Parameters:
locale - The locale object to use for localization of messages.
Throws:
XNIException - Thrown if the parser does not support the specified locale.

setInputSource

public void setInputSource(XMLInputSource inputSource)
                    throws XMLConfigurationException,
                           java.io.IOException
Sets the input source for the document to parse.

Specified by:
setInputSource in interface XMLPullParserConfiguration
Parameters:
inputSource - The document's input source.
Throws:
XMLConfigurationException - Thrown if there is a configuration error when initializing the parser.
java.io.IOException - Thrown on I/O error.
See Also:
parse(boolean)

parse

public boolean parse(boolean complete)
              throws XNIException,
                     java.io.IOException
Parses the document in a pull parsing fashion.

Specified by:
parse in interface XMLPullParserConfiguration
Parameters:
complete - True if the pull parser should parse the remaining document completely.
Returns:
True if there is more document to parse.
Throws:
XNIException - Any XNI exception, possibly wrapping another exception.
java.io.IOException - An IO exception from the parser, possibly from a byte stream or character stream supplied by the parser.
See Also:
setInputSource(org.apache.xerces.xni.parser.XMLInputSource)

cleanup

public void cleanup()
If the application decides to terminate parsing before the xml document is fully parsed, the application should call this method to free any resource allocated during parsing. For example, close all opened streams.

Specified by:
cleanup in interface XMLPullParserConfiguration

parse

public void parse(XMLInputSource source)
           throws XNIException,
                  java.io.IOException
Parses the specified input source.

Specified by:
parse in interface XMLParserConfiguration
Specified by:
parse in class BasicParserConfiguration
Parameters:
source - The input source.
Throws:
XNIException - Throws exception on XNI error.
java.io.IOException - Throws exception on i/o error.