BEA Systems, Inc.

BEA WebLogic Server 9.0 API Reference


weblogic.apache.xerces.xni.parser
Interface XMLPullParserConfiguration

All Superinterfaces:
XMLComponentManager, XMLParserConfiguration
All Known Implementing Classes:
DTDConfiguration, NonValidatingConfiguration

Deprecated. please use JDK supplied XML parsers and transformers

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.


Method Summary
 void cleanup()
          Deprecated. If the application decides to terminate parsing before the xml document is fully parsed, the application should call this method to free any resource allocated during parsing.
 boolean parse(boolean complete)
          Deprecated. Parses the document in a pull parsing fashion.
 void setInputSource(XMLInputSource inputSource)
          Deprecated. Sets the input source for the document to parse.
 
Methods inherited from interface weblogic.apache.xerces.xni.parser.XMLParserConfiguration
addRecognizedFeatures, addRecognizedProperties, getDocumentHandler, getDTDContentModelHandler, getDTDHandler, getEntityResolver, getErrorHandler, getFeature, getLocale, getProperty, parse, setDocumentHandler, setDTDContentModelHandler, setDTDHandler, setEntityResolver, setErrorHandler, setFeature, setLocale, setProperty
 

Method Detail

cleanup

public void cleanup()
Deprecated. 
If the application decides to terminate parsing before the xml document is fully parsed, the application should call this method to free any resource allocated during parsing. For example, close all opened streams.


parse

public boolean parse(boolean complete)
              throws XNIException,
                     IOException
Deprecated. 
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.
IOException - An IO exception from the parser, possibly from a byte stream or character stream supplied by the parser.
See Also:
setInputSource(weblogic.apache.xerces.xni.parser.XMLInputSource)

setInputSource

public void setInputSource(XMLInputSource inputSource)
                    throws XMLConfigurationException,
                           IOException
Deprecated. 
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.
IOException - Thrown on I/O error.
See Also:
parse(boolean)

Documentation is available at
http://download.oracle.com/docs/cd/E13222_01/wls/docs90
Copyright 2005 BEA Systems Inc.