org.apache.harmony.xml.parsers

Class DocumentBuilderFactoryImpl

java.lang.Object

javax.xml.parsers.DocumentBuilderFactory

org.apache.harmony.xml.parsers.DocumentBuilderFactoryImpl

public class DocumentBuilderFactoryImpl
extends DocumentBuilderFactory

Provides a straightforward DocumentBuilderFactory implementation based on XMLPull/KXML. The class is used internally only, thus only notable members that are not already in the abstract superclass are documented. Hope that's ok.

Constructor Summary

Constructors

Constructor and Description
DocumentBuilderFactoryImpl()

Method Summary

Modifier and Type	Method and Description
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.
DocumentBuilder	newDocumentBuilder() Creates a new instance of a 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 DocumentBuilderFactory and DocumentBuilders created by this factory.

Methods inherited from class javax.xml.parsers.DocumentBuilderFactory

getSchema, isCoalescing, isExpandEntityReferences, isIgnoringComments, isIgnoringElementContentWhitespace, isNamespaceAware, isValidating, isXIncludeAware, newInstance, newInstance, setCoalescing, setExpandEntityReferences, setIgnoringComments, setIgnoringElementContentWhitespace, setNamespaceAware, setSchema, setValidating, setXIncludeAware

Methods inherited from class java.lang.Object

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

Constructor Detail

DocumentBuilderFactoryImpl

public DocumentBuilderFactoryImpl()

Method Detail

getAttribute

public Object getAttribute(String name)
                    throws IllegalArgumentException

Description copied from class: DocumentBuilderFactory

Allows the user to retrieve specific attributes on the underlying implementation.

Specified by:

getAttribute in class DocumentBuilderFactory

Parameters:

name - The name of the attribute.

Returns:

value The value of the attribute.

Throws:

IllegalArgumentException - thrown if the underlying implementation doesn't recognize the attribute.

getFeature

public boolean getFeature(String name)
                   throws ParserConfigurationException

Description copied from class: DocumentBuilderFactory

Get the state of the named feature.

Feature names are fully qualified URIs. Implementations may define their own features. An ParserConfigurationException is thrown if this DocumentBuilderFactory or the DocumentBuilders it creates cannot support the feature. It is possible for an DocumentBuilderFactory to expose a feature value but be unable to change its state.

Specified by:

getFeature in class DocumentBuilderFactory

Parameters:

name - Feature name.

Returns:

State of the named feature.

Throws:

ParserConfigurationException - if this DocumentBuilderFactory or the DocumentBuilders it creates cannot support this feature.

newDocumentBuilder

public DocumentBuilder newDocumentBuilder()
                                   throws ParserConfigurationException

Description copied from class: DocumentBuilderFactory

Creates a new instance of a DocumentBuilder using the currently configured parameters.

Specified by:

newDocumentBuilder in class DocumentBuilderFactory

Returns:

A new instance of a DocumentBuilder.

Throws:

ParserConfigurationException - if a DocumentBuilder cannot be created which satisfies the configuration requested.

setAttribute

public void setAttribute(String name,
                         Object value)
                  throws IllegalArgumentException

Description copied from class: DocumentBuilderFactory

Allows the user to set specific attributes on the underlying implementation.

Specified by:

setAttribute in class DocumentBuilderFactory

Parameters:

name - The name of the attribute.

value - The value of the attribute.

Throws:

IllegalArgumentException - thrown if the underlying implementation doesn't recognize the attribute.

setFeature

public void setFeature(String name,
                       boolean value)
                throws ParserConfigurationException

Description copied from class: DocumentBuilderFactory

Set a feature for this DocumentBuilderFactory and DocumentBuilders created by this factory.

Feature names are fully qualified URIs. Implementations may define their own features. An ParserConfigurationException is thrown if this DocumentBuilderFactory or the DocumentBuilders 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 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 ErrorHandler.fatalError(SAXParseException exception). See DocumentBuilder.setErrorHandler(org.xml.sax.ErrorHandler errorHandler).
• false: the implementation will processing XML according to the XML specifications without regard to possible implementation limits.

Specified by:

setFeature in class DocumentBuilderFactory

Parameters:

name - Feature name.

value - Is feature state true or false.

Throws:

ParserConfigurationException - if this DocumentBuilderFactory or the DocumentBuilders it creates cannot support this feature.