WebLogic Server 8.1 API Reference

weblogic.apache.xerces.dom
Class DOMValidationConfiguration

java.lang.Object
  |
  +--weblogic.apache.xerces.util.ParserConfigurationSettings
        |
        +--weblogic.apache.xerces.dom.DOMValidationConfiguration

public class DOMValidationConfiguration

extends ParserConfigurationSettings

implements XMLParserConfiguration

This configuration holds information needed for revalidation of the DOM tree, ie. properties and features. Note: This configuration is different from any parser configuration and must not be used other than for DOM revalidation.

Field Summary

protected static java.lang.String	DYNAMIC_VALIDATION
protected static java.lang.String	ENTITY_MANAGER Property identifier: entity manager.
protected static java.lang.String	ENTITY_RESOLVER Property identifier: entity resolver.
protected static java.lang.String	ERROR_HANDLER Property identifier: error handler.
protected static java.lang.String	ERROR_REPORTER Property identifier: error reporter.
protected java.util.Vector	fComponents Components.
protected XMLErrorReporter	fErrorReporter
protected java.util.Locale	fLocale Locale.
protected SymbolTable	fSymbolTable Symbol table.
protected static java.lang.String	GRAMMAR_POOL Property id: Grammar pool
protected static java.lang.String	NAMESPACES Feature identifier: namespaces.
protected static java.lang.String	NORMALIZE_DATA
protected static java.lang.String	SCHEMA
protected static java.lang.String	SYMBOL_TABLE Property identifier: symbol table.
protected static java.lang.String	VALIDATION Feature identifier: validation.
protected static java.lang.String	VALIDATION_MANAGER
protected static java.lang.String	XML_STRING Property identifier: xml string.

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

fFeatures, fParentSettings, fProperties, fRecognizedFeatures, fRecognizedProperties

Constructor Summary

protected	DOMValidationConfiguration() Default Constructor.
protected	DOMValidationConfiguration(SymbolTable symbolTable) Constructs a parser configuration using the specified symbol table.
protected	DOMValidationConfiguration(SymbolTable symbolTable, XMLComponentManager parentSettings) Constructs a parser configuration using the specified symbol table and parent settings.

Method Summary

protected void	addComponent(XMLComponent component)
protected void	checkProperty(java.lang.String propertyId) Check a property.
XMLDocumentHandler	getDocumentHandler() Returns the registered document handler.
XMLDTDContentModelHandler	getDTDContentModelHandler() Returns the registered DTD content model handler.
XMLDTDHandler	getDTDHandler() Returns the registered DTD handler.
XMLEntityResolver	getEntityResolver() Return the current entity resolver.
XMLErrorHandler	getErrorHandler() Return the current error handler.
java.util.Locale	getLocale() Returns the locale.
void	parse(XMLInputSource inputSource) Parse an XML document.
protected void	reset() reset all components before parsing
void	setDocumentHandler(XMLDocumentHandler documentHandler) Sets the document handler on the last component in the pipeline to receive information about the document.
void	setDTDContentModelHandler(XMLDTDContentModelHandler handler) Sets the DTD content model handler.
void	setDTDHandler(XMLDTDHandler dtdHandler) Sets the DTD handler.
void	setEntityResolver(XMLEntityResolver resolver) Sets the resolver used to resolve external entities.
void	setErrorHandler(XMLErrorHandler errorHandler) Allow an application to register an error event handler.
void	setFeature(java.lang.String featureId, boolean state) Set the state of a feature.
void	setLocale(java.util.Locale locale) Set the locale to use for messages.
void	setProperty(java.lang.String propertyId, java.lang.Object value) setProperty

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

addRecognizedFeatures, addRecognizedProperties, checkFeature, getFeature, getProperty

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Field Detail

VALIDATION

protected static final java.lang.String VALIDATION

Feature identifier: validation.

NAMESPACES

protected static final java.lang.String NAMESPACES

Feature identifier: namespaces.

SCHEMA

protected static final java.lang.String SCHEMA

DYNAMIC_VALIDATION

protected static final java.lang.String DYNAMIC_VALIDATION

NORMALIZE_DATA

protected static final java.lang.String NORMALIZE_DATA

ENTITY_MANAGER

protected static final java.lang.String ENTITY_MANAGER

Property identifier: entity manager.

ERROR_REPORTER

protected static final java.lang.String ERROR_REPORTER

Property identifier: error reporter.

XML_STRING

protected static final java.lang.String XML_STRING

Property identifier: xml string.

SYMBOL_TABLE

protected static final java.lang.String SYMBOL_TABLE

Property identifier: symbol table.

GRAMMAR_POOL

protected static final java.lang.String GRAMMAR_POOL

Property id: Grammar pool

ERROR_HANDLER

protected static final java.lang.String ERROR_HANDLER

Property identifier: error handler.

ENTITY_RESOLVER

protected static final java.lang.String ENTITY_RESOLVER

Property identifier: entity resolver.

VALIDATION_MANAGER

protected static final java.lang.String VALIDATION_MANAGER

fSymbolTable

protected SymbolTable fSymbolTable

Symbol table.

fComponents

protected java.util.Vector fComponents

Components.

fLocale

protected java.util.Locale fLocale

Locale.

fErrorReporter

protected XMLErrorReporter fErrorReporter

Constructor Detail

DOMValidationConfiguration

protected DOMValidationConfiguration()

Default Constructor.

DOMValidationConfiguration

protected DOMValidationConfiguration(SymbolTable symbolTable)

Constructs a parser configuration using the specified symbol table.

Parameters:

symbolTable - The symbol table to use.

DOMValidationConfiguration

protected DOMValidationConfiguration(SymbolTable symbolTable,
                                     XMLComponentManager parentSettings)

Constructs a parser configuration using the specified symbol table and parent settings.

Parameters:

symbolTable - The symbol table to use.

parentSettings - The parent settings.

Method Detail

parse

public void parse(XMLInputSource inputSource)
           throws XNIException,
                  java.io.IOException

Parse an XML document.

The parser can use this method to instruct this configuration to begin parsing an XML document from any valid input source (a character stream, a byte stream, or a URI).

Parsers may not invoke this method while a parse is in progress. Once a parse is complete, the parser may then parse another XML document.

This method is synchronous: it will not return until parsing has ended. If a client application wants to terminate parsing early, it should throw an exception.

Specified by:

parse in interface XMLParserConfiguration

Parameters:

source - The input source for the top-level of the XML document.

Throws:

XNIException - Any XNI exception, possibly wrapping another exception.

java.io.IOException - An IO exception from the parser, possibly from a byte stream or character stream supplied by the parser.

setDocumentHandler

public void setDocumentHandler(XMLDocumentHandler documentHandler)

Sets the document handler on the last component in the pipeline to receive information about the document.

Specified by:

setDocumentHandler in interface XMLParserConfiguration

Parameters:

documentHandler - The document handler.

getDocumentHandler

public XMLDocumentHandler getDocumentHandler()

Returns the registered document handler.

Specified by:

getDocumentHandler in interface XMLParserConfiguration

setDTDHandler

public void setDTDHandler(XMLDTDHandler dtdHandler)

Sets the DTD handler.

Specified by:

setDTDHandler in interface XMLParserConfiguration

Parameters:

dtdHandler - The DTD handler.

getDTDHandler

public XMLDTDHandler getDTDHandler()

Returns the registered DTD handler.

Specified by:

getDTDHandler in interface XMLParserConfiguration

setDTDContentModelHandler

public void setDTDContentModelHandler(XMLDTDContentModelHandler handler)

Sets the DTD content model handler.

Specified by:

setDTDContentModelHandler in interface XMLParserConfiguration

Parameters:

handler - The DTD content model handler.

getDTDContentModelHandler

public XMLDTDContentModelHandler getDTDContentModelHandler()

Returns the registered DTD content model handler.

Specified by:

getDTDContentModelHandler in interface XMLParserConfiguration

setEntityResolver

public void setEntityResolver(XMLEntityResolver resolver)

Sets the resolver used to resolve external entities. The EntityResolver interface supports resolution of public and system identifiers.

Specified by:

setEntityResolver in interface XMLParserConfiguration

Parameters:

resolver - The new entity resolver. Passing a null value will uninstall the currently installed resolver.

getEntityResolver

public XMLEntityResolver getEntityResolver()

Return the current entity resolver.

Specified by:

getEntityResolver in interface XMLParserConfiguration

Returns:

The current entity resolver, or null if none has been registered.

See Also:

setEntityResolver(weblogic.apache.xerces.xni.parser.XMLEntityResolver)

setErrorHandler

public void setErrorHandler(XMLErrorHandler errorHandler)

Allow an application to register an error event handler.

If the application does not register an error handler, all error events reported by the SAX parser will be silently ignored; however, normal processing may not continue. It is highly recommended that all SAX applications implement an error handler to avoid unexpected bugs.

Applications may register a new or different handler in the middle of a parse, and the SAX parser must begin using the new handler immediately.

Specified by:

setErrorHandler in interface XMLParserConfiguration

Parameters:

errorHandler - The error handler.

Throws:

java.lang.NullPointerException - If the handler argument is null.

See Also:

getErrorHandler()

getErrorHandler

public XMLErrorHandler getErrorHandler()

Return the current error handler.

Specified by:

getErrorHandler in interface XMLParserConfiguration

Returns:

The current error handler, or null if none has been registered.

See Also:

setErrorHandler(weblogic.apache.xerces.xni.parser.XMLErrorHandler)

setFeature

public void setFeature(java.lang.String featureId,
                       boolean state)
                throws XMLConfigurationException

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

Parameters:

featureId - The unique identifier (URI) of the feature.

state - The requested state of the feature (true or false).

Throws:

XMLConfigurationException - If the requested feature is not known.

Overrides:

setFeature in class ParserConfigurationSettings

setProperty

public void setProperty(java.lang.String propertyId,
                        java.lang.Object value)
                 throws XMLConfigurationException

setProperty

Specified by:

setProperty in interface XMLParserConfiguration

Parameters:

propertyId -

value -

Overrides:

setProperty in class ParserConfigurationSettings

setLocale

public void setLocale(java.util.Locale locale)
               throws XNIException

Set the locale to use for messages.

Specified by:

setLocale in interface XMLParserConfiguration

Parameters:

locale - The locale object to use for localization of messages.

Throws:

XNIException - Thrown if the parser does not support the specified locale.

getLocale

public java.util.Locale getLocale()

Returns the locale.

Specified by:

getLocale in interface XMLParserConfiguration

reset

protected void reset()
              throws XNIException

reset all components before parsing

checkProperty

protected void checkProperty(java.lang.String propertyId)
                      throws XMLConfigurationException

Check a property. If the property is known 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 - If the requested feature is not known or supported.

Overrides:

checkProperty in class ParserConfigurationSettings

addComponent

protected void addComponent(XMLComponent component)