|
|||||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | ||||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |
java.lang.Object | +--org.enhydra.apache.xerces.framework.XMLParser | +--org.enhydra.apache.xerces.parsers.SAXParser
SAXParser provides a parser which implements the SAX1 and SAX2 parser APIs.
Nested Class Summary |
Nested classes inherited from class org.enhydra.apache.xerces.framework.XMLDocumentHandler |
XMLDocumentHandler.DTDHandler |
Field Summary |
Fields inherited from class org.enhydra.apache.xerces.framework.XMLParser |
fEntityHandler, fErrorReporter, fGrammarResolver, fParseInProgress, fScanner, fStringPool, fValidator, SAX2_FEATURES_PREFIX, SAX2_PROPERTIES_PREFIX, XERCES_FEATURES_PREFIX, XERCES_PROPERTIES_PREFIX |
Fields inherited from interface org.enhydra.apache.xerces.framework.XMLErrorReporter |
ERRORTYPE_FATAL_ERROR, ERRORTYPE_RECOVERABLE_ERROR, ERRORTYPE_WARNING |
Constructor Summary | |
|
SAXParser()
Default constructor. |
protected |
SAXParser(StringPool stringPool)
|
Method Summary | |
void |
attlistDecl(QName elementDecl,
QName attributeDecl,
int attType,
boolean attList,
String enumString,
int attDefaultType,
int attDefaultValue)
Report an attribute type declaration. |
void |
characters(char[] ch,
int start,
int length)
Characters. |
void |
characters(int dataIndex)
Not called. |
void |
comment(int dataIndex)
Comment. |
void |
elementDecl(QName elementDecl,
int contentSpecType,
int contentSpecIndex,
XMLContentSpec.Provider contentSpecProvider)
Report an element type declaration. |
void |
endCDATA()
End CDATA section. |
void |
endDocument()
End document. |
void |
endDTD()
This function will be called at the end of the DTD. |
void |
endElement(QName element)
End element. |
void |
endEntityReference(int entityName,
int entityType,
int entityContext)
End entity reference. |
void |
endNamespaceDeclScope(int prefix)
Report the end of the scope of a namespace declaration. |
void |
externalEntityDecl(int entityName,
int publicId,
int systemId)
Report a parsed external general entity declaration. |
void |
externalPEDecl(int entityName,
int publicId,
int systemId)
Report a parsed external parameter entity declaration. |
ContentHandler |
getContentHandler()
Return the current content handler. |
protected DeclHandler |
getDeclHandler()
Returns the DTD declaration event handler. |
DTDHandler |
getDTDHandler()
Return the current DTD handler. |
boolean |
getFeature(String featureId)
Query the state of a feature. |
String[] |
getFeaturesRecognized()
Returns a list of features that this parser recognizes. |
protected LexicalHandler |
getLexicalHandler()
Returns the lexical handler. |
protected boolean |
getNamespacePrefixes()
Returns the http://xml.org/features/namespace-prefixes value. |
String[] |
getPropertiesRecognized()
Returns a list of properties that this parser recognizes. |
Object |
getProperty(String propertyId)
Query the value of a property. |
void |
ignorableWhitespace(char[] ch,
int start,
int length)
Ignorable whitespace. |
void |
ignorableWhitespace(int dataIndex)
Not called. |
void |
internalEntityDecl(int entityName,
int entityValue)
Report an internal general entity declaration. |
void |
internalPEDecl(int entityName,
int entityValue)
Report an internal parameter entity declaration. |
void |
internalSubset(int internalSubset)
New callback from DOM Level 2. |
void |
notationDecl(int notationName,
int publicId,
int systemId)
Receive notification of a notation declaration event. |
void |
processingInstruction(int piTarget,
int piData)
Processing instruction. |
void |
setContentHandler(ContentHandler handler)
Allow an application to register a content event handler. |
protected void |
setDeclHandler(DeclHandler handler)
Set the DTD declaration event handler. |
void |
setDocumentHandler(DocumentHandler handler)
Sets the document handler. |
void |
setDTDHandler(DTDHandler handler)
Allow an application to register a DTD event handler. |
void |
setFeature(String featureId,
boolean state)
Set the state of any feature in a SAX2 parser. |
protected void |
setLexicalHandler(LexicalHandler handler)
Set the lexical event handler. |
protected void |
setNamespacePrefixes(boolean process)
Sets how the parser reports raw prefixed names, and whether xmlns attributes are reported. |
void |
setProperty(String propertyId,
Object value)
Set the value of any property in a SAX2 parser. |
void |
startCDATA()
Start CDATA section. |
void |
startDocument()
Start document. |
void |
startDTD(QName rootElement,
int publicId,
int systemId)
This function will be called when a <! |
void |
startElement(QName element,
XMLAttrList attrList,
int attrListIndex)
Start element |
void |
startEntityReference(int entityName,
int entityType,
int entityContext)
Start entity reference. |
void |
startNamespaceDeclScope(int prefix,
int uri)
Report the start of the scope of a namespace declaration. |
void |
textDecl(int versionIndex,
int encodingIndex)
Text declaration. |
void |
unparsedEntityDecl(int entityName,
int publicId,
int systemId,
int notationName)
Receive notification of an unparsed entity declaration event. |
void |
xmlDecl(int versionIndex,
int encodingIndex,
int standaloneIndex)
XML declaration. |
Methods inherited from class java.lang.Object |
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait |
Methods inherited from interface org.xml.sax.Parser |
parse, parse, setEntityResolver, setErrorHandler, setLocale |
Methods inherited from interface org.xml.sax.XMLReader |
getEntityResolver, getErrorHandler, parse, parse, setEntityResolver, setErrorHandler |
Constructor Detail |
public SAXParser()
protected SAXParser(StringPool stringPool)
Method Detail |
public String[] getFeaturesRecognized()
getFeaturesRecognized
in class XMLParser
XMLParser.isFeatureRecognized(java.lang.String)
,
setFeature(java.lang.String, boolean)
,
getFeature(java.lang.String)
public String[] getPropertiesRecognized()
getPropertiesRecognized
in class XMLParser
XMLParser.isPropertyRecognized(java.lang.String)
,
setProperty(java.lang.String, java.lang.Object)
,
getProperty(java.lang.String)
protected void setDeclHandler(DeclHandler handler) throws SAXNotRecognizedException, SAXNotSupportedException
This method is the equivalent to the property:
http://xml.org/sax/properties/declaration-handler
handler
- The new handler.
SAXNotRecognizedException
SAXNotSupportedException
getDeclHandler()
,
setProperty(java.lang.String, java.lang.Object)
protected DeclHandler getDeclHandler() throws SAXNotRecognizedException, SAXNotSupportedException
SAXNotRecognizedException
SAXNotSupportedException
setDeclHandler(org.xml.sax.ext.DeclHandler)
protected void setLexicalHandler(LexicalHandler handler) throws SAXNotRecognizedException, SAXNotSupportedException
This method is the equivalent to the property:
http://xml.org/sax/properties/lexical-handler
handler
- lexical event handler
SAXNotRecognizedException
SAXNotSupportedException
getLexicalHandler()
,
setProperty(java.lang.String, java.lang.Object)
protected LexicalHandler getLexicalHandler() throws SAXNotRecognizedException, SAXNotSupportedException
SAXNotRecognizedException
SAXNotSupportedException
setLexicalHandler(org.xml.sax.ext.LexicalHandler)
public void setDocumentHandler(DocumentHandler handler)
setDocumentHandler
in interface Parser
public void setDTDHandler(DTDHandler handler)
If the application does not register a DTD handler, all DTD events reported by the SAX parser will be silently ignored.
Applications may register a new or different handler in the middle of a parse, and the SAX parser must begin using the new handler immediately.
setDTDHandler
in interface Parser
handler
- The DTD handler.
NullPointerException
- If the handler
argument is null.getDTDHandler()
public DTDHandler getDTDHandler()
getDTDHandler
in interface XMLReader
setDTDHandler(org.xml.sax.DTDHandler)
protected void setNamespacePrefixes(boolean process) throws SAXNotRecognizedException, SAXNotSupportedException
This method is the equivalent to the feature:
http://xml.org/sax/features/namespaces-prefixes
process
- True to process namespaces; false to not process.
SAXNotRecognizedException
SAXNotSupportedException
XMLParser.getNamespaces()
,
setFeature(java.lang.String, boolean)
protected boolean getNamespacePrefixes() throws SAXNotRecognizedException, SAXNotSupportedException
SAXNotRecognizedException
SAXNotSupportedException
setNamespacePrefixes(boolean)
public void setFeature(String featureId, boolean state) throws SAXNotRecognizedException, SAXNotSupportedException
setFeature
in interface XMLReader
setFeature
in class XMLParser
featureId
- The unique identifier (URI) of the feature.state
- The requested state of the feature (true or false).
SAXNotRecognizedException
- If the
requested feature is not known.
SAXNotSupportedException
- If the
requested feature is known, but the requested
state is not supported.public boolean getFeature(String featureId) throws SAXNotRecognizedException, SAXNotSupportedException
getFeature
in interface XMLReader
getFeature
in class XMLParser
featureId
- The unique identifier (URI) of the feature
being set.
SAXNotRecognizedException
- If the
requested feature is not known.
SAXNotSupportedException
- If the
requested feature is known but not supported.public void setProperty(String propertyId, Object value) throws SAXNotRecognizedException, SAXNotSupportedException
setProperty
in interface XMLReader
setProperty
in class XMLParser
propertyId
- The unique identifier (URI) of the property
being set.
SAXNotRecognizedException
- If the
requested property is not known.
SAXNotSupportedException
- If the
requested property is known, but the requested
value is not supported.public Object getProperty(String propertyId) throws SAXNotRecognizedException, SAXNotSupportedException
getProperty
in interface XMLReader
getProperty
in class XMLParser
propertyId
- The unique identifier (URI) of the property
being set.
SAXNotRecognizedException
- If the
requested property is not known.
SAXNotSupportedException
- If the
requested property is known but not supported.XMLReader.getProperty(java.lang.String)
public void setContentHandler(ContentHandler handler)
If the application does not register a content handler, all content events reported by the SAX parser will be silently ignored.
Applications may register a new or different handler in the middle of a parse, and the SAX parser must begin using the new handler immediately.
setContentHandler
in interface XMLReader
handler
- The content handler.
NullPointerException
- If the handler
argument is null.getContentHandler()
public ContentHandler getContentHandler()
getContentHandler
in interface XMLReader
setContentHandler(org.xml.sax.ContentHandler)
public void startDTD(QName rootElement, int publicId, int systemId) throws Exception
startDTD
in interface XMLDocumentHandler.DTDHandler
publicId
- string pool index of the DTD's public IDsystemId
- string pool index of the DTD's system ID
Exception
public void endDTD() throws Exception
endDTD
in interface XMLDocumentHandler.DTDHandler
Exception
public void elementDecl(QName elementDecl, int contentSpecType, int contentSpecIndex, XMLContentSpec.Provider contentSpecProvider) throws Exception
elementDecl
in interface XMLDocumentHandler.DTDHandler
SAXException
- The application may raise an exception.
Exception
XMLContentSpec
public void attlistDecl(QName elementDecl, QName attributeDecl, int attType, boolean attList, String enumString, int attDefaultType, int attDefaultValue) throws Exception
attlistDecl
in interface XMLDocumentHandler.DTDHandler
attType
- type of attributeenumString
- String representing the values of the enumeration,
if the attribute is of enumerated type, or null if it is not.attDefaultType
- an integer value denoting the DefaultDecl valueattDefaultValue
- string pool index of this attribute's default value
or -1 if there is no defaultvalue
SAXException
- The application may raise an exception.
Exception
public void internalPEDecl(int entityName, int entityValue) throws Exception
internalPEDecl
in interface XMLDocumentHandler.DTDHandler
entityName
- string pool index of the entity nameentityValue
- string pool index of the entity replacement text
Exception
public void externalPEDecl(int entityName, int publicId, int systemId) throws Exception
externalPEDecl
in interface XMLDocumentHandler.DTDHandler
entityName
- string pool index of the entity namepublicId
- string pool index of the entity's public id.systemId
- string pool index of the entity's system id.
Exception
public void internalEntityDecl(int entityName, int entityValue) throws Exception
internalEntityDecl
in interface XMLDocumentHandler.DTDHandler
entityName
- string pool index of the entity nameentityValue
- string pool index of the entity replacement text
Exception
public void externalEntityDecl(int entityName, int publicId, int systemId) throws Exception
externalEntityDecl
in interface XMLDocumentHandler.DTDHandler
entityName
- string pool index of the entity namepublicId
- string pool index of the entity's public id.systemId
- string pool index of the entity's system id.
Exception
public void unparsedEntityDecl(int entityName, int publicId, int systemId, int notationName) throws Exception
unparsedEntityDecl
in interface XMLDocumentHandler.DTDHandler
entityName
- string pool index of the entity namepublicId
- string pool index of the entity's public id.systemId
- string pool index of the entity's system id.notationName
- string pool index of the notation name.
Exception
public void notationDecl(int notationName, int publicId, int systemId) throws Exception
notationDecl
in interface XMLDocumentHandler.DTDHandler
notationName
- string pool index of the notation namepublicId
- string pool index of the notation's public id.systemId
- string pool index of the notation's system id.
Exception
public void startDocument() throws Exception
startDocument
in interface XMLDocumentHandler
Exception
public void endDocument() throws Exception
endDocument
in interface XMLDocumentHandler
Exception
public void xmlDecl(int versionIndex, int encodingIndex, int standaloneIndex) throws Exception
xmlDecl
in interface XMLDocumentHandler
versionIndex
- the handle in the string pool for the version numberencodingIndex
- the handle in the string pool for the encoding
Exception
public void textDecl(int versionIndex, int encodingIndex) throws Exception
textDecl
in interface XMLDocumentHandler
Exception
public void startNamespaceDeclScope(int prefix, int uri) throws Exception
startNamespaceDeclScope
in interface XMLDocumentHandler
prefix
- string pool index of the namespace prefix being declareduri
- string pool index of the namespace uri begin bound
Exception
public void endNamespaceDeclScope(int prefix) throws Exception
endNamespaceDeclScope
in interface XMLDocumentHandler
prefix
- string pool index of the namespace prefix being declared
Exception
public void internalSubset(int internalSubset)
internalSubset
in interface XMLDocumentHandler.DTDHandler
public void startElement(QName element, XMLAttrList attrList, int attrListIndex) throws Exception
startElement
in interface XMLDocumentHandler
attrList
- attrList containing the attributes of the elementattrListIndex
- handle into attrList. Allows attributes to be retreived.
Exception
public void endElement(QName element) throws Exception
endElement
in interface XMLDocumentHandler
Exception
public void startEntityReference(int entityName, int entityType, int entityContext) throws Exception
startEntityReference
in interface XMLDocumentHandler
entityName
- string pool index of the entity nameentityType
- the XMLEntityHandler.ENTITYTYPE_* typeentityContext
- the XMLEntityHandler.ENTITYREF_* type for where
the entity reference appears
Exception
XMLEntityHandler
,
XMLEntityHandler
public void endEntityReference(int entityName, int entityType, int entityContext) throws Exception
endEntityReference
in interface XMLDocumentHandler
entityName
- string pool index of the entity anementityType
- the XMLEntityHandler.ENTITYTYPE_* typeentityContext
- the XMLEntityHandler.ENTITYREF_* type for where
the entity reference appears
Exception
XMLEntityHandler
,
XMLEntityHandler
public void startCDATA() throws Exception
startCDATA
in interface XMLDocumentHandler
Exception
public void endCDATA() throws Exception
endCDATA
in interface XMLDocumentHandler
Exception
public void characters(int dataIndex) throws Exception
characters
in interface XMLDocumentHandler
dataIndex
- string pool index of the characters that were scanned
Exception
public void ignorableWhitespace(int dataIndex) throws Exception
ignorableWhitespace
in interface XMLDocumentHandler
dataIndex
- string pool index of ignorable whitespace
Exception
public void processingInstruction(int piTarget, int piData) throws Exception
processingInstruction
in interface XMLDocumentHandler
piTarget
- string pool index of the PI targetpiData
- string pool index of the PI data
Exception
public void comment(int dataIndex) throws Exception
comment
in interface XMLDocumentHandler
dataIndex
- string pool index of the comment text
Exception
public void characters(char[] ch, int start, int length) throws Exception
characters
in interface XMLDocumentHandler
ch
- character array containing the characters that were scannedstart
- offset in ch where scanned characters beginlength
- length of scanned characters in ch
Exception
public void ignorableWhitespace(char[] ch, int start, int length) throws Exception
ignorableWhitespace
in interface XMLDocumentHandler
ch
- character array containing the whitespace that was scannedstart
- offset in ch where scanned whitespace beginslength
- length of scanned whitespace in ch
Exception
|
|||||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | ||||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |