Xerces implementation of DOMConfiguration that maintains a table of recognized parameters.
author: Elena Litani, IBM author: Neeraj Bajaj, Sun Microsystems. version: $Id: DOMConfigurationImpl.java 530107 2007-04-18 17:59:54Z mrglavas $
canSetParameter(String name, Object value) DOM Level 3 WD - Experimental.
Check if setting a parameter to a specific value is supported.
Parameters: name - The name of the parameter to check. Parameters: value - An object.
getParameterNames() DOM Level 3 CR - Experimental.
The list of the parameters supported by this
DOMConfiguration object and for which at least one value
can be set by the application.
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.
setDocumentHandler(XMLDocumentHandler documentHandler) Sets the document handler on the last component in the pipeline
to receive information about the document.
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.
public void
setFeature(String featureId, boolean state) Set the state of a feature.
Set the state of any feature in a SAX2 parser.
public void
setLocale(Locale locale) Set the locale to use for messages.
Constructs a parser configuration using the specified symbol table
and parent settings.
Parameters: symbolTable - The symbol table to use. Parameters: parentSettings - The parent settings.
DOM Level 3 WD - Experimental.
Check if setting a parameter to a specific value is supported.
Parameters: name - The name of the parameter to check. Parameters: value - An object. if null, the returned value is true. true if the parameter could be successfully set to thespecified value, or false if the parameter is not recognized orthe requested value is not supported. This does not change thecurrent value of the parameter itself.
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 propertybeing set. exception: org.apache.xerces.xni.parser.XMLConfigurationException - If therequested feature is not known or supported.
Returns the state of a feature.
Parameters: featureId - The feature identifier. true if the feature is supported throws: XMLConfigurationException - Thrown for configuration error.In general, components shouldonly throw this exception ifit is reallya critical error.
DOM Level 3 CR - Experimental.
The list of the parameters supported by this
DOMConfiguration object and for which at least one value
can be set by the application. Note that this list can also contain
parameter names defined outside this specification.
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.
Parameters: inputSource - The input source for the top-level of theXML document. exception: XNIException - Any XNI exception, possibly wrappinganother exception. exception: IOException - An IO exception from the parser, possiblyfrom a byte stream or character streamsupplied by the parser.
Sets the document handler on the last component in the pipeline
to receive information about the document.
Parameters: documentHandler - The document handler.
Sets the resolver used to resolve external entities. The EntityResolver
interface supports resolution of public and system identifiers.
Parameters: resolver - The new entity resolver. Passing a null value willuninstall the currently installed resolver.
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.
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.
Parameters: featureId - The unique identifier (URI) of the feature. Parameters: state - The requested state of the feature (true or false). exception: org.apache.xerces.xni.parser.XMLConfigurationException - If therequested feature is not known.
Set the locale to use for messages.
Parameters: locale - The locale object to use for localization of messages. exception: XNIException - Thrown if the parser does not support thespecified locale.