public class StAXEventBuilder extends java.lang.Object
XMLEventReaders are pre-configured and as a result JDOM is not able to alter whether the input is validated, or whether the Events have escaped entities or not. These (and other) characteristics are configurable by setting the correct features and properties on the XMLInputFactory when it is used to create the XMLStreamReader.
Useful configuration to set, or know about is:
http://java.sun.com/xml/stream/properties/report-cdata-eventfor the default Java StAX implementation, or the equivalent property for your StAX engine.
From a JDOM perspective XMLStreamReaders are more efficient than XMLEventReaders. Where possible use an XMLStreamReader.
If you happen to be looking at the source code, pay careful attention to the imports so you know what type of instance is being processed, whether it is a StAX class, or a JDOM class, because there are name conflicts.
|Constructor and Description|
|Modifier and Type||Method and Description|
This builds a document from the supplied XMLEventReader.
Returns the current
This sets a custom JDOMFactory for the builder.
public JDOMFactory getFactory()
public void setFactory(JDOMFactory factory)
public Document build(javax.xml.stream.XMLEventReader events) throws JDOMException
The JDOMContent will be built by the current JDOMFactory.
XMLEventReaderto read from
Documentresultant Document object
JDOMException- when errors occur in parsing
Copyright © 2015 Jason Hunter, Brett McLaughlin. All Rights Reserved.