NonValidatingConfiguration (Red Hat JBoss Enterprise Application Platform 6.4.19.GA public API)

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

All Implemented Interfaces:

XMLComponentManager, XMLParserConfiguration, XMLPullParserConfiguration
```
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$

Author:

Elena Litani, IBM

Field Summary

Fields
Modifier and Type	Field and Description
`protected static String`	`ALLOW_JAVA_ENCODINGS` Feature identifier: allow Java encodings.
`protected static String`	`CONTINUE_AFTER_FATAL_ERROR` Feature identifier: continue after fatal error.
`protected static String`	`DATATYPE_VALIDATOR_FACTORY` Property identifier: datatype validator factory.
`protected static String`	`DOCUMENT_SCANNER` Property identifier document scanner:
`protected static String`	`DTD_SCANNER` Property identifier: DTD scanner.
`protected static String`	`DTD_VALIDATOR` Property identifier: DTD validator.
`protected static String`	`ENTITY_MANAGER` Property identifier: entity manager.
`protected static 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 XMLDTDScanner`	`fDTDScanner` DTD scanner.
`protected XMLEntityManager`	`fEntityManager` Entity manager.
`protected XMLErrorReporter`	`fErrorReporter` Error reporter.
`protected XMLGrammarPool`	`fGrammarPool` Grammar pool.
`protected XMLInputSource`	`fInputSource` Input Source
`protected XMLLocator`	`fLocator` Locator
`protected boolean`	`fParseInProgress` True if a parse is in progress.
`protected XMLDocumentScanner`	`fScanner` Document scanner.
`protected ValidationManager`	`fValidationManager`
`protected static String`	`LOAD_EXTERNAL_DTD` Feature identifier: load external DTD.
`protected static String`	`NAMESPACE_BINDER` Property identifier: namespace binder.
`protected static String`	`NORMALIZE_DATA` Feature identifier: expose schema normalized value
`protected static String`	`NOTIFY_BUILTIN_REFS` Feature identifier: notify built-in refereces.
`protected static String`	`NOTIFY_CHAR_REFS` Feature identifier: notify character refereces.
`protected static String`	`SCHEMA_ELEMENT_DEFAULT` Feature identifier: send element default value via characters()
`protected static String`	`SCHEMA_VALIDATOR` Property identifier: XML Schema validator.
`protected static String`	`VALIDATION_MANAGER`
`protected static String`	`WARN_ON_DUPLICATE_ATTDEF` Feature identifier: warn on duplicate attribute definition.
`protected static String`	`WARN_ON_DUPLICATE_ENTITYDEF` Feature identifier: warn on duplicate entity definition.
`protected static String`	`WARN_ON_UNDECLARED_ELEMDEF` Feature identifier: warn on undeclared element definition.
`protected static 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

Constructors
Constructor and Description
`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

Methods
Modifier and Type	Method and Description
`protected void`	`checkFeature(String featureId)` Check a feature.
`protected void`	`checkProperty(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 XMLDocumentScanner`	`createDocumentScanner()` Create a document scanner.
`protected 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(String featureId)` Returns the state of a feature.
`boolean`	`parse(boolean complete)` Parses the document in a pull parsing fashion.
`void`	`parse(XMLInputSource source)` Parses the specified input source.
`protected void`	`reset()` Reset all components before parsing.
`void`	`setFeature(String featureId, boolean state)` Set the state of a feature.
`void`	`setInputSource(XMLInputSource inputSource)` Sets the input source for the document to parse.
`void`	`setLocale(Locale locale)` Set the locale to use for messages.
`void`	`setProperty(String propertyId, Object value)` setProperty

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 String WARN_ON_DUPLICATE_ATTDEF
```
    Feature identifier: warn on duplicate attribute definition.
    
    See Also:
    Constant Field Values
  - WARN_ON_DUPLICATE_ENTITYDEF
```
protected static final String WARN_ON_DUPLICATE_ENTITYDEF
```
    Feature identifier: warn on duplicate entity definition.
    
    See Also:
    Constant Field Values
  - WARN_ON_UNDECLARED_ELEMDEF
```
protected static final String WARN_ON_UNDECLARED_ELEMDEF
```
    Feature identifier: warn on undeclared element definition.
    
    See Also:
    Constant Field Values
  - ALLOW_JAVA_ENCODINGS
```
protected static final String ALLOW_JAVA_ENCODINGS
```
    Feature identifier: allow Java encodings.
    
    See Also:
    Constant Field Values
  - CONTINUE_AFTER_FATAL_ERROR
```
protected static final String CONTINUE_AFTER_FATAL_ERROR
```
    Feature identifier: continue after fatal error.
    
    See Also:
    Constant Field Values
  - LOAD_EXTERNAL_DTD
```
protected static final String LOAD_EXTERNAL_DTD
```
    Feature identifier: load external DTD.
    
    See Also:
    Constant Field Values
  - NOTIFY_BUILTIN_REFS
```
protected static final String NOTIFY_BUILTIN_REFS
```
    Feature identifier: notify built-in refereces.
    
    See Also:
    Constant Field Values
  - NOTIFY_CHAR_REFS
```
protected static final String NOTIFY_CHAR_REFS
```
    Feature identifier: notify character refereces.
    
    See Also:
    Constant Field Values
  - NORMALIZE_DATA
```
protected static final String NORMALIZE_DATA
```
    Feature identifier: expose schema normalized value
    
    See Also:
    Constant Field Values
  - SCHEMA_ELEMENT_DEFAULT
```
protected static final String SCHEMA_ELEMENT_DEFAULT
```
    Feature identifier: send element default value via characters()
    
    See Also:
    Constant Field Values
  - ERROR_REPORTER
```
protected static final String ERROR_REPORTER
```
    Property identifier: error reporter.
    
    See Also:
    Constant Field Values
  - ENTITY_MANAGER
```
protected static final String ENTITY_MANAGER
```
    Property identifier: entity manager.
    
    See Also:
    Constant Field Values
  - DOCUMENT_SCANNER
```
protected static final String DOCUMENT_SCANNER
```
    Property identifier document scanner:
    
    See Also:
    Constant Field Values
  - DTD_SCANNER
```
protected static final String DTD_SCANNER
```
    Property identifier: DTD scanner.
    
    See Also:
    Constant Field Values
  - XMLGRAMMAR_POOL
```
protected static final String XMLGRAMMAR_POOL
```
    Property identifier: grammar pool.
    
    See Also:
    Constant Field Values
  - DTD_VALIDATOR
```
protected static final String DTD_VALIDATOR
```
    Property identifier: DTD validator.
    
    See Also:
    Constant Field Values
  - NAMESPACE_BINDER
```
protected static final String NAMESPACE_BINDER
```
    Property identifier: namespace binder.
    
    See Also:
    Constant Field Values
  - DATATYPE_VALIDATOR_FACTORY
```
protected static final String DATATYPE_VALIDATOR_FACTORY
```
    Property identifier: datatype validator factory.
    
    See Also:
    Constant Field Values
  - VALIDATION_MANAGER
```
protected static final String VALIDATION_MANAGER
```
    See Also:
    Constant Field Values
  - SCHEMA_VALIDATOR
```
protected static final String SCHEMA_VALIDATOR
```
    Property identifier: XML Schema validator.
    
    See Also:
    Constant Field Values
  - fGrammarPool
```
protected 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 XMLDocumentScanner fScanner
```
    Document scanner.
  - fInputSource
```
protected XMLInputSource fInputSource
```
    Input Source
  - fDTDScanner
```
protected 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 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,
                          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
  - setFeature
```
public void setFeature(String featureId,
              boolean state)
                throws XMLConfigurationException
```
    Description copied from class: BasicParserConfiguration
    
    Set the state of a feature. Set the state of any feature in a SAX2 parser. The parser might not recognize the feature, and if it does recognize it, it might not be able to fulfill the request.
    
    Specified by:
    
    setFeature in interface XMLParserConfiguration
    
    Overrides:
    
    setFeature in class BasicParserConfiguration
    
    Parameters:
    featureId - The unique identifier (URI) of the feature.
    state - The requested state of the feature (true or false).
    
    Throws:
    
    XMLConfigurationException - Thrown if there is a configuration error.
  - setProperty
```
public void setProperty(String propertyId,
               Object value)
                 throws XMLConfigurationException
```
    Description copied from class: BasicParserConfiguration
    
    setProperty
    
    Specified by:
    
    setProperty in interface XMLParserConfiguration
    
    Overrides:
    
    setProperty in class BasicParserConfiguration
    
    Parameters:
    propertyId - The property identifier.
    value - The value of the property.
    
    Throws:
    
    XMLConfigurationException - Thrown if there is a configuration error.
  - setLocale
```
public void setLocale(Locale locale)
               throws XNIException
```
    Set the locale to use for messages.
    
    Specified by:
    
    setLocale in interface XMLParserConfiguration
    
    Overrides:
    
    setLocale in class BasicParserConfiguration
    
    Parameters:
    locale - The locale object to use for localization of messages.
    
    Throws:
    
    XNIException - Thrown if the parser does not support the specified locale.
  - getFeature
```
public boolean getFeature(String featureId)
                   throws XMLConfigurationException
```
    Description copied from class: ParserConfigurationSettings
    
    Returns the state of a feature.
    
    Specified by:
    
    getFeature in interface XMLComponentManager
    
    Specified by:
    
    getFeature in interface XMLParserConfiguration
    
    Overrides:
    
    getFeature in class ParserConfigurationSettings
    
    Parameters:
    featureId - The feature identifier.
    
    Returns:
    true if the feature is supported
    
    Throws:
    
    XMLConfigurationException - Thrown for configuration error. In general, components should only throw this exception if it is really a critical error.
  - setInputSource
```
public void setInputSource(XMLInputSource inputSource)
                    throws XMLConfigurationException,
                           IOException
```
    Sets the input source for the document to parse.
    
    Specified by:
    
    setInputSource in interface XMLPullParserConfiguration
    
    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:
    parse(boolean)
  - parse
```
public boolean parse(boolean complete)
              throws XNIException,
                     IOException
```
    Parses the document in a pull parsing fashion.
    
    Specified by:
    
    parse in interface XMLPullParserConfiguration
    
    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:
    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 XMLPullParserConfiguration
  - parse
```
public void parse(XMLInputSource source)
           throws XNIException,
                  IOException
```
    Parses the specified input source.
    
    Specified by:
    
    parse in interface XMLParserConfiguration
    
    Specified by:
    
    parse in class BasicParserConfiguration
    
    Parameters:
    source - The input source.
    
    Throws:
    
    XNIException - Throws exception on XNI error.
    
    IOException - Throws exception on i/o error.
  - reset
```
protected void reset()
              throws XNIException
```
    Reset all components before parsing.
    
    Overrides:
    
    reset in class BasicParserConfiguration
    
    Throws:
    
    XNIException - Thrown if an error occurs during initialization.
  - configurePipeline
```
protected void configurePipeline()
```
    Configures the pipeline.
  - checkFeature
```
protected void checkFeature(String featureId)
                     throws 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:
    
    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)
                      throws 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:
    
    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 XMLDocumentScanner createDocumentScanner()
