org.apache.xerces.parsers
Class NonValidatingConfiguration

java.lang.Object
  |
  +--org.apache.xerces.util.ParserConfigurationSettings
        |
        +--org.apache.xerces.parsers.BasicParserConfiguration
              |
              +--org.apache.xerces.parsers.NonValidatingConfiguration

All Implemented Interfaces:

org.apache.xerces.xni.parser.XMLComponentManager, org.apache.xerces.xni.parser.XMLParserConfiguration, org.apache.xerces.xni.parser.XMLPullParserConfiguration

public class NonValidatingConfiguration

extends BasicParserConfiguration

implements org.apache.xerces.xni.parser.XMLPullParserConfiguration

This is the non validating parser configuration. It extends the basic configuration with the set of following parser components: Document scanner, DTD scanner, namespace binder, document handler.

Xerces parser that uses this configuration is not conformant non-validating XML processor, since conformant non-validating processor is required to process "all the declarations they read in the internal DTD subset ... must use the information in those declarations to normalize attribute values, include the replacement text of internal entities, and supply default attribute values".

Version:

$Id: NonValidatingConfiguration.java,v 1.13 2004/02/24 23:15:57 mrglavas Exp $

Author:

Elena Litani, 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	DTD_VALIDATOR Property identifier: DTD validator.
protected static java.lang.String	ENTITY_MANAGER Property identifier: entity manager.
protected static java.lang.String	ERROR_REPORTER Property identifier: error reporter.
protected boolean	fConfigUpdated fConfigUpdated is set to true if there has been any change to the configuration settings, i.e a feature or a property was changed.
protected DTDDVFactory	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 org.apache.xerces.xni.grammars.XMLGrammarPool	fGrammarPool Grammar pool.
protected org.apache.xerces.xni.parser.XMLInputSource	fInputSource Input Source
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 ValidationManager	fValidationManager
protected static java.lang.String	LOAD_EXTERNAL_DTD Feature identifier: load external DTD.
protected static java.lang.String	NAMESPACE_BINDER Property identifier: namespace binder.
protected static java.lang.String	NORMALIZE_DATA Feature identifier: expose schema normalized value
protected static java.lang.String	NOTIFY_BUILTIN_REFS Feature identifier: notify built-in refereces.
protected static java.lang.String	NOTIFY_CHAR_REFS Feature identifier: notify character refereces.
protected static java.lang.String	SCHEMA_ELEMENT_DEFAULT Feature identifier: send element default value via characters()
protected static java.lang.String	SCHEMA_VALIDATOR Property identifier: XML Schema validator.
protected static java.lang.String	VALIDATION_MANAGER
protected static java.lang.String	WARN_ON_DUPLICATE_ATTDEF Feature identifier: warn on duplicate attribute definition.
protected static java.lang.String	WARN_ON_DUPLICATE_ENTITYDEF Feature identifier: warn on duplicate entity definition.
protected static java.lang.String	WARN_ON_UNDECLARED_ELEMDEF Feature identifier: warn on undeclared element definition.
protected static java.lang.String	XMLGRAMMAR_POOL Property identifier: grammar pool.

Fields inherited from class org.apache.xerces.parsers.BasicParserConfiguration

ENTITY_RESOLVER, ERROR_HANDLER, EXTERNAL_GENERAL_ENTITIES, EXTERNAL_PARAMETER_ENTITIES, fComponents, fDocumentHandler, fDTDContentModelHandler, fDTDHandler, fLastComponent, fLocale, fSymbolTable, NAMESPACES, SYMBOL_TABLE, VALIDATION, XML_STRING

Fields inherited from class org.apache.xerces.util.ParserConfigurationSettings

fFeatures, fParentSettings, fProperties, fRecognizedFeatures, fRecognizedProperties, PARSER_SETTINGS

Constructor Summary

NonValidatingConfiguration()
Default constructor.

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

NonValidatingConfiguration(SymbolTable symbolTable, org.apache.xerces.xni.grammars.XMLGrammarPool grammarPool)
Constructs a parser configuration using the specified symbol table and grammar pool.

