|
|||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | ||||||||
SUMMARY: INNER | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |
java.lang.Object | +--org.brownell.xml.aelfred2.Validator
This SAX2 parser layers a validation component over the standards-enhanced SAX2 version of Ælfred. While it can't evaluate every XML validity constraint, it does support all the validity constraints that seem to be of any substantial utility outside the strict SGML-compatible world.
See the documentation for the SAXDriver class for information about the SAX2 features and properties supported; the only difference between these two classes is that this one supports validation (which feature value is currently immutable, though that could easily change).
Note that due to its internal construction, you can't change any handlers except the ErrorHandler and the EntityResolver until parse() returns. This diverges from SAX, which specifies later binding for handlers. Early binding involves less runtime overhead, which is an issue for composite objects such as this. Rather than relying on the parser to perform late binding to your own handlers, do it yourself.
SAXDriver
,
ValidationConsumer
Constructor Summary | |
Validator()
Constructs a SAX Parser. |
|
Validator(boolean invalidIsFatal)
Constructs a SAX Parser, optionally treating validity errors as if they were fatal errors. |
Method Summary | |
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 whether this parser supports the specified feature. |
java.lang.Object |
getProperty(java.lang.String propertyId)
SAX2: Returns the specified property. |
void |
parse(InputSource source)
SAX1: Auxiliary API to parse an XML document, used mostly when no URI is available. |
void |
parse(java.lang.String systemId)
SAX1: 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 |
setDTDHandler(DTDHandler handler)
SAX1 Assigns DTD handler |
void |
setEntityResolver(EntityResolver handler)
SAX1 Assigns parser's entity resolver |
void |
setErrorHandler(ErrorHandler handler)
SAX1 Assigns error handler |
void |
setFeature(java.lang.String featureId,
boolean state)
SAX2: Sets the state of features supported 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 value)
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 Validator()
public Validator(boolean invalidIsFatal)
Method Detail |
public ContentHandler getContentHandler()
XMLReader.setContentHandler(org.xml.sax.ContentHandler)
public void setContentHandler(ContentHandler handler)
handler
- The content handler.XMLReader.getContentHandler()
public DTDHandler getDTDHandler()
XMLReader.setDTDHandler(org.xml.sax.DTDHandler)
public void setDTDHandler(DTDHandler handler)
handler
- The DTD handler.XMLReader.getDTDHandler()
public EntityResolver getEntityResolver()
XMLReader.setEntityResolver(org.xml.sax.EntityResolver)
public void setEntityResolver(EntityResolver handler)
resolver
- The entity resolver.XMLReader.getEntityResolver()
public ErrorHandler getErrorHandler()
XMLReader.setErrorHandler(org.xml.sax.ErrorHandler)
public void setErrorHandler(ErrorHandler handler)
handler
- The error handler.XMLReader.getErrorHandler()
public void setProperty(java.lang.String propertyId, java.lang.Object value) throws SAXNotRecognizedException, SAXNotSupportedException
name
- The property name, which is a fully-qualified URI.state
- The requested value for the property.public java.lang.Object getProperty(java.lang.String propertyId) throws SAXNotRecognizedException
name
- The property name, which is a fully-qualified URI.XMLReader.setProperty(java.lang.String, java.lang.Object)
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 boolean getFeature(java.lang.String featureId) throws SAXNotRecognizedException
SAXDriver
public void setLocale(java.util.Locale locale) throws SAXException
locale
- The locale for which diagnostics will be generatedpublic void parse(java.lang.String systemId) throws SAXException, java.io.IOException
systemId
- The system identifier (URI).XMLReader.parse(org.xml.sax.InputSource)
public void parse(InputSource source) throws SAXException, java.io.IOException
source
- The XML input source.
|
|||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | ||||||||
SUMMARY: INNER | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |