JavaTM 2 Platform
Standard Ed. 5.0

javax.xml.transform.dom
Class DOMSource

java.lang.Object
  extended by 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).

See Also:
Document Object Model (DOM) Level 2 Specification

Field Summary
static 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.
 
Constructor Summary
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
 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.
 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 inherited from 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().

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 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 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.

JavaTM 2 Platform
Standard Ed. 5.0

Submit a bug or feature
For further API reference and developer documentation, see Java 2 SDK SE Developer Documentation. That documentation contains more detailed, developer-targeted descriptions, with conceptual overviews, definitions of terms, workarounds, and working code examples.

Copyright 2004 Sun Microsystems, Inc. All rights reserved. Use is subject to license terms. Also see the documentation redistribution policy.