nu.xom.converters
public class DOMConverter extends Object
Converts XOM Document
objects to and from DOM
Document
objects. This class can also
convert many DOM node objects into the corresponding
XOM node objects. However, the reverse is not possible because
DOM objects cannot live outside their containing
Document
.
Version: 1.2d1
Method Summary | |
---|---|
static Document | convert(Document domDocument)
Translates a DOM |
static Document | convert(Document domDocument, NodeFactory factory)
Translates a DOM |
static Nodes | convert(DocumentFragment fragment)
Translates a DOM |
static Nodes | convert(DocumentFragment fragment, NodeFactory factory)
Translates a DOM |
static Comment | convert(Comment comment)
Translates a DOM |
static Text | convert(Text text)
Translates a DOM |
static Attribute | convert(Attr attribute)
Translates a DOM |
static ProcessingInstruction | convert(ProcessingInstruction pi)
Translates a DOM |
static DocType | convert(DocumentType doctype)
Translates a DOM |
static Element | convert(Element element)
Translates a DOM |
static Document | convert(Document document, DOMImplementation impl)
Translates a XOM |
Translates a DOM org.w3c.dom.Document
object
into an equivalent nu.xom.Document
object.
The original DOM document is not changed.
Some DOM Document
objects cannot
be serialized as namespace well-formed XML, and
thus cannot be converted to XOM.
Parameters: domDocument the DOM document to translate
Returns: a XOM document
Throws: XMLException if the DOM document is not a well-formed XML document
Translates a DOM org.w3c.dom.Document
object
into an equivalent nu.xom.Document
object as
controlled by a factory.
The original DOM document is not changed.
Some DOM Document
objects cannot
be serialized as namespace well-formed XML, and
thus cannot be converted to XOM.
Parameters: domDocument the DOM document to translate factory the factory that converts each DOM node into zero or more XOM nodes
Returns: a XOM document
Throws: XMLException if the DOM document is not a well-formed XML document
Translates a DOM org.w3c.dom.DocumentFragment
object into an equivalent nu.xom.Nodes
object.
The original DOM document fragment is not changed.
Some DOM DocumentFragment
objects cannot
be serialized as namespace well-balanced XML, and
thus cannot be converted to XOM.
Parameters: fragment the DOM document fragment to translate
Returns: a Nodes
containing the converted
fragment members
Throws: XMLException if the DOM object is not a well-balanced XML fragment
Translates a DOM org.w3c.dom.DocumentFragment
object into an equivalent nu.xom.Nodes
object,
converting each DOM node as specified by a factory.
The original DOM document fragment is not changed.
Some DOM DocumentFragment
objects cannot
be serialized as namespace well-balanced XML, and
thus cannot be converted to XOM.
Parameters: fragment the DOM document fragment to translate factory the NodeFactory that converts each DOM node into a XOM node
Returns: a Nodes
containing the converted
fragment members
Throws: XMLException if the DOM object is not a well-balanced XML fragment
Translates a DOM org.w3c.dom.Comment
object
into an equivalent nu.xom.Comment
object.
The original DOM object is not changed.
Some DOM Comment
objects cannot
be serialized as well-formed XML, and
thus cannot be converted to XOM.
Parameters: comment the DOM comment to translate
Returns: a XOM comment
Throws: XMLException if the DOM comment is not a well-formed XML comment
Translates a DOM org.w3c.dom.Text
object
into an equivalent nu.xom.Text
.
This method will also convert org.w3c.dom.CDATA
objects. The original DOM object is not changed.
Some DOM Text
objects cannot
be serialized as well-formed XML, and
thus cannot be converted to XOM.
Parameters: text the DOM text to translate
Returns: a XOM text
Throws: XMLException if the DOM text is not a well-formed XML text
Translates a DOM org.w3c.dom.Attr
object
into an equivalent nu.xom.Attribute
object.
The original DOM object is not changed.
Some DOM Attr
objects cannot
be serialized as well-formed XML, and
thus cannot be converted to XOM. Furthermore, DOM uses
Attr
objects to represent namespace declarations.
XOM does not. Converting an Attr
object that
represents an xmlns
or
xmlns:prefix
attribute will cause an
exception.
Parameters: attribute the DOM Attr
to translate
Returns: the equivalent XOM Attribute
Throws: XMLException if the DOM Attr
is a namespace declaration or is not a well-formed
XML attribute
Translates a DOM org.w3c.dom.ProcessingInstruction
object into an equivalent
nu.xom.ProcessingInstruction
object.
The original DOM object is not changed.
Some DOM ProcessingInstruction
objects cannot
be serialized as well-formed XML, and
thus cannot be converted to XOM.
Parameters: pi the DOM ProcessingInstruction
to
convert
Returns: a XOM ProcessingInstruction
Throws: XMLException if the DOM ProcessingInstruction
is not a well-formed XML processing instruction
Translates a DOM org.w3c.dom.DocumentType
object into an equivalent nu.xom.DocType
object.
The original DOM object is not changed. Some DOM
DocumentType
objects cannot be serialized as
well-formed XML, and thus cannot be converted to XOM.
Parameters: doctype the DOM DocumentType
to convert
Returns: the equivalent XOM DocType
Throws: XMLException if the DOM DocumentType
is not a well-formed XML document type declaration
Translates a DOM org.w3c.dom.Element
object into an equivalent nu.xom.Element
object.
The original DOM object is not changed. Some DOM
Element
objects cannot be serialized as
namespace well-formed XML, and thus cannot be converted to XOM.
Parameters: element the DOM Element
to convert
Returns: the equivalent XOM Element
Throws: XMLException if the DOM Element
is not a well-formed XML element
Translates a XOM nu.xom.Document
object
into an equivalent org.w3c.dom.Document
object. The original XOM document is not changed.
Since DOM2 internal subsets are read-only,
the internal DTD subset is not converted.
All other aspects of the document should be
translated without a problem.
Parameters: document the XOM document to translate impl the specific DOM implementation into which this document will be converted
Returns: a DOM document