Get a
SAXSource representation for this node. This method can be used to integrate
Axiom with APIs and third party libraries that don't support StAX. In particular it can be
used with the
Transformer API.
The returned object supports all events defined by
ContentHandler and
LexicalHandler.
DTDHandler and
DeclHandler are not supported.
If the node is an element and has a parent which is not a document, care is taken to properly
generate
ContentHandler#startPrefixMapping(String,String) and
ContentHandler#endPrefixMapping(String) events also for namespace mappings declared
on the ancestors of the element. To understand why this is important, consider the following
example:
<root xmlns:ns="urn:ns"><element attr="ns:someThing"/><root>
In that case, to correctly interpret the attribute value, the SAX content handler must be
aware of the namespace mapping for the ns prefix, even if the serialization starts
only at the child element.
No other form of namespace repairing is performed.