```
    Create a document scanner.
  - createDTDScanner
```
protected XMLDTDScanner createDTDScanner()
```
    Create a DTD scanner.
  - createDatatypeValidatorFactory
```
protected DTDDVFactory createDatatypeValidatorFactory()
```
    Create a datatype validator factory.
  - createValidationManager
```
protected ValidationManager createValidationManager()
```

Class NonValidatingConfiguration

Field Summary

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

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

Constructor Summary

Method Summary

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

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

Methods inherited from class java.lang.Object

Methods inherited from interface org.apache.xerces.xni.parser.XMLParserConfiguration

Field Detail

WARN_ON_DUPLICATE_ATTDEF

WARN_ON_DUPLICATE_ENTITYDEF

WARN_ON_UNDECLARED_ELEMDEF

ALLOW_JAVA_ENCODINGS

CONTINUE_AFTER_FATAL_ERROR

LOAD_EXTERNAL_DTD

NOTIFY_BUILTIN_REFS

NOTIFY_CHAR_REFS

NORMALIZE_DATA

SCHEMA_ELEMENT_DEFAULT

ERROR_REPORTER

ENTITY_MANAGER

DOCUMENT_SCANNER

DTD_SCANNER

XMLGRAMMAR_POOL

DTD_VALIDATOR

NAMESPACE_BINDER

DATATYPE_VALIDATOR_FACTORY

VALIDATION_MANAGER

SCHEMA_VALIDATOR

fGrammarPool

fDatatypeValidatorFactory

fErrorReporter

fEntityManager

fScanner

fInputSource

fDTDScanner

fValidationManager

fConfigUpdated

fLocator

fParseInProgress

Constructor Detail

NonValidatingConfiguration

NonValidatingConfiguration

NonValidatingConfiguration

NonValidatingConfiguration

Method Detail

setFeature

setProperty

setLocale

getFeature

setInputSource

parse

cleanup

parse

reset

configurePipeline

checkFeature

checkProperty

createEntityManager

createErrorReporter

createDocumentScanner

createDTDScanner

createDatatypeValidatorFactory

createValidationManager