Perform the conversion from StAX events to SAX events.
The StAX parser must be pointing at the start element or the start document.
The method reads the parser until it hits the corresponding end element,
and turns the complete sub-tree into the equivalent of the SAX events.
The receiver of the SAX event will see this sub-tree as if it were
a whole document.
When this method returns successfully, the parser is at the next token
of the end element.
throws: XMLStreamException - if any errors are encountered while parsing XML from theXMLStreamReader or firing events on the ContentHandler. |