axproject.org'>http://www.saxproject.org for further information.
Note: despite its name, this interface does not extend the standard Java {@link java.io.Reader Reader} interface, because reading XML is a fundamentally different activity than reading character data.
XMLReader is the interface that an XML parser's SAX2 driver must implement. This interface allows an application to set and query features and properties in the parser, to register event handlers for document processing, and to initiate a document parse.
All SAX interfaces are assumed to be synchronous: the {@link #parse parse} methods must not return until parsingis complete, and readers must wait for an event-handler callback to return before reporting the next event.
This interface replaces the (now deprecated) SAX 1.0 {@link org.xml.sax.Parser Parser} interface. The XMLReader interfacecontains two important enhancements over the old Parser interface (as well as some minor ones):
- it adds a standard way to query and set features and properties; and
- it adds Namespace support, which is required for many higher-level XML standards.
There are adapters available to convert a SAX1 Parser to a SAX2 XMLReader and vice-versa.
@since SAX 2.0
@author David Megginson
@version 2.0.1+ (sax2r3pre1)
@see org.xml.sax.XMLFilter
@see org.xml.sax.helpers.ParserAdapter
@see org.xml.sax.helpers.XMLReaderAdapter