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 contructed 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
Modifier and Type | Field | Description |
---|---|---|
static String | FEATURE | If |
Constructor Summary
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 |
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 java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
Field Detail
FEATURE
public static final String FEATURE
If TransformerFactory.getFeature(java.lang.String)
returns true when passed this value as an argument, the Transformer supports Source input of this type.
- See Also:
- Constant Field Values
Constructor Detail
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()
.
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 Detail
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 interfaceSource
- 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 interfaceSource
- 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.