org.apache.axiom.om.impl.dom.jaxp

Class DocumentBuilderFactoryImpl

java.lang.Object

javax.xml.parsers.DocumentBuilderFactory

org.apache.axiom.om.impl.dom.jaxp.DocumentBuilderFactoryImpl

Deprecated.

This class has static methods that allow to switch between DOOM and the default DOM implementation as returned by JAXP. This was a hack introduced for Rampart. Recent versions of Rampart no longer rely on this hack. On the other hand usage of setDOOMRequired(boolean) in a concurrent environment can lead to unexpected behavior and severe bugs, as shown in AXIOM-3 and AXIS2-1570. Due to the way newDocumentBuilder() is implemented, it is not possible to get rid of the setDOOMRequired hack without the risk of breaking existing code.

Application code should always use DOMMetaFactory.newDocumentBuilderFactory() to get an Axiom compatible DocumentBuilderFactory and should not attempt to override the JVM's default DocumentBuilderFactory with an Axiom compatible version.

public class DocumentBuilderFactoryImpl
extends DocumentBuilderFactory

Field Summary

Fields

Modifier and Type	Field and Description
protected Schema	schema Deprecated.

Constructor Summary

Constructors

Constructor and Description
DocumentBuilderFactoryImpl() Deprecated.

Method Summary

Modifier and Type	Method and Description
Object	getAttribute(String name) Deprecated.
boolean	getFeature(String name) Deprecated.
Schema	getSchema() Deprecated.
static boolean	isDOOMRequired() Deprecated.
DocumentBuilder	newDocumentBuilder() Deprecated.
static DocumentBuilderFactory	newInstance() Deprecated.
void	setAttribute(String name, Object value) Deprecated.
static void	setDOOMRequired(boolean isDOOMRequired) Deprecated.
void	setFeature(String name, boolean value) Deprecated.
void	setSchema(Schema schema) Deprecated.

Methods inherited from class javax.xml.parsers.DocumentBuilderFactory

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

Methods inherited from class java.lang.Object

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

Field Detail

schema

protected Schema schema

Deprecated.

Constructor Detail

DocumentBuilderFactoryImpl

public DocumentBuilderFactoryImpl()

Deprecated.

Method Detail

isDOOMRequired

public static boolean isDOOMRequired()

Deprecated.

setDOOMRequired

public static void setDOOMRequired(boolean isDOOMRequired)

Deprecated.

newDocumentBuilder

public DocumentBuilder newDocumentBuilder()
                                   throws ParserConfigurationException

Deprecated.

Specified by:

newDocumentBuilder in class DocumentBuilderFactory

Throws:

ParserConfigurationException

getAttribute

public Object getAttribute(String name)
                    throws IllegalArgumentException

Deprecated.

Specified by:

getAttribute in class DocumentBuilderFactory

Throws:

IllegalArgumentException

setAttribute

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

Deprecated.

Specified by:

setAttribute in class DocumentBuilderFactory

Throws:

IllegalArgumentException

newInstance

public static DocumentBuilderFactory newInstance()

Deprecated.

setFeature

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

Deprecated.

Specified by:

setFeature in class DocumentBuilderFactory

Throws:

ParserConfigurationException

getFeature

public boolean getFeature(String name)
                   throws ParserConfigurationException

Deprecated.

Specified by:

getFeature in class DocumentBuilderFactory

Throws:

ParserConfigurationException

setSchema

public void setSchema(Schema schema)

Deprecated.

Overrides:

setSchema in class DocumentBuilderFactory

getSchema

public Schema getSchema()

Deprecated.

Overrides:

getSchema in class DocumentBuilderFactory