Class DOMSource

java.lang.Object

javax.xml.transform.dom.DOMSource

All Implemented Interfaces:

Source

public class DOMSource
extends Object
implements Source

Acts as a holder for a transformation Source tree in the form of a Document Object Model (DOM) tree.

Note that XSLT requires namespace support. Attempting to transform a DOM that was not constructed with a namespace-aware parser may result in errors. Parsers can be made namespace aware by calling DocumentBuilderFactory.setNamespaceAware(boolean awareness).

Since:

1.4

See Also:

• Document Object Model (DOM) Level 2 Specification

Field Summary

Fields

Modifier and Type	Field	Description
static final String	FEATURE	If TransformerFactory.getFeature(String) returns true when passed this value as an argument, the Transformer supports Source input of this type.

Constructor Summary

Constructors

Constructor	Description
DOMSource()	Zero-argument default constructor.
DOMSource(Node n)	Create a new input source with a DOM node.
DOMSource(Node node, String systemID)	Create a new input source with a DOM node, and with the system ID also passed in as the base URI.

Method Summary

Modifier and Type	Method	Description
Node	getNode()	Get the node that represents a Source DOM tree.
String	getSystemId()	Get the base ID (URL or system ID) from where URLs will be resolved.
boolean	isEmpty()	Indicates whether the DOMSource object is empty.
void	setNode(Node node)	Set the node that will represents a Source DOM tree.
void	setSystemId(String systemID)	Set the base ID (URL or system ID) from where URLs will be resolved.

Methods declared in class Object

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

Modifier and Type	Method	Description
protected Object	clone()	Answers a new instance of the same class as the receiver, whose slots have been filled in with the values in the slots of the receiver.
boolean	equals(Object o)	Compares the argument to the receiver, and answers true if they represent the same object using a class specific comparison.
protected void	finalize()	Deprecated, for removal: This API element is subject to removal in a future version. May cause performance issues, deadlocks and hangs.
final Class<? extends Object>	getClass()	Answers the unique instance of java.lang.Class which represents the class of the receiver.
int	hashCode()	Answers an integer hash code for the receiver.
final void	notify()	Causes one thread which is waiting on the receiver to be made ready to run.
final void	notifyAll()	Causes all threads which are waiting on the receiver to be made ready to run.
String	toString()	Answers a string containing a concise, human-readable description of the receiver.
final void	wait()	Causes the thread which sent this message to be made not ready to run pending some change in the receiver (as indicated by notify or notifyAll).
final void	wait(long time)	Causes the thread which sent this message to be made not ready to run either pending some change in the receiver (as indicated by notify or notifyAll) or the expiration of the timeout.
final void	wait(long time, int frac)	Causes the thread which sent this message to be made not ready to run either pending some change in the receiver (as indicated by notify or notifyAll) or the expiration of the timeout.

Field Details

FEATURE

public static final String FEATURE

If TransformerFactory.getFeature(String) returns true when passed this value as an argument, the Transformer supports Source input of this type.

See Also:

• Constant Field Values

Constructor Details

DOMSource

public DOMSource()

Zero-argument default constructor. If this constructor is used, and no DOM source is set using setNode(Node node) , then the Transformer will create an empty source Document using DocumentBuilder.newDocument().

See Also:

• Transformer.transform(Source xmlSource, Result outputTarget)

DOMSource

public DOMSource(Node n)

Create a new input source with a DOM node. The operation will be applied to the subtree rooted at this node. In XSLT, a "/" pattern still means the root of the tree (not the subtree), and the evaluation of global variables and parameters is done from the root node also.

Parameters:

n - The DOM node that will contain the Source tree.

DOMSource

public DOMSource(Node node,
 String systemID)

Create a new input source with a DOM node, and with the system ID also passed in as the base URI.

Parameters:

node - The DOM node that will contain the Source tree.

systemID - Specifies the base URI associated with node.

Method Details

setNode

public void setNode(Node node)

Set the node that will represents a Source DOM tree.

Parameters:

node - The node that is to be transformed.

getNode

public Node getNode()

Get the node that represents a Source DOM tree.

Returns:

The node that is to be transformed.

setSystemId

public void setSystemId(String systemID)

Set the base ID (URL or system ID) from where URLs will be resolved.

Specified by:

setSystemId in interface Source

Parameters:

systemID - Base URL for this DOM tree.

getSystemId

public String getSystemId()

Get the base ID (URL or system ID) from where URLs will be resolved.

Specified by:

getSystemId in interface Source

Returns:

Base URL for this DOM tree.

isEmpty

public boolean isEmpty()

Indicates whether the DOMSource object is empty. Empty is defined as follows:

• if the system identifier and node are null;
• if the system identifier is null, and the node has no child nodes.

Specified by:

isEmpty in interface Source

Returns:

true if the DOMSource object is empty, false otherwise