NonValidatingConfiguration(SymbolTable symbolTable, org.apache.xerces.xni.grammars.XMLGrammarPool grammarPool, org.apache.xerces.xni.parser.XMLComponentManager parentSettings)
Constructs a parser configuration using the specified symbol table, grammar pool, and parent settings.

Method Summary

protected void	checkFeature(java.lang.String featureId) Check a feature.
protected void	checkProperty(java.lang.String propertyId) Check a property.
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.
protected void	configurePipeline() Configures the pipeline.
protected DTDDVFactory	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 ValidationManager	createValidationManager()
boolean	getFeature(java.lang.String featureId) Returns the state of a feature.
boolean	parse(boolean complete) Parses the document in a pull parsing fashion.
void	parse(org.apache.xerces.xni.parser.XMLInputSource source) Parses the specified input source.
protected void	reset() Reset all components before parsing.
void	setFeature(java.lang.String featureId, boolean state) Sets the state of a feature.
void	setInputSource(org.apache.xerces.xni.parser.XMLInputSource inputSource) Sets the input source for the document to parse.
void	setLocale(java.util.Locale locale) Set the locale to use for messages.
void	setProperty(java.lang.String propertyId, java.lang.Object value) Sets the value of a property.

Methods inherited from class org.apache.xerces.parsers.BasicParserConfiguration

addComponent, getDocumentHandler, getDTDContentModelHandler, getDTDHandler, getEntityResolver, getErrorHandler, getLocale, setDocumentHandler, setDTDContentModelHandler, setDTDHandler, setEntityResolver, setErrorHandler

Methods inherited from class org.apache.xerces.util.ParserConfigurationSettings

addRecognizedFeatures, addRecognizedProperties, getProperty

Methods inherited from class java.lang.Object

clone, equals, finalize, 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, getLocale, getProperty, setDocumentHandler, setDTDContentModelHandler, setDTDHandler, setEntityResolver, setErrorHandler

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_DUPLICATE_ENTITYDEF

protected static final java.lang.String WARN_ON_DUPLICATE_ENTITYDEF

Feature identifier: warn on duplicate entity 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.

NOTIFY_CHAR_REFS

protected static final java.lang.String NOTIFY_CHAR_REFS

Feature identifier: notify character refereces.

NORMALIZE_DATA

protected static final java.lang.String NORMALIZE_DATA

Feature identifier: expose schema normalized value

SCHEMA_ELEMENT_DEFAULT

protected static final java.lang.String SCHEMA_ELEMENT_DEFAULT

Feature identifier: send element default value via characters()

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.

XMLGRAMMAR_POOL

protected static final java.lang.String XMLGRAMMAR_POOL

Property identifier: grammar pool.

DTD_VALIDATOR

protected static final java.lang.String DTD_VALIDATOR

Property identifier: DTD validator.

NAMESPACE_BINDER

protected static final java.lang.String NAMESPACE_BINDER

Property identifier: namespace binder.

DATATYPE_VALIDATOR_FACTORY

protected static final java.lang.String DATATYPE_VALIDATOR_FACTORY

Property identifier: datatype validator factory.

VALIDATION_MANAGER

protected static final java.lang.String VALIDATION_MANAGER

SCHEMA_VALIDATOR

protected static final java.lang.String SCHEMA_VALIDATOR

Property identifier: XML Schema validator.

fGrammarPool

protected org.apache.xerces.xni.grammars.XMLGrammarPool fGrammarPool

Grammar pool.

fDatatypeValidatorFactory

protected DTDDVFactory 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.

fInputSource

protected org.apache.xerces.xni.parser.XMLInputSource fInputSource

Input Source

fDTDScanner

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

DTD scanner.

fValidationManager

protected ValidationManager fValidationManager

fConfigUpdated

protected boolean fConfigUpdated

fConfigUpdated is set to true if there has been any change to the configuration settings, i.e a feature or a property was changed.

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

NonValidatingConfiguration

public NonValidatingConfiguration()

Default constructor.

NonValidatingConfiguration

public NonValidatingConfiguration(SymbolTable symbolTable)

Constructs a parser configuration using the specified symbol table.

