org.apache.xerces.xni.parser
Interface XMLPullParserConfiguration
- public interface XMLPullParserConfiguration
- extends XMLParserConfiguration
Represents a parser configuration that can be used as the
configuration for a "pull" parser. A pull parser allows the
application to drive the parser instead of having document
information events "pushed" to the registered handlers.
A pull parser using this type of configuration first calls
the setInputSource
method. After the input
source is set, the pull parser repeatedly calls the
parse(boolean):boolean
method. This method
returns a value of true if there is more to parse in the
document.
Calling the parse(XMLInputSource)
is equivalent
to setting the input source and calling the
parse(boolean):boolean
method with a "complete"
value of true
.
- Version:
- $Id: XMLPullParserConfiguration.java,v 1.2 2001/08/23 00:35:37 lehors Exp $
- Author:
- Andy Clark, IBM
Method Summary |
boolean |
parse(boolean complete)
Parses the document in a pull parsing fashion. |
void |
setInputSource(XMLInputSource inputSource)
Sets the input source for the document to parse. |
Methods inherited from interface org.apache.xerces.xni.parser.XMLParserConfiguration |
addRecognizedFeatures,
addRecognizedProperties,
getFeature,
getProperty,
parse,
setDocumentHandler,
setDTDContentModelHandler,
setDTDHandler,
setEntityResolver,
setErrorHandler,
setFeature,
setLocale,
setProperty |
setInputSource
public void setInputSource(XMLInputSource inputSource)
throws XMLConfigurationException,
java.io.IOException
- Sets the input source for the document to parse.
- Parameters:
inputSource
- The document's input source.- Throws:
- XMLConfigurationException - Thrown if there is a
configuration error when initializing the
parser.
- java.io.IOException - Thrown on I/O error.
- See Also:
parse(boolean)
parse
public boolean parse(boolean complete)
throws XNIException,
java.io.IOException
- Parses the document in a pull parsing fashion.
- Parameters:
complete
- True if the pull parser should parse the
remaining document completely.- Throws:
- XNIException - Any XNI 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 parser.
- See Also:
setInputSource(org.apache.xerces.xni.parser.XMLInputSource)
Copyright © 1999-2001 Apache XML Project. All Rights Reserved.