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,v 1.38 2005/02/09 15:34:02 ankitp Exp $

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	NORMALIZE_DATA Feature identifier: expose schema normalized value
protected static java.lang.String	SCHEMA_AUGMENT_PSVI Feature identifier: augment PSVI
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	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, 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, parse, parse, reset, setInputSource, setLocale

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

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

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

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

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

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.

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.