javax.xml.transform.dom

## Class DOMSource

- java.lang.Object
- - javax.xml.transform.dom.DOMSource

- All Implemented Interfaces:
    Source

      public class DOMSource
      extends java.lang.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)`.

  Version:
    $Revision: 446598 $, $Date: 2006-09-15 08:55:40 -0400 (Fri, 15 Sep 2006) $
  Author:
    Jeff Suttor
  See Also:
    Document Object Model (DOM) Level 2 Specification

- - ### Field Summary

    Fields
    Modifier and Type | Field and Description
    --- | ---
    `static java.lang.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

    Constructors
    Constructor and Description
    `DOMSource()` Zero-argument default constructor.
    `DOMSource(Node n)` Create a new input source with a DOM node.
    `DOMSource(Node node, java.lang.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

    Methods
    Modifier and Type | Method and Description
    --- | ---
    `Node` | `getNode()` Get the node that represents a Source DOM tree.
    `java.lang.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(java.lang.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 java.lang.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,
                   java.lang.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(java.lang.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 java.lang.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.

Copyright © 1999-2022 The Apache Software Foundation. All Rights Reserved.