Parameters:

symbolTable - The symbol table to use.

NonValidatingConfiguration

public NonValidatingConfiguration(SymbolTable symbolTable,
                                  org.apache.xerces.xni.grammars.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.

NonValidatingConfiguration

public NonValidatingConfiguration(SymbolTable symbolTable,
                                  org.apache.xerces.xni.grammars.XMLGrammarPool grammarPool,
                                  org.apache.xerces.xni.parser.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

setFeature

public void setFeature(java.lang.String featureId,
                       boolean state)
                throws org.apache.xerces.xni.parser.XMLConfigurationException

Description copied from interface: org.apache.xerces.xni.parser.XMLParserConfiguration

Sets the state of a feature. This method is called by the parser and gets propagated to components in this parser configuration.

Specified by:

setFeature in interface org.apache.xerces.xni.parser.XMLParserConfiguration

Overrides:

setFeature in class BasicParserConfiguration

Following copied from interface: org.apache.xerces.xni.parser.XMLParserConfiguration

Parameters:

featureId - The feature identifier.

state - The state of the feature.

Throws:

org.apache.xerces.xni.parser.XMLConfigurationException - Thrown if there is a configuration error.

setProperty

public void setProperty(java.lang.String propertyId,
                        java.lang.Object value)
                 throws org.apache.xerces.xni.parser.XMLConfigurationException

Description copied from interface: org.apache.xerces.xni.parser.XMLParserConfiguration

Sets the value of a property. This method is called by the parser and gets propagated to components in this parser configuration.

Specified by:

setProperty in interface org.apache.xerces.xni.parser.XMLParserConfiguration

Overrides:

setProperty in class BasicParserConfiguration

Following copied from interface: org.apache.xerces.xni.parser.XMLParserConfiguration

Parameters:

propertyId - The property identifier.

value - The value of the property.

Throws:

org.apache.xerces.xni.parser.XMLConfigurationException - Thrown if there is a configuration error.

setLocale

public void setLocale(java.util.Locale locale)
               throws org.apache.xerces.xni.XNIException

Set the locale to use for messages.

Specified by:

setLocale in interface org.apache.xerces.xni.parser.XMLParserConfiguration

Overrides:

setLocale in class BasicParserConfiguration

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.

getFeature

public boolean getFeature(java.lang.String featureId)
                   throws org.apache.xerces.xni.parser.XMLConfigurationException

Description copied from interface: org.apache.xerces.xni.parser.XMLParserConfiguration

Returns the state of a feature.

Specified by:

getFeature in interface org.apache.xerces.xni.parser.XMLParserConfiguration

Overrides:

getFeature in class ParserConfigurationSettings

Following copied from interface: org.apache.xerces.xni.parser.XMLParserConfiguration

Parameters:

featureId - The feature identifier.

Throws:

org.apache.xerces.xni.parser.XMLConfigurationException - Thrown if there is a configuration error.

setInputSource

public void setInputSource(org.apache.xerces.xni.parser.XMLInputSource inputSource)
                    throws org.apache.xerces.xni.parser.XMLConfigurationException,
                           java.io.IOException

Sets the input source for the document to parse.

Specified by:

setInputSource in interface org.apache.xerces.xni.parser.XMLPullParserConfiguration

Parameters:

inputSource - The document's input source.

Throws:

org.apache.xerces.xni.parser.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 org.apache.xerces.xni.XNIException,
                     java.io.IOException

Parses the document in a pull parsing fashion.

Specified by:

parse in interface org.apache.xerces.xni.parser.XMLPullParserConfiguration

Parameters:

complete - True if the pull parser should parse the remaining document completely.

Returns:

True if there is more document to parse.

Throws:

org.apache.xerces.xni.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 org.apache.xerces.xni.parser.XMLPullParserConfiguration

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.

Specified by:

parse in interface org.apache.xerces.xni.parser.XMLParserConfiguration

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.

createDatatypeValidatorFactory

protected DTDDVFactory createDatatypeValidatorFactory()

Create a datatype validator factory.

createValidationManager

protected ValidationManager createValidationManager()