Parses the input stream into a yaidom Document
.
Parses the input stream into a yaidom Document
. Closes the input stream afterwards.
Parses the content of the given File into a eu.cdevreeze.yaidom.simple.Document.
Parses the content of the given File into a eu.cdevreeze.yaidom.simple.Document.
Parses the content of the given URI into a eu.cdevreeze.yaidom.simple.Document.
Parses the content of the given URI into a eu.cdevreeze.yaidom.simple.Document.
Returns an adapted copy having the passed ConverterToDocument.
Returns an adapted copy having the passed ConverterToDocument. This method makes it possible to use an adapted converter, which may be needed depending on the JAXP implementation used.
StAX-based
Document
parser.Typical non-trivial creation is as follows, assuming a class
MyXmlResolver
, which extendsXMLResolver
, and a classMyXmlReporter
, which extendsXMLReporter
:A custom
XMLResolver
could be used to retrieve DTDs locally, or even to suppress DTD resolution. The latter can be coded as follows (compare with http://stuartsierra.com/2008/05/08/stop-your-java-sax-parser-from-downloading-dtds), risking some loss of information:A trivial
XMLReporter
could look like this:If more flexibility is needed in configuring the
DocumentParser
than offered by this class, consider writing a wrapperDocumentParser
which wraps aDocumentParserUsingStax
, but adapts theparse
method. This would make it possible to adapt the conversion from StAX events to yaidomDocument
, for example.A
DocumentParserUsingStax
instance can be re-used multiple times, from the same thread. If theXMLInputFactory
is thread-safe, it can even be re-used from multiple threads. Typically aXMLInputFactory
cannot be trusted to be thread-safe, however. In a web application, one (safe) way to deal with that is to use oneXMLInputFactory
instance per request.