APIdia Launch Partner
Top Description Interfaces Classes
module java.xml

Package javax.xml.transform.dom


Provides DOM specific transformation classes.

The javax.xml.transform.dom.DOMSource class allows the client of the implementation of this API to specify a DOM org.w3c.dom.Node as the source of the input tree. The model of how the Transformer deals with the DOM tree in terms of mismatches with the XSLT data model or other data models is beyond the scope of this document. Any of the nodes derived from org.w3c.dom.Node are legal input.

The javax.xml.transform.dom.DOMResult class allows a org.w3c.dom.Node to be specified to which result DOM nodes will be appended. If an output node is not specified, the transformer will use javax.xml.parsers.DocumentBuilder#newDocument to create an output org.w3c.dom.Document node. If a node is specified, it should be one of the following: org.w3c.dom.Document, org.w3c.dom.Element, or org.w3c.dom.DocumentFragment. Specification of any other node type is implementation dependent and undefined by this API. If the result is a org.w3c.dom.Document, the output of the transformation must have a single element root to set as the document element.

The javax.xml.transform.dom.DOMLocator node may be passed to javax.xml.transform.TransformerException objects, and retrieved by trying to cast the result of the javax.xml.transform.TransformerException#getLocator() method. The implementation has no responsibility to use a DOMLocator instead of a javax.xml.transform.SourceLocator (though line numbers and the like do not make much sense for a DOM), so the result of getLocator must always be tested with an instanceof.

Since
1.5

Interface Summary

Modifier and TypeInterface and Description
public interface
DOMLocator

Indicates the position of a node in a source DOM, intended primarily for error reporting.

Class Summary

Modifier and TypeClass and Description
public class
DOMResult

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

public class
DOMSource

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