org.apache.xerces.impl.xs.opti

Class SchemaParsingConfig

public class SchemaParsingConfig extends BasicParserConfiguration implements XMLPullParserConfiguration

INTERNAL:

Usage of this class is not supported. It may be altered or removed at any time.

Version: $Id: SchemaParsingConfig.java,v 1.9 2004/12/16 16:45:20 ankitp Exp $

Author: Rahul Srivastava, Sun Microsystems Inc.

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 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 SchemaDOMParserfSchemaDOMParser
protected ValidationManagerfValidationManager
protected static StringGENERATE_SYNTHETIC_ANNOTATION
Feature identifier: generate synthetic annotations.
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_UNDECLARED_ELEMDEF
Feature identifier: warn on undeclared element definition.
protected static StringXMLGRAMMAR_POOL
Property identifier: grammar pool.
Constructor Summary
SchemaParsingConfig()
Default constructor.
SchemaParsingConfig(SymbolTable symbolTable)
Constructs a parser configuration using the specified symbol table.
SchemaParsingConfig(SymbolTable symbolTable, XMLGrammarPool grammarPool)
Constructs a parser configuration using the specified symbol table and grammar pool.
SchemaParsingConfig(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.
DocumentgetDocument()
Returns the Document object.
booleanparse(boolean complete)
Parses the document in a pull parsing fashion.
voidparse(XMLInputSource source)
Parses the specified input source.
voidreset()
Reset all components before parsing.
voidresetNodePool()
voidsetInputSource(XMLInputSource inputSource)
Sets the input source for the document to parse.
voidsetLocale(Locale locale)
Set the locale to use for messages.

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.

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.

fSchemaDOMParser

protected SchemaDOMParser fSchemaDOMParser

fValidationManager

protected ValidationManager fValidationManager

GENERATE_SYNTHETIC_ANNOTATION

protected static final String GENERATE_SYNTHETIC_ANNOTATION
Feature identifier: generate synthetic annotations.

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

SchemaParsingConfig

public SchemaParsingConfig()
Default constructor.

SchemaParsingConfig

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

Parameters: symbolTable The symbol table to use.

SchemaParsingConfig

public SchemaParsingConfig(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.

SchemaParsingConfig

public SchemaParsingConfig(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.

getDocument

public Document getDocument()
Returns the Document object.

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: SchemaParsingConfig

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

public void reset()
Reset all components before parsing.

Throws: XNIException Thrown if an error occurs during initialization.

resetNodePool

public void resetNodePool()

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: SchemaParsingConfig

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.

Copyright B) 1999-2005 Apache XML Project. All Rights Reserved.