XMLReader JDK 1.6)

Hide/Show inherited methods

public ContentHandler getContentHandler ()

Return the current content handler.

public DTDHandler getDTDHandler ()

Return the current DTD handler.

public EntityResolver getEntityResolver ()

Return the current entity resolver.

public ErrorHandler getErrorHandler ()

Return the current error handler.

public boolean getFeature (String name) throws SAXNotRecognizedException SAXNotSupportedException

Look up the value of a feature flag.

The feature name is any fully-qualified URI. It is possible for an XMLReader to recognize a feature name but temporarily be unable to return its value. Some feature values may be available only in specific contexts, such as before, during, or after a parse. Also, some feature values may not be programmatically accessible. (In the case of an adapter for SAX1 Parser, there is no implementation-independent way to expose whether the underlying parser is performing validation, expanding external entities, and so forth.)

All XMLReaders are required to recognize the http://xml.org/sax/features/namespaces and the http://xml.org/sax/features/namespace-prefixes feature names.

Typical usage is something like this:

 XMLReader r = new MySAXDriver();

                         // try to activate validation
 try {
   r.setFeature("http://xml.org/sax/features/validation", true);
 } catch (SAXException e) {
   System.err.println("Cannot activate validation."); 
 }

                         // register event handlers
 r.setContentHandler(new MyContentHandler());
 r.setErrorHandler(new MyErrorHandler());

                         // parse the first document
 try {
   r.parse("http://www.foo.com/mydoc.xml");
 } catch (IOException e) {
   System.err.println("I/O exception reading XML document");
 } catch (SAXException e) {
   System.err.println("XML exception reading document.");
 }

Implementors are free (and encouraged) to invent their own features, using names built on their own URIs.

Returns: The current value of the feature (true or false).
Parameters:
- name - The feature name, which is a fully-qualified URI.
Throws:
- org.xml.sax.SAXNotRecognizedException - If the feature value can't be assigned or retrieved.
- org.xml.sax.SAXNotSupportedException - When the XMLReader recognizes the feature name but cannot determine its value at this time.
See Also: XMLReader.setFeature(java.lang.String, boolean),

public Object getProperty (String name) throws SAXNotRecognizedException SAXNotSupportedException

Look up the value of a property.

public void parse (InputSource input) throws IOException SAXException

Parse an XML document.

public void parse (String systemId) throws IOException SAXException

Parse an XML document from a system identifier (URI).

This method is a shortcut for the common case of reading a document from a system identifier. It is the exact equivalent of the following:

 parse(new InputSource(systemId));

If the system identifier is a URL, it must be fully resolved by the application before it is passed to the parser.

Parameters:
- systemId - The system identifier (URI).
Throws:
- org.xml.sax.SAXException - Any SAX exception, possibly wrapping another exception.
- java.io.IOException - An IO exception from the parser, possibly from a byte stream or character stream supplied by the application.
See Also: XMLReader.parse(org.xml.sax.InputSource),

public void setContentHandler (ContentHandler handler)

Allow an application to register a content event handler.

public void setDTDHandler (DTDHandler handler)

Allow an application to register a DTD event handler.

public void setEntityResolver (EntityResolver resolver)

Allow an application to register an entity resolver.

public void setErrorHandler (ErrorHandler handler)

Allow an application to register an error event handler.

public void setFeature (String name, boolean value) throws SAXNotRecognizedException SAXNotSupportedException

Set the value of a feature flag.

public void setProperty (String name, Object value) throws SAXNotRecognizedException SAXNotSupportedException

Set the value of a property.