org.apache.xerces.parsers
Class StandardParserConfiguration

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

All Implemented Interfaces:

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

Direct Known Subclasses:

IntegratedParserConfiguration

public class StandardParserConfiguration

extends DTDConfiguration

This is the "standard" parser configuration. It extends the DTD configuration with the standard set of parser components. The standard set of parser components include those needed to parse and validate with DTD's, and those needed for XML Schema.

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

• Features
  • http://apache.org/xml/features/validation/schema
  • http://apache.org/xml/features/validation/schema-full-checking
  • http://apache.org/xml/features/validation/schema/normalized-value
  • http://apache.org/xml/features/validation/schema/element-default
• Properties
  • http://apache.org/xml/properties/internal/error-reporter
  • http://apache.org/xml/properties/internal/entity-manager
  • http://apache.org/xml/properties/internal/document-scanner
  • http://apache.org/xml/properties/internal/dtd-scanner
  • http://apache.org/xml/properties/internal/grammar-pool
  • http://apache.org/xml/properties/internal/validator/dtd
  • http://apache.org/xml/properties/internal/datatype-validator-factory

Version:

$Id: StandardParserConfiguration.java 805582 2009-08-18 21:13:20Z sandygao $

Author:

Arnaud Le Hors, IBM, Andy Clark, IBM

Field Summary

protected XMLSchemaValidator	fSchemaValidator XML Schema Validator.
protected static java.lang.String	GENERATE_SYNTHETIC_ANNOTATIONS Feature: generate synthetic annotations
protected static java.lang.String	HONOUR_ALL_SCHEMALOCATIONS Feature identifier: honour all schemaLocations
protected static java.lang.String	ID_IDREF_CHECKING Feature identifier: whether to ignore ID/IDREF errors
protected static java.lang.String	IDENTITY_CONSTRAINT_CHECKING Feature identifier: whether to ignore identity constraint errors
protected static java.lang.String	IGNORE_XSI_TYPE Feature identifier: whether to ignore xsi:type attributes until a global element declaration is encountered
protected static java.lang.String	NAMESPACE_GROWTH Feature identifier: namespace growth
protected static java.lang.String	NORMALIZE_DATA Feature identifier: expose schema normalized value
protected static java.lang.String	ROOT_ELEMENT_DECL Property identifier: root element declaration.
protected static java.lang.String	ROOT_TYPE_DEF Property identifier: root type definition.
protected static java.lang.String	SCHEMA_AUGMENT_PSVI Feature identifier: augment PSVI
protected static java.lang.String	SCHEMA_DV_FACTORY Property identifier: Schema DV Factory
protected static java.lang.String	SCHEMA_ELEMENT_DEFAULT Feature identifier: send element default value via characters()
protected static java.lang.String	SCHEMA_LOCATION Property identifier: schema location.
protected static java.lang.String	SCHEMA_NONS_LOCATION Property identifier: no namespace schema location.
protected static java.lang.String	SCHEMA_VALIDATOR Property identifier: XML Schema validator.
protected static java.lang.String	TOLERATE_DUPLICATES Feature identifier: tolerate duplicates
protected static java.lang.String	UNPARSED_ENTITY_CHECKING Feature identifier: whether to ignore unparsed entity errors
protected static java.lang.String	VALIDATE_ANNOTATIONS Feature identifier: validate annotations
protected static java.lang.String	XMLSCHEMA_FULL_CHECKING feature identifier: XML Schema validation -- full checking
protected static java.lang.String	XMLSCHEMA_VALIDATION feature identifier: XML Schema validation

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

ALLOW_JAVA_ENCODINGS, CONTINUE_AFTER_FATAL_ERROR, DATATYPE_VALIDATOR_FACTORY, DOCUMENT_SCANNER, DTD_PROCESSOR, DTD_SCANNER, DTD_VALIDATOR, ENTITY_MANAGER, ERROR_REPORTER, fDatatypeValidatorFactory, fDTDProcessor, fDTDScanner, fDTDValidator, fEntityManager, fErrorReporter, fGrammarPool, fInputSource, fLocator, fNamespaceBinder, fParseInProgress, fScanner, fValidationManager, JAXP_SCHEMA_LANGUAGE, JAXP_SCHEMA_SOURCE, LOAD_EXTERNAL_DTD, LOCALE, NAMESPACE_BINDER, NOTIFY_BUILTIN_REFS, NOTIFY_CHAR_REFS, PRINT_EXCEPTION_STACK_TRACE, VALIDATION_MANAGER, WARN_ON_DUPLICATE_ATTDEF, WARN_ON_DUPLICATE_ENTITYDEF, WARN_ON_UNDECLARED_ELEMDEF, XMLGRAMMAR_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

StandardParserConfiguration()
Default constructor.

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

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

StandardParserConfiguration(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.
protected void	configurePipeline() Configures the pipeline.

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

cleanup, configureDTDPipeline, createDatatypeValidatorFactory, createDocumentScanner, createDTDProcessor, createDTDScanner, createDTDValidator, createEntityManager, createErrorReporter, createNamespaceBinder, createValidationManager, getProperty, parse, parse, reset, setInputSource, setLocale, setProperty

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

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

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

addRecognizedFeatures, addRecognizedProperties, getFeature

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, getFeature, getLocale, setDocumentHandler, setDTDContentModelHandler, setDTDHandler, setEntityResolver, setErrorHandler, setFeature

Field Detail

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()

SCHEMA_AUGMENT_PSVI

protected static final java.lang.String SCHEMA_AUGMENT_PSVI

Feature identifier: augment PSVI

XMLSCHEMA_VALIDATION

protected static final java.lang.String XMLSCHEMA_VALIDATION

feature identifier: XML Schema validation

XMLSCHEMA_FULL_CHECKING

protected static final java.lang.String XMLSCHEMA_FULL_CHECKING

feature identifier: XML Schema validation -- full checking

GENERATE_SYNTHETIC_ANNOTATIONS

protected static final java.lang.String GENERATE_SYNTHETIC_ANNOTATIONS

Feature: generate synthetic annotations

VALIDATE_ANNOTATIONS

protected static final java.lang.String VALIDATE_ANNOTATIONS

Feature identifier: validate annotations

HONOUR_ALL_SCHEMALOCATIONS

protected static final java.lang.String HONOUR_ALL_SCHEMALOCATIONS

Feature identifier: honour all schemaLocations

NAMESPACE_GROWTH

protected static final java.lang.String NAMESPACE_GROWTH

Feature identifier: namespace growth

TOLERATE_DUPLICATES

protected static final java.lang.String TOLERATE_DUPLICATES

Feature identifier: tolerate duplicates

IGNORE_XSI_TYPE

protected static final java.lang.String IGNORE_XSI_TYPE

Feature identifier: whether to ignore xsi:type attributes until a global element declaration is encountered

ID_IDREF_CHECKING

protected static final java.lang.String ID_IDREF_CHECKING

Feature identifier: whether to ignore ID/IDREF errors

UNPARSED_ENTITY_CHECKING

protected static final java.lang.String UNPARSED_ENTITY_CHECKING

Feature identifier: whether to ignore unparsed entity errors

IDENTITY_CONSTRAINT_CHECKING

protected static final java.lang.String IDENTITY_CONSTRAINT_CHECKING

Feature identifier: whether to ignore identity constraint errors

SCHEMA_VALIDATOR

protected static final java.lang.String SCHEMA_VALIDATOR

Property identifier: XML Schema validator.

SCHEMA_LOCATION

protected static final java.lang.String SCHEMA_LOCATION

Property identifier: schema location.

SCHEMA_NONS_LOCATION

protected static final java.lang.String SCHEMA_NONS_LOCATION

Property identifier: no namespace schema location.

ROOT_TYPE_DEF

protected static final java.lang.String ROOT_TYPE_DEF

Property identifier: root type definition.

ROOT_ELEMENT_DECL

protected static final java.lang.String ROOT_ELEMENT_DECL

Property identifier: root element declaration.

SCHEMA_DV_FACTORY

protected static final java.lang.String SCHEMA_DV_FACTORY

Property identifier: Schema DV Factory

fSchemaValidator

protected XMLSchemaValidator fSchemaValidator

XML Schema Validator.

Constructor Detail

StandardParserConfiguration

public StandardParserConfiguration()

Default constructor.

StandardParserConfiguration

public StandardParserConfiguration(SymbolTable symbolTable)

Constructs a parser configuration using the specified symbol table.

Parameters:

symbolTable - The symbol table to use.

StandardParserConfiguration

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

StandardParserConfiguration

public StandardParserConfiguration(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

configurePipeline

protected void configurePipeline()

Configures the pipeline.

Overrides:

configurePipeline in class DTDConfiguration

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 DTDConfiguration

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 DTDConfiguration

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.