org.apache.xerces.parsers
Class StandardParserConfiguration

java.lang.Object
  |
  +--org.apache.xerces.parsers.BasicParserConfiguration
        |
        +--org.apache.xerces.parsers.StandardParserConfiguration

public class StandardParserConfiguration
extends BasicParserConfiguration

This is the "standard" parser configuration. It extends the basic configuration with the standard set of parser components.

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

Version:
$Id: StandardParserConfiguration.java,v 1.1.2.14 2001/08/09 07:08:44 andyc Exp $
Author:
Arnaud Le Hors, IBM, Andy Clark, IBM

Field Summary
protected static java.lang.String ALLOW_JAVA_ENCODINGS
          Feature identifier: allow Java encodings.
protected static java.lang.String CONTINUE_AFTER_FATAL_ERROR
          Feature identifier: continue after fatal error.
protected static java.lang.String DATATYPE_VALIDATOR_FACTORY
          Property identifier: datatype validator factory.
protected static java.lang.String DOCUMENT_SCANNER
          Property identifier document scanner:
protected static java.lang.String DTD_SCANNER
          Property identifier: DTD scanner.
protected static java.lang.String ENTITY_MANAGER
          Property identifier: entity manager.
protected static java.lang.String ERROR_REPORTER
          Property identifier: error reporter.
protected  DatatypeValidatorFactory fDatatypeValidatorFactory
          Datatype validator factory.
protected  org.apache.xerces.xni.parser.XMLDTDScanner fDTDScanner
          DTD scanner.
protected  XMLEntityManager fEntityManager
          Entity manager.
protected  XMLErrorReporter fErrorReporter
          Error reporter.
protected  GrammarPool fGrammarPool
          Grammar pool.
protected  org.apache.xerces.xni.XMLLocator fLocator
          Locator
protected  boolean fParseInProgress
          True if a parse is in progress.
protected  org.apache.xerces.xni.parser.XMLDocumentScanner fScanner
          Document scanner.
protected  XMLValidator fValidator
          Validator.
protected static java.lang.String GRAMMAR_POOL
          Property identifier: grammar pool.
protected static java.lang.String LOAD_EXTERNAL_DTD
          Feature identifier: load external DTD.
protected static java.lang.String NOTIFY_BUILTIN_REFS
          Feature identifier: notify built-in refereces.
protected static java.lang.String VALIDATOR
          Property identifier: validator.
protected static java.lang.String WARN_ON_DUPLICATE_ATTDEF
          Feature identifier: warn on duplicate attribute definition.
protected static java.lang.String WARN_ON_UNDECLARED_ELEMDEF
          Feature identifier: warn on undeclared element definition.
 
Fields inherited from class org.apache.xerces.parsers.BasicParserConfiguration
ENTITY_RESOLVER, ERROR_HANDLER, EXTERNAL_GENERAL_ENTITIES, EXTERNAL_PARAMETER_ENTITIES, fComponents, fDocumentHandler, fDTDContentModelHandler, fDTDHandler, fFeatures, fProperties, fRecognizedFeatures, fRecognizedProperties, fSymbolTable, NAMESPACES, SYMBOL_TABLE, VALIDATION, XML_STRING
 
Constructor Summary
StandardParserConfiguration()
          Constructs a document parser using the default symbol table and grammar pool or the ones specified by the application (through the properties).
StandardParserConfiguration(SymbolTable symbolTable)
          Constructs a document parser using the specified symbol table.
StandardParserConfiguration(SymbolTable symbolTable, GrammarPool grammarPool)
          Constructs a document parser using the specified symbol table and grammar pool.
 
Method Summary
protected  void checkFeature(java.lang.String featureId)
          Check a feature.
protected  void checkProperty(java.lang.String propertyId)
          Check a property.
protected  void configurePipeline()
          Configures the pipeline.
protected  DatatypeValidatorFactory createDatatypeValidatorFactory()
          Create a datatype validator factory.
protected  org.apache.xerces.xni.parser.XMLDocumentScanner createDocumentScanner()
          Create a document scanner.
protected  org.apache.xerces.xni.parser.XMLDTDScanner createDTDScanner()
          Create a DTD scanner.
protected  XMLEntityManager createEntityManager()
          Creates an entity manager.
protected  XMLErrorReporter createErrorReporter()
          Creates an error reporter.
protected  XMLValidator createValidator()
          Create a validator.
 void parse(org.apache.xerces.xni.parser.XMLInputSource source)
          Parses the specified input source.
protected  void reset()
          Reset all components before parsing.
 void setLocale(java.util.Locale locale)
          Set the locale to use for messages.
 
Methods inherited from class org.apache.xerces.parsers.BasicParserConfiguration
addComponent, addRecognizedFeatures, addRecognizedProperties, getEntityResolver, getErrorHandler, getFeature, getProperty, setDocumentHandler, setDTDContentModelHandler, setDTDHandler, setEntityResolver, setErrorHandler, setFeature, setProperty
 
Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
 

Field Detail

WARN_ON_DUPLICATE_ATTDEF

protected static final java.lang.String WARN_ON_DUPLICATE_ATTDEF
Feature identifier: warn on duplicate attribute definition.

WARN_ON_UNDECLARED_ELEMDEF

protected static final java.lang.String WARN_ON_UNDECLARED_ELEMDEF
Feature identifier: warn on undeclared element definition.

ALLOW_JAVA_ENCODINGS

protected static final java.lang.String ALLOW_JAVA_ENCODINGS
Feature identifier: allow Java encodings.

