javax.xml.transform.dom (Java SE 9 & JDK 9 ) (original) (raw)

Provides DOM specific transformation classes.

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

The DOMResult class allows a Node to be specified to which result DOM nodes will be appended. If an output node is not specified, the transformer will useDocumentBuilder.newDocument() to create an output Document node. If a node is specified, it should be one of the following: Document,Element, orDocumentFragment. Specification of any other node type is implementation dependent and undefined by this API. If the result is aDocument, the output of the transformation must have a single element root to set as the document element.

The DOMLocator node may be passed to TransformerException objects, and retrieved by trying to cast the result of theTransformerException.getLocator() method. The implementation has no responsibility to use a DOMLocator instead of aSourceLocator (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

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

• Class Summary

  Class	Description
  DOMResult	Acts as a holder for a transformation result tree in the form of a Document Object Model (DOM) tree.
  DOMSource	Acts as a holder for a transformation Source tree in the form of a Document Object Model (DOM) tree.

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.