oracle.xml.jaxp
Class JXDocumentBuilderFactory

java.lang.Object
  |
  +--javax.xml.parsers.DocumentBuilderFactory
        |
        +--oracle.xml.jaxp.JXDocumentBuilderFactory

public class JXDocumentBuilderFactory

extends DocumentBuilderFactory

Defines a factory API that enables applications to obtain a parser that produces DOM object trees from XML documents.

Since:

JAXP 1.0

Field Summary

Type	Field
static java.lang.String	BASE_URL Base URL used in parsing entities.
static java.lang.String	DEBUG_MODE Sets Debug Mode - Boolean.TRUE or Boolean.FALSE
static java.lang.String	DTD_OBJECT DTD Object to be used for validation.
static java.lang.String	ERROR_ENCODING Encoding for errors report via error stream (only if ERROR_STREAM is set)
static java.lang.String	ERROR_STREAM Error stream for reporting errors.
static java.lang.String	NODE_FACTORY Set NodeFactory to build custom Nodes
static java.lang.String	SCHEMA_OBJECT Schema Object to be used for validation.
static java.lang.String	SHOW_WARNINGS Boolean to ignore warnings - Boolean.TRUE or Boolean.FALSE
static java.lang.String	USE_DTD_ONLY_FOR_VALIDATION If true, DTD Object is used only for validation and is not added to the parser document

Constructor Summary

JXDocumentBuilderFactory()
Default Constructor

Method Summary

Type	Method
java.lang.Object	getAttribute(java.lang.String name) Allows the user to retrieve specific attributes on the underlying implementation.
boolean	isIgnoreElementContentWhitespace()
boolean	isNamespaceAware() Indicates whether or not the factory is configured to produce parsers which are namespace aware.
DocumentBuilder	newDocumentBuilder() Creates a new instance of a DocumentBuilder using the currently configured parameters.
void	setAttribute(java.lang.String name, java.lang.Object value) Allows the user to set specific attributes on the underlying implementation.
void	setIgnoreElementContentWhitespace(boolean whitespace)

Methods inherited from class javax.xml.parsers.DocumentBuilderFactory

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

Methods inherited from class java.lang.Object

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

Field Detail

ERROR_STREAM

public static final java.lang.String ERROR_STREAM

Error stream for reporting errors. The object can be OutputStream or PrintWriter. This attribute is ignored if ErrorHandler is set.

ERROR_ENCODING

public static final java.lang.String ERROR_ENCODING

Encoding for errors report via error stream (only if ERROR_STREAM is set)

SHOW_WARNINGS

public static final java.lang.String SHOW_WARNINGS

Boolean to ignore warnings - Boolean.TRUE or Boolean.FALSE

DEBUG_MODE

public static final java.lang.String DEBUG_MODE

Sets Debug Mode - Boolean.TRUE or Boolean.FALSE

NODE_FACTORY

public static final java.lang.String NODE_FACTORY

Set NodeFactory to build custom Nodes

DTD_OBJECT

public static final java.lang.String DTD_OBJECT

DTD Object to be used for validation.

USE_DTD_ONLY_FOR_VALIDATION

public static final java.lang.String USE_DTD_ONLY_FOR_VALIDATION

If true, DTD Object is used only for validation and is not added to the parser document

SCHEMA_OBJECT

public static final java.lang.String SCHEMA_OBJECT

Schema Object to be used for validation.

BASE_URL

public static final java.lang.String BASE_URL

Base URL used in parsing entities.

Constructor Detail

JXDocumentBuilderFactory

public JXDocumentBuilderFactory()

Default Constructor

Method Detail

newDocumentBuilder

public DocumentBuilder newDocumentBuilder()
                                   throws ParserConfigurationException

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

Overrides:

newDocumentBuilder in class DocumentBuilderFactory

Throws:

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

isNamespaceAware

public boolean isNamespaceAware()

Indicates whether or not the factory is configured to produce parsers which are namespace aware. Always returns TRUE - Currently there is no way to turn of Namespaces

Overrides:

isNamespaceAware in class DocumentBuilderFactory

Returns:

boolean namespace awareness.

isIgnoreElementContentWhitespace

public boolean isIgnoreElementContentWhitespace()

setIgnoreElementContentWhitespace

public void setIgnoreElementContentWhitespace(boolean whitespace)

setAttribute

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

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

Overrides:

setAttribute in class DocumentBuilderFactory

Parameters:

name - The name of the attribute.

value - The value of the attribute.

Throws:

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

getAttribute

public java.lang.Object getAttribute(java.lang.String name)
                              throws java.lang.IllegalArgumentException

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

Overrides:

getAttribute in class DocumentBuilderFactory

Parameters:

name - The name of the attribute.

Returns:

value The value of the attribute.

Throws:

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