CONTINUE_AFTER_FATAL_ERROR

protected static final java.lang.String CONTINUE_AFTER_FATAL_ERROR
Feature identifier: continue after fatal error.

LOAD_EXTERNAL_DTD

protected static final java.lang.String LOAD_EXTERNAL_DTD
Feature identifier: load external DTD.

NOTIFY_BUILTIN_REFS

protected static final java.lang.String NOTIFY_BUILTIN_REFS
Feature identifier: notify built-in refereces.

ERROR_REPORTER

protected static final java.lang.String ERROR_REPORTER
Property identifier: error reporter.

ENTITY_MANAGER

protected static final java.lang.String ENTITY_MANAGER
Property identifier: entity manager.

DOCUMENT_SCANNER

protected static final java.lang.String DOCUMENT_SCANNER
Property identifier document scanner:

DTD_SCANNER

protected static final java.lang.String DTD_SCANNER
Property identifier: DTD scanner.

GRAMMAR_POOL

protected static final java.lang.String GRAMMAR_POOL
Property identifier: grammar pool.

VALIDATOR

protected static final java.lang.String VALIDATOR
Property identifier: validator.

DATATYPE_VALIDATOR_FACTORY

protected static final java.lang.String DATATYPE_VALIDATOR_FACTORY
Property identifier: datatype validator factory.

fGrammarPool

protected GrammarPool fGrammarPool
Grammar pool.

fDatatypeValidatorFactory

protected DatatypeValidatorFactory fDatatypeValidatorFactory
Datatype validator factory.

fErrorReporter

protected XMLErrorReporter fErrorReporter
Error reporter.

fEntityManager

protected XMLEntityManager fEntityManager
Entity manager.

fScanner

protected org.apache.xerces.xni.parser.XMLDocumentScanner fScanner
Document scanner.

fDTDScanner

protected org.apache.xerces.xni.parser.XMLDTDScanner fDTDScanner
DTD scanner.

fValidator

protected XMLValidator fValidator
Validator.

fLocator

protected org.apache.xerces.xni.XMLLocator fLocator
Locator

fParseInProgress

protected boolean fParseInProgress
True if a parse is in progress. This state is needed because some features/properties cannot be set while parsing (e.g. validation and namespaces).
Constructor Detail

StandardParserConfiguration

public StandardParserConfiguration()
Constructs a document parser using the default symbol table and grammar pool or the ones specified by the application (through the properties).

StandardParserConfiguration

public StandardParserConfiguration(SymbolTable symbolTable)
Constructs a document parser using the specified symbol table.

StandardParserConfiguration

public StandardParserConfiguration(SymbolTable symbolTable,
                                   GrammarPool grammarPool)
Constructs a document parser using the specified symbol table and grammar pool.
Method Detail

setLocale

public void setLocale(java.util.Locale locale)
               throws org.apache.xerces.xni.XNIException
Set the locale to use for messages.
Parameters:
locale - The locale object to use for localization of messages.
Throws:
org.apache.xerces.xni.XNIException - Thrown if the parser does not support the specified locale.

parse

public void parse(org.apache.xerces.xni.parser.XMLInputSource source)
           throws org.apache.xerces.xni.XNIException,
                  java.io.IOException
Parses the specified input source.
Overrides:
parse in class BasicParserConfiguration
Parameters:
source - The input source.
Throws:
org.apache.xerces.xni.XNIException - Throws exception on XNI error.
java.io.IOException - Throws exception on i/o error.

reset

protected void reset()
              throws org.apache.xerces.xni.XNIException
Reset all components before parsing.
Overrides:
reset in class BasicParserConfiguration
Throws:
org.apache.xerces.xni.XNIException - Thrown if an error occurs during initialization.

configurePipeline

protected void configurePipeline()
Configures the pipeline.

checkFeature

protected void checkFeature(java.lang.String featureId)
                     throws org.apache.xerces.xni.parser.XMLConfigurationException
Check a feature. If feature is know and supported, this method simply returns. Otherwise, the appropriate exception is thrown.
Overrides:
checkFeature in class BasicParserConfiguration
Parameters:
featureId - The unique identifier (URI) of the feature.
Throws:
org.apache.xerces.xni.parser.XMLConfigurationException - Thrown for configuration error. In general, components should only throw this exception if it is really a critical error.

checkProperty

protected void checkProperty(java.lang.String propertyId)
                      throws org.apache.xerces.xni.parser.XMLConfigurationException
Check a property. If the property is know and supported, this method simply returns. Otherwise, the appropriate exception is thrown.
Overrides:
checkProperty in class BasicParserConfiguration
Parameters:
propertyId - The unique identifier (URI) of the property being set.
Throws:
org.apache.xerces.xni.parser.XMLConfigurationException - Thrown for configuration error. In general, components should only throw this exception if it is really a critical error.

createEntityManager

protected XMLEntityManager createEntityManager()
Creates an entity manager.

createErrorReporter

protected XMLErrorReporter createErrorReporter()
Creates an error reporter.

createDocumentScanner

protected org.apache.xerces.xni.parser.XMLDocumentScanner createDocumentScanner()
Create a document scanner.

createDTDScanner

protected org.apache.xerces.xni.parser.XMLDTDScanner createDTDScanner()
Create a DTD scanner.

createValidator

protected XMLValidator createValidator()
Create a validator.

createDatatypeValidatorFactory

protected DatatypeValidatorFactory createDatatypeValidatorFactory()
Create a datatype validator factory.


Copyright © 1999-2001 Apache XML Project. All Rights Reserved.