net.sf.saxon.dom
public class DocumentBuilderFactoryImpl extends DocumentBuilderFactory
Field Summary | |
---|---|
Configuration | config |
boolean | xIncludeAware |
Constructor Summary | |
---|---|
DocumentBuilderFactoryImpl() |
Method Summary | |
---|---|
Object | getAttribute(String name)
Allows the user to retrieve specific attributes on the underlying
implementation. |
boolean | getFeature(String name) Get the state of the named feature. Feature names are fully qualified java.net.URIs. |
boolean | isXIncludeAware() Get state of XInclude processing. |
DocumentBuilder | newDocumentBuilder()
Creates a new instance of a javax.xml.parsers.DocumentBuilder
using the currently configured parameters.
|
void | setAttribute(String name, Object value)
Allows the user to set specific attributes on the underlying
implementation. |
void | setFeature(String name, boolean value) Set a feature for this |
void | setXIncludeAware(boolean state) Set state of XInclude processing. If XInclude markup is found in the document instance, should it be processed as specified in XML Inclusions (XInclude) Version 1.0. XInclude processing defaults to |
Parameters: name The name of the attribute. For Saxon this must be one of the names defined in FeatureKeys
Returns: value The value of the attribute.
Throws: IllegalArgumentException thrown if the underlying implementation doesn't recognize the attribute.
Get the state of the named feature.
Feature names are fully qualified java.net.URIs. Implementations may define their own features. An javax.xml.parsers.ParserConfigurationException is thrown if thisDocumentBuilderFactory
or the
DocumentBuilder
s it creates cannot support the feature.
It is possible for an DocumentBuilderFactory
to expose a feature value but be unable to change its state.
Parameters: name Feature name.
Returns: State of the named feature.
Throws: javax.xml.parsers.ParserConfigurationException
if this DocumentBuilderFactory
or the DocumentBuilder
s it creates cannot support this feature.
Get state of XInclude processing.
Returns: current state of XInclude processing
Throws: UnsupportedOperationException For backward compatibility, when implementations for earlier versions of JAXP is used, this exception will be thrown.
Since: 1.5
Returns: A new instance of a DocumentBuilder. For Saxon the returned DocumentBuilder will be an instance of DocumentBuilderImpl
Throws: ParserConfigurationException if a DocumentBuilder cannot be created which satisfies the configuration requested.
Parameters: name The name of the attribute. For Saxon this must be one of the names defined in FeatureKeys value The value of the attribute.
Throws: IllegalArgumentException thrown if the underlying implementation doesn't recognize the attribute.
Set a feature for this DocumentBuilderFactory
and DocumentBuilder
s created by this factory.
DocumentBuilderFactory
or the
DocumentBuilder
s it creates cannot support the feature.
It is possible for an DocumentBuilderFactory
to expose a feature value but be unable to change its state.
All implementations are required to support the javax.xml.XMLConstants#FEATURE_SECURE_PROCESSING feature.
When the feature is:
true
: the implementation will limit XML processing to conform to implementation limits.
Examples include entity expansion limits and XML Schema constructs that would consume large amounts of resources.
If XML processing is limited for security reasons, it will be reported via a call to the registered
org.xml.sax.ErrorHandler#fatalError(org.xml.sax.SAXParseException exception).
See javax.xml.parsers.DocumentBuilder#setErrorHandler(org.xml.sax.ErrorHandler errorHandler).
false
: the implementation will processing XML according to the XML specifications without
regard to possible implementation limits.
Parameters: name Feature name. value Is feature state true
or false
.
Throws: javax.xml.parsers.ParserConfigurationException
if this DocumentBuilderFactory
or the DocumentBuilder
s
it creates cannot support this feature. NullPointerException If the name
parameter is null.
Set state of XInclude processing.
If XInclude markup is found in the document instance, should it be processed as specified in XML Inclusions (XInclude) Version 1.0.
XInclude processing defaults to false
.
Parameters: state Set XInclude processing to true
or
false
Throws: UnsupportedOperationException For backward compatibility, when implementations for earlier versions of JAXP is used, this exception will be thrown.
Since: 1.5