org.apache.xerces.parsers

Class NonValidatingConfiguration

public class NonValidatingConfiguration extends BasicParserConfiguration implements 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 StringALLOW_JAVA_ENCODINGS
Feature identifier: allow Java encodings.
protected static StringCONTINUE_AFTER_FATAL_ERROR
Feature identifier: continue after fatal error.
protected static StringDATATYPE_VALIDATOR_FACTORY
Property identifier: datatype validator factory.
protected static StringDOCUMENT_SCANNER
Property identifier document scanner:
protected static StringDTD_SCANNER
Property identifier: DTD scanner.
protected static StringDTD_VALIDATOR
Property identifier: DTD validator.
protected static StringENTITY_MANAGER
Property identifier: entity manager.
protected static StringERROR_REPORTER
Property identifier: error reporter.
protected booleanfConfigUpdated
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 DTDDVFactoryfDatatypeValidatorFactory
Datatype validator factory.
protected XMLDTDScannerfDTDScanner
DTD scanner.
protected XMLEntityManagerfEntityManager
Entity manager.
protected XMLErrorReporterfErrorReporter
Error reporter.
protected XMLGrammarPoolfGrammarPool
Grammar pool.
protected XMLInputSourcefInputSource
Input Source
protected XMLLocatorfLocator
Locator
protected booleanfParseInProgress
True if a parse is in progress.
protected XMLDocumentScannerfScanner
Document scanner.
protected ValidationManagerfValidationManager
protected static StringLOAD_EXTERNAL_DTD
Feature identifier: load external DTD.
protected static StringNAMESPACE_BINDER
Property identifier: namespace binder.
protected static StringNORMALIZE_DATA
Feature identifier: expose schema normalized value
protected static StringNOTIFY_BUILTIN_REFS
Feature identifier: notify built-in refereces.
protected static StringNOTIFY_CHAR_REFS
Feature identifier: notify character refereces.
protected static StringSCHEMA_ELEMENT_DEFAULT
Feature identifier: send element default value via characters()
protected static StringSCHEMA_VALIDATOR
Property identifier: XML Schema validator.
protected static StringVALIDATION_MANAGER
protected static StringWARN_ON_DUPLICATE_ATTDEF
Feature identifier: warn on duplicate attribute definition.
protected static StringWARN_ON_DUPLICATE_ENTITYDEF
Feature identifier: warn on duplicate entity definition.
protected static StringWARN_ON_UNDECLARED_ELEMDEF
Feature identifier: warn on undeclared element definition.
protected static StringXMLGRAMMAR_POOL
Property identifier: grammar pool.
Constructor Summary
NonValidatingConfiguration()
Default constructor.
NonValidatingConfiguration(SymbolTable symbolTable)
Constructs a parser configuration using the specified symbol table.
NonValidatingConfiguration(SymbolTable symbolTable, XMLGrammarPool grammarPool)
Constructs a parser configuration using the specified symbol table and grammar pool.
NonValidatingConfiguration(SymbolTable symbolTable, XMLGrammarPool grammarPool, XMLComponentManager parentSettings)
Constructs a parser configuration using the specified symbol table, grammar pool, and parent settings.
Method Summary
protected voidcheckFeature(String featureId)
Check a feature.
protected voidcheckProperty(String propertyId)
Check a property.
voidcleanup()
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 voidconfigurePipeline()
Configures the pipeline.
protected DTDDVFactorycreateDatatypeValidatorFactory()
Create a datatype validator factory.
protected XMLDocumentScannercreateDocumentScanner()
Create a document scanner.
protected XMLDTDScannercreateDTDScanner()
Create a DTD scanner.
protected XMLEntityManagercreateEntityManager()
Creates an entity manager.
protected XMLErrorReportercreateErrorReporter()
Creates an error reporter.
protected ValidationManagercreateValidationManager()
booleangetFeature(String featureId)
booleanparse(boolean complete)
Parses the document in a pull parsing fashion.
voidparse(XMLInputSource source)
Parses the specified input source.
protected voidreset()
Reset all components before parsing.
voidsetFeature(String featureId, boolean state)
voidsetInputSource(XMLInputSource inputSource)
Sets the input source for the document to parse.
voidsetLocale(Locale locale)
Set the locale to use for messages.
voidsetProperty(String propertyId, Object value)

Field Detail

ALLOW_JAVA_ENCODINGS

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

CONTINUE_AFTER_FATAL_ERROR

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

DATATYPE_VALIDATOR_FACTORY

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

DOCUMENT_SCANNER

protected static final String DOCUMENT_SCANNER
Property identifier document scanner:

DTD_SCANNER

protected static final String DTD_SCANNER
Property identifier: DTD scanner.

DTD_VALIDATOR

protected static final String DTD_VALIDATOR
Property identifier: DTD validator.

ENTITY_MANAGER

protected static final String ENTITY_MANAGER
Property identifier: entity manager.

ERROR_REPORTER

protected static final String ERROR_REPORTER
Property identifier: error reporter.

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.

fDatatypeValidatorFactory

protected DTDDVFactory fDatatypeValidatorFactory
Datatype validator factory.

fDTDScanner

protected XMLDTDScanner fDTDScanner
DTD scanner.

fEntityManager

protected XMLEntityManager fEntityManager
Entity manager.

fErrorReporter

protected XMLErrorReporter fErrorReporter
Error reporter.

fGrammarPool

protected XMLGrammarPool fGrammarPool
Grammar pool.

fInputSource

protected XMLInputSource fInputSource
Input Source

fLocator

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

fScanner

protected XMLDocumentScanner fScanner
Document scanner.

fValidationManager

protected ValidationManager fValidationManager

LOAD_EXTERNAL_DTD

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

NAMESPACE_BINDER

protected static final String NAMESPACE_BINDER
Property identifier: namespace binder.

NORMALIZE_DATA

protected static final String NORMALIZE_DATA
Feature identifier: expose schema normalized value

NOTIFY_BUILTIN_REFS

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

NOTIFY_CHAR_REFS

protected static final String NOTIFY_CHAR_REFS
Feature identifier: notify character refereces.

SCHEMA_ELEMENT_DEFAULT

protected static final String SCHEMA_ELEMENT_DEFAULT
Feature identifier: send element default value via characters()

SCHEMA_VALIDATOR

protected static final String SCHEMA_VALIDATOR
Property identifier: XML Schema validator.

VALIDATION_MANAGER

protected static final String VALIDATION_MANAGER

WARN_ON_DUPLICATE_ATTDEF

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

WARN_ON_DUPLICATE_ENTITYDEF

protected static final String WARN_ON_DUPLICATE_ENTITYDEF
Feature identifier: warn on duplicate entity definition.

WARN_ON_UNDECLARED_ELEMDEF

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

XMLGRAMMAR_POOL

protected static final String XMLGRAMMAR_POOL
Property identifier: grammar pool.

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, 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, 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

checkFeature

protected void checkFeature(String featureId)
Check a feature. If feature is know and supported, this method simply returns. Otherwise, the appropriate exception is thrown.

Parameters: featureId The unique identifier (URI) of the feature.

Throws: XMLConfigurationException Thrown for configuration error. In general, components should only throw this exception if it is really a critical error.

checkProperty

protected void checkProperty(String propertyId)
Check a property. If the property is know and supported, this method simply returns. Otherwise, the appropriate exception is thrown.

Parameters: propertyId The unique identifier (URI) of the property being set.

Throws: XMLConfigurationException Thrown for configuration error. In general, components should only throw this exception if it is really a critical error.

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.

configurePipeline

protected void configurePipeline()
Configures the pipeline.

createDatatypeValidatorFactory

protected DTDDVFactory createDatatypeValidatorFactory()
Create a datatype validator factory.

createDocumentScanner

protected XMLDocumentScanner createDocumentScanner()
Create a document scanner.

createDTDScanner

protected XMLDTDScanner createDTDScanner()
Create a DTD scanner.

createEntityManager

protected XMLEntityManager createEntityManager()
Creates an entity manager.

createErrorReporter

protected XMLErrorReporter createErrorReporter()
Creates an error reporter.

createValidationManager

protected ValidationManager createValidationManager()

getFeature

public boolean getFeature(String featureId)

parse

public boolean parse(boolean complete)
Parses the document in a pull parsing fashion.

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. IOException An IO exception from the parser, possibly from a byte stream or character stream supplied by the parser.

See Also: NonValidatingConfiguration

parse

public void parse(XMLInputSource source)
Parses the specified input source.

Parameters: source The input source.

Throws: XNIException Throws exception on XNI error. java.io.IOException Throws exception on i/o error.

reset

protected void reset()
Reset all components before parsing.

Throws: XNIException Thrown if an error occurs during initialization.

setFeature

public void setFeature(String featureId, boolean state)

setInputSource

public void setInputSource(XMLInputSource inputSource)
Sets the input source for the document to parse.

Parameters: inputSource The document's input source.

Throws: XMLConfigurationException Thrown if there is a configuration error when initializing the parser. IOException Thrown on I/O error.

See Also: NonValidatingConfiguration

setLocale

public void setLocale(Locale locale)
Set the locale to use for messages.

Parameters: locale The locale object to use for localization of messages.

Throws: XNIException Thrown if the parser does not support the specified locale.

setProperty

public void setProperty(String propertyId, Object value)
Copyright B) 1999-2005 Apache XML Project. All Rights Reserved.