Google

: Class SAXDriver

com.icl.saxon.aelfred
Class SAXDriver


java.lang.Object

  |

  +--com.icl.saxon.aelfred.SAXDriver


An enhanced SAX2 version of Microstar's Ælfred XML parser. The enhancements primarily relate to significant improvements in conformance to the XML specification, and SAX2 support. Performance has been improved. However, the Ælfred proprietary APIs are no longer public. See the package level documentation for more information.
Name Notes
Features ... URL prefix is
(URL)/external-general-entities Value is fixed at true
(URL)/external-parameter-entities Value is fixed at true
(URL)/namespace-prefixes Value defaults to false (but XML 1.0 names are always reported)
(URL)/namespaces Value defaults to true
(URL)/string-interning Value is fixed at true
(URL)/validation Value is fixed at false
Handler Properties ... URL prefix is
(URL)/declaration-handler A declaration handler may be provided. Declaration of general entities is exposed, but not parameter entities; none of the entity names reported here will begin with "%".
(URL)/lexical-handler A lexical handler may be provided. Entity boundaries and comments are not exposed; only CDATA sections and the start/end of the DTD (the internal subset is not detectible).

Note that the declaration handler doesn't suffice for showing all the logical structure of the DTD; it doesn't expose the name of the root element, or the values that are permitted in a NOTATIONS attribute. (The former is exposed as lexical data, and SAX2 beta doesn't expose the latter.)

Although support for several features and properties is "built in" to this parser, it support all others by storing the assigned values and returning them.

This parser currently implements the SAX1 Parser API, but it may not continue to do so in the future.

See Also:
Parser

Constructor Summary
SAXDriver()
          Constructs a SAX Parser.
 
          SAX2 Attributes method (don't invoke on parser);
          SAX1 AttributeList, SAX2 Attributes method (don't invoke on parser);
          SAX1 AttributeList, SAX2 Attributes method (don't invoke on parser);
          SAX1, SAX2: Auxiliary API to parse an XML document, used mostly when no URI is available.
          SAX2: Assigns the object used to report the logical content of an XML document.
          Deprecated. SAX2 programs should use the XMLReader interface and a ContentHandler.
          SAX1, SAX2: Set the DTD handler for this parser.
          SAX1, SAX2: Set the entity resolver for this parser.
          SAX1, SAX2: Set the error handler for this parser.
Method Summary
 int getColumnNumber()
          SAX Locator method (don't invoke on parser);
getContentHandler()
          SAX2: Returns the object used to report the logical content of an XML document.
getDTDHandler()
          SAX2: Returns the object used to process declarations related to notations and unparsed entities.
getEntityResolver()
          SAX2: Returns the object used when resolving external entities during parsing (both general and parameter entities).
getErrorHandler()
          SAX2: Returns the object used to receive callbacks for XML errors of all levels (fatal, nonfatal, warning); this is never null;
 boolean getFeature(java.lang.String featureId)
          SAX2: Tells the value of the specified feature flag.
 int
 int getIndex(java.lang.String uri, java.lang.String local)
          SAX2 Attributes method (don't invoke on parser);
 int getLength()
          SAX1 AttributeList, SAX2 Attributes method (don't invoke on parser);
 int getLineNumber()
          SAX Locator method (don't invoke on parser);
 java.lang.String getLocalName(int index)
          SAX2 Attributes method (don't invoke on parser);
 java.lang.String getName(int i)
          SAX1 AttributeList method (don't invoke on parser);
 java.lang.Object getProperty(java.lang.String propertyId)
          SAX2: Returns the specified property.
 java.lang.String getPublicId()
          SAX Locator method (don't invoke on parser);
 java.lang.String getQName(int i)
          SAX2 Attributes method (don't invoke on parser);
 java.lang.String getSystemId()
          SAX Locator method (don't invoke on parser);
 java.lang.String getType(int i)
          SAX1 AttributeList, SAX2 Attributes method (don't invoke on parser);
 java.lang.String
 java.lang.String getType(java.lang.String uri, java.lang.String local)
          SAX2 Attributes method (don't invoke on parser);
 java.lang.String getURI(int index)
          SAX2 Attributes method (don't invoke on parser);
 java.lang.String getValue(int i)
          SAX1 AttributeList, SAX2 Attributes method (don't invoke on parser);
 java.lang.String
 java.lang.String getValue(java.lang.String uri, java.lang.String local)
          SAX Attributes method (don't invoke on parser);
 void
 void parse(java.lang.String systemId)
          SAX1, SAX2: Preferred API to parse an XML document, using a system identifier (URI).
 void
 void
 void
 void
 void
 void setFeature(java.lang.String featureId, boolean state)
          SAX2: Sets the state of feature flags in this parser.
 void setLocale(java.util.Locale locale)
          SAX1: Sets the locale used for diagnostics; currently, only locales using the English language are supported.
 void setProperty(java.lang.String propertyId, java.lang.Object property)
          SAX2: Assigns the specified property.
 
Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
 

Constructor Detail

SAXDriver


public SAXDriver()
Constructs a SAX Parser.
Method Detail

setLocale


public void setLocale(java.util.Locale locale)

SAX1: Sets the locale used for diagnostics; currently, only locales using the English language are supported.
Parameters:
locale - The locale for which diagnostics will be generated

getEntityResolver



SAX2: Returns the object used when resolving external entities during parsing (both general and parameter entities).

setEntityResolver


SAX1, SAX2: Set the entity resolver for this parser.
Parameters:
handler - The object to receive entity events.

getDTDHandler



SAX2: Returns the object used to process declarations related to notations and unparsed entities.

setDTDHandler


SAX1, SAX2: Set the DTD handler for this parser.
Parameters:
handler - The object to receive DTD events.

setDocumentHandler


Deprecated. SAX2 programs should use the XMLReader interface and a ContentHandler.

SAX1: Set the document handler for this parser. If a content handler was set, this document handler will supplant it. The parser is set to report all XML 1.0 names rather than to is set to true).
Parameters:
handler - The object to receive document events.

getContentHandler



SAX2: Returns the object used to report the logical content of an XML document.

setContentHandler


SAX2: Assigns the object used to report the logical content of an XML document. If a document handler was set, this content handler will supplant it (but XML 1.0 style name reporting may remain enabled).

setErrorHandler


SAX1, SAX2: Set the error handler for this parser.
Parameters:
handler - The object to receive error events.

getErrorHandler



SAX2: Returns the object used to receive callbacks for XML errors of all levels (fatal, nonfatal, warning); this is never null;

parse

                  java.io.IOException
SAX1, SAX2: Auxiliary API to parse an XML document, used mostly when no URI is available. If you want anything useful to happen, you should set at least one type of handler.
Parameters:
source - The XML input source. Don't set 'encoding' unless and the parser normally throws SAXParseException objects.
java.io.IOException - IOExceptions are normally through through

parse


public void parse(java.lang.String systemId)
                  java.io.IOException
SAX1, SAX2: Preferred API to parse an XML document, using a system identifier (URI).

getFeature


public boolean getFeature(java.lang.String featureId)

SAX2: Tells the value of the specified feature flag.
is neither built in, nor yet assigned.

getProperty


public java.lang.Object getProperty(java.lang.String propertyId)

SAX2: Returns the specified property.
is neither built in, nor yet stored.

setFeature


public void setFeature(java.lang.String featureId,
                       boolean state)

SAX2: Sets the state of feature flags in this parser. Some built-in feature flags are mutable; all flags not built-in are motable.

setProperty


public void setProperty(java.lang.String propertyId,
                        java.lang.Object property)

SAX2: Assigns the specified property. Like SAX1 handlers, these may be changed at any time.

getLength


public int getLength()
SAX1 AttributeList, SAX2 Attributes method (don't invoke on parser);

getURI


public java.lang.String getURI(int index)
SAX2 Attributes method (don't invoke on parser);

getLocalName


public java.lang.String getLocalName(int index)
SAX2 Attributes method (don't invoke on parser);

getQName


public java.lang.String getQName(int i)
SAX2 Attributes method (don't invoke on parser);

getName


public java.lang.String getName(int i)
SAX1 AttributeList method (don't invoke on parser);

getType


public java.lang.String getType(int i)
SAX1 AttributeList, SAX2 Attributes method (don't invoke on parser);

getValue


public java.lang.String getValue(int i)
SAX1 AttributeList, SAX2 Attributes method (don't invoke on parser);

getIndex


public int getIndex(java.lang.String uri,
                    java.lang.String local)
SAX2 Attributes method (don't invoke on parser);

getIndex



SAX2 Attributes method (don't invoke on parser);

getType


public java.lang.String getType(java.lang.String uri,
                                java.lang.String local)
SAX2 Attributes method (don't invoke on parser);

getType



SAX1 AttributeList, SAX2 Attributes method (don't invoke on parser);

getValue


public java.lang.String getValue(java.lang.String uri,
                                 java.lang.String local)
SAX Attributes method (don't invoke on parser);

getValue



SAX1 AttributeList, SAX2 Attributes method (don't invoke on parser);

getPublicId


public java.lang.String getPublicId()
SAX Locator method (don't invoke on parser);

getSystemId


public java.lang.String getSystemId()
SAX Locator method (don't invoke on parser);

getLineNumber


public int getLineNumber()
SAX Locator method (don't invoke on parser);

getColumnNumber


public int getColumnNumber()
SAX Locator method (don't invoke on parser);