|
|||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | ||||||||
SUMMARY: INNER | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |
java.lang.Object | +--org.brownell.xml.aelfred2.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 |
---|---|
(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 |
(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 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.
Parser
Constructor Summary | |
SAXDriver()
Constructs a SAX Parser. |
Method Summary | |
int |
getColumnNumber()
SAX Locator method (don't invoke on parser); |
ContentHandler |
getContentHandler()
SAX2: Returns the object used to report the logical content of an XML document. |
DTDHandler |
getDTDHandler()
SAX2: Returns the object used to process declarations related to notations and unparsed entities. |
EntityResolver |
getEntityResolver()
SAX2: Returns the object used when resolving external entities during parsing (both general and parameter entities). |
ErrorHandler |
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 |
getIndex(java.lang.String xmlName)
SAX2 Attributes method (don't invoke on parser); |
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 |
getType(java.lang.String xmlName)
SAX1 AttributeList, SAX2 Attributes method (don't invoke on parser); |
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 |
getValue(java.lang.String xmlName)
SAX1 AttributeList, SAX2 Attributes method (don't invoke on parser); |
java.lang.String |
getValue(java.lang.String uri,
java.lang.String local)
SAX Attributes method (don't invoke on parser); |
void |
parse(InputSource source)
SAX1, SAX2: Auxiliary API to parse an XML document, used mostly when no URI is available. |
void |
parse(java.lang.String systemId)
SAX1, SAX2: Preferred API to parse an XML document, using a system identifier (URI). |
void |
setContentHandler(ContentHandler handler)
SAX2: Assigns the object used to report the logical content of an XML document. |
void |
setDocumentHandler(DocumentHandler handler)
Deprecated. SAX2 programs should use the XMLReader interface and a ContentHandler. |
void |
setDTDHandler(DTDHandler handler)
SAX1, SAX2: Set the DTD handler for this parser. |
void |
setEntityResolver(EntityResolver resolver)
SAX1, SAX2: Set the entity resolver for this parser. |
void |
setErrorHandler(ErrorHandler handler)
SAX1, SAX2: Set the error handler for this parser. |
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 |
public SAXDriver()
Method Detail |
public void setLocale(java.util.Locale locale) throws SAXException
locale
- The locale for which diagnostics will be generatedpublic EntityResolver getEntityResolver()
XMLReader.setEntityResolver(org.xml.sax.EntityResolver)
public void setEntityResolver(EntityResolver resolver)
handler
- The object to receive entity events.public DTDHandler getDTDHandler()
XMLReader.setDTDHandler(org.xml.sax.DTDHandler)
public void setDTDHandler(DTDHandler handler)
handler
- The object to receive DTD events.public void setDocumentHandler(DocumentHandler handler)
handler
- The object to receive document events.public ContentHandler getContentHandler()
XMLReader.setContentHandler(org.xml.sax.ContentHandler)
public void setContentHandler(ContentHandler handler)
handler
- The content handler.XMLReader.getContentHandler()
public void setErrorHandler(ErrorHandler handler)
handler
- The object to receive error events.public ErrorHandler getErrorHandler()
XMLReader.setErrorHandler(org.xml.sax.ErrorHandler)
public void parse(InputSource source) throws SAXException, java.io.IOException
source
- The XML input source. Don't set 'encoding' unless
you know for a fact that it's correct.setEntityResolver(org.xml.sax.EntityResolver)
,
setDTDHandler(org.xml.sax.DTDHandler)
,
setContentHandler(org.xml.sax.ContentHandler)
,
setErrorHandler(org.xml.sax.ErrorHandler)
public void parse(java.lang.String systemId) throws SAXException, java.io.IOException
systemId
- The system identifier (URI).XMLReader.parse(org.xml.sax.InputSource)
public boolean getFeature(java.lang.String featureId) throws SAXNotRecognizedException
public java.lang.Object getProperty(java.lang.String propertyId) throws SAXNotRecognizedException
public void setFeature(java.lang.String featureId, boolean state) throws SAXNotRecognizedException, SAXNotSupportedException
name
- The feature name, which is a fully-qualified URI.state
- The requested state of the feature (true or false).XMLReader.getFeature(java.lang.String)
public void setProperty(java.lang.String propertyId, java.lang.Object property) throws SAXNotRecognizedException, SAXNotSupportedException
name
- The property name, which is a fully-qualified URI.state
- The requested value for the property.public int getLength()
Attributes.getURI(int)
,
Attributes.getLocalName(int)
,
Attributes.getQName(int)
,
Attributes.getType(int)
,
Attributes.getValue(int)
public java.lang.String getURI(int index)
index
- The attribute index (zero-based).Attributes.getLength()
public java.lang.String getLocalName(int index)
index
- The attribute index (zero-based).Attributes.getLength()
public java.lang.String getQName(int i)
index
- The attribute index (zero-based).Attributes.getLength()
public java.lang.String getName(int i)
i
- The index of the attribute in the list (starting at 0).AttributeList.getLength()
public java.lang.String getType(int i)
index
- The attribute index (zero-based).Attributes.getLength()
public java.lang.String getValue(int i)
index
- The attribute index (zero-based).Attributes.getLength()
public int getIndex(java.lang.String uri, java.lang.String local)
uri
- The Namespace URI, or the empty string if
the name has no Namespace URI.localName
- The attribute's local name.public int getIndex(java.lang.String xmlName)
qName
- The qualified (prefixed) name.public java.lang.String getType(java.lang.String uri, java.lang.String local)
uri
- The Namespace URI, or the empty String if the
name has no Namespace URI.localName
- The local name of the attribute.public java.lang.String getType(java.lang.String xmlName)
qName
- The XML 1.0 qualified name.public java.lang.String getValue(java.lang.String uri, java.lang.String local)
uri
- The Namespace URI, or the empty String if the
name has no Namespace URI.localName
- The local name of the attribute.public java.lang.String getValue(java.lang.String xmlName)
qName
- The XML 1.0 qualified name.public java.lang.String getPublicId()
Locator.getSystemId()
public java.lang.String getSystemId()
Locator.getPublicId()
public int getLineNumber()
Locator.getColumnNumber()
public int getColumnNumber()
Locator.getLineNumber()
|
|||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | ||||||||
SUMMARY: INNER | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |