DOMSource (Java SE 9 & JDK 9 ) (original) (raw)

• java.lang.Object

• • javax.xml.transform.dom.DOMSource

• All Implemented Interfaces:
  [Source](../../../../javax/xml/transform/Source.html "interface in javax.xml.transform")

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 callingDocumentBuilderFactory.setNamespaceAware(boolean awareness).
Since:
1.4
See Also:
Document Object Model (DOM) Level 2 Specification

• • Field Summary

  Fields

  Modifier and Type	Field	Description
  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

  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

  All Methods Instance Methods Concrete Methods

  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 inherited from class java.lang.[Object](../../../../java/lang/Object.html "class in java.lang")  
     `[clone](../../../../java/lang/Object.html#clone--), [equals](../../../../java/lang/Object.html#equals-java.lang.Object-), [finalize](../../../../java/lang/Object.html#finalize--), [getClass](../../../../java/lang/Object.html#getClass--), [hashCode](../../../../java/lang/Object.html#hashCode--), [notify](../../../../java/lang/Object.html#notify--), [notifyAll](../../../../java/lang/Object.html#notifyAll--), [toString](../../../../java/lang/Object.html#toString--), [wait](../../../../java/lang/Object.html#wait--), [wait](../../../../java/lang/Object.html#wait-long-), [wait](../../../../java/lang/Object.html#wait-long-int-)`

• • Field Detail

     * #### FEATURE  
     public static final [String](../../../../java/lang/String.html "class in java.lang") FEATURE  
     See Also:  
     [Constant Field Values](../../../../constant-values.html#javax.xml.transform.dom.DOMSource.FEATURE)  

  • Constructor Detail

    * #### DOMSource  
    public DOMSource​()  
    See Also:  
    [Transformer.transform(Source xmlSource, Result outputTarget)](../../../../javax/xml/transform/Transformer.html#transform-javax.xml.transform.Source-javax.xml.transform.Result-)  
    * #### DOMSource  
    public DOMSource​([Node](../../../../org/w3c/dom/Node.html "interface in org.w3c.dom") 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](../../../../org/w3c/dom/Node.html "interface in org.w3c.dom") node,  
                     [String](../../../../java/lang/String.html "class in java.lang") 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](../../../../org/w3c/dom/Node.html "interface in org.w3c.dom") node)  
    Set the node that will represents a Source DOM tree.  
    Parameters:  
    `node` \- The node that is to be transformed.  
    * #### getNode  
    public [Node](../../../../org/w3c/dom/Node.html "interface in org.w3c.dom") getNode​()  
    Get the node that represents a Source DOM tree.  
    Returns:  
    The node that is to be transformed.  
    * #### setSystemId  
    public void setSystemId​([String](../../../../java/lang/String.html "class in java.lang") systemID)  
    Set the base ID (URL or system ID) from where URLs will be resolved.  
    Specified by:  
    `[setSystemId](../../../../javax/xml/transform/Source.html#setSystemId-java.lang.String-)` in interface `[Source](../../../../javax/xml/transform/Source.html "interface in javax.xml.transform")`  
    Parameters:  
    `systemID` \- Base URL for this DOM tree.  
    * #### getSystemId  
    public [String](../../../../java/lang/String.html "class in java.lang") getSystemId​()  
    Get the base ID (URL or system ID) from where URLs will be resolved.  
    Specified by:  
    `[getSystemId](../../../../javax/xml/transform/Source.html#getSystemId--)` in interface `[Source](../../../../javax/xml/transform/Source.html "interface in javax.xml.transform")`  
    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](../../../../javax/xml/transform/Source.html#isEmpty--)` in interface `[Source](../../../../javax/xml/transform/Source.html "interface in javax.xml.transform")`  
    Returns:  
    true if the `DOMSource` object is empty, false otherwise

Report a bug or suggest an enhancement
For further API reference and developer documentation see the Java SE Documentation, which contains more detailed, developer-targeted descriptions with conceptual overviews, definitions of terms, workarounds, and working code examples.
Java is a trademark or registered trademark of Oracle and/or its affiliates in the US and other countries.
Copyright © 1993, 2017, Oracle and/or its affiliates, 500 Oracle Parkway, Redwood Shores, CA 94065 USA.
All rights reserved. Use is subject to license terms and the documentation redistribution policy.