1 <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN"> 2 <html> 3 <head> 4 <META http-equiv="Content-Type" content="text/html; charset=UTF-8"> 5 <title>javax.xml.transform.dom</title> 6 </head> 7 <body> 8 <p>This package implements DOM-specific transformation APIs.</p> 9 <p>The {@link javax.xml.transform.dom.DOMSource} class allows the 10 client of the implementation of this API to specify a DOM 11 {@link org.w3c.dom.Node} as the source of the input tree. The model of 12 how the Transformer deals with the DOM tree in terms of mismatches with the 13 <A href="http://www.w3.org/TR/xslt#data-model">XSLT data model</A> or 14 other data models is beyond the scope of this document. Any of the nodes 15 derived from {@link org.w3c.dom.Node} are legal input.</p> 16 <p>The {@link javax.xml.transform.dom.DOMResult} class allows 17 a {@link org.w3c.dom.Node} to be specified to which result DOM nodes will 18 be appended. If an output node is not specified, the transformer will use 19 {@link javax.xml.parsers.DocumentBuilder#newDocument} to create an 20 output {@link org.w3c.dom.Document} node. If a node is specified, it 21 should be one of the following: {@link org.w3c.dom.Document}, 22 {@link org.w3c.dom.Element}, or 23 {@link org.w3c.dom.DocumentFragment}. Specification of any other node 24 type is implementation dependent and undefined by this API. If the result is a 25 {@link org.w3c.dom.Document}, the output of the transformation must have 26 a single element root to set as the document element.</p> 27 <p>The {@link javax.xml.transform.dom.DOMLocator} node may be passed 28 to {@link javax.xml.transform.TransformerException} objects, and 29 retrieved by trying to cast the result of the 30 {@link javax.xml.transform.TransformerException#getLocator()} method. 31 The implementation has no responsibility to use a DOMLocator instead of a 32 {@link javax.xml.transform.SourceLocator} (though line numbers and the 33 like do not make much sense for a DOM), so the result of getLocator must always 34 be tested with an instanceof. </p> 35 </body> 36 </html> 37