org.apache.xml.dtm.ref
Class IncrementalSAXSource_Xerces
java.lang.Object
org.apache.xml.dtm.ref.IncrementalSAXSource_Xerces
- IncrementalSAXSource
public class IncrementalSAXSource_Xerces
extends java.lang.Object
IncrementalSAXSource_Xerces takes advantage of the fact that Xerces1
incremental mode is already a coroutine of sorts, and just wraps our
IncrementalSAXSource API around it.
Usage example: See main().
Status: Passes simple main() unit-test. NEEDS JAVADOC.
IncrementalSAXSource_Xerces
public IncrementalSAXSource_Xerces()
throws NoSuchMethodException
Create a IncrementalSAXSource_Xerces, and create a SAXParser
to go with it. Xerces2 incremental parsing is only supported if
this constructor is used, due to limitations in the Xerces2 API (as of
Beta 3). If you don't like that restriction, tell the Xerces folks that
there should be a simpler way to request incremental SAX parsing.
IncrementalSAXSource_Xerces
public IncrementalSAXSource_Xerces(SAXParser parser)
throws NoSuchMethodException
Create a IncrementalSAXSource_Xerces wrapped around
an existing SAXParser. Currently this works only for recent
releases of Xerces-1. Xerces-2 incremental is currently possible
only if we are allowed to create the parser instance, due to
limitations in the API exposed by Xerces-2 Beta 3; see the
no-args constructor for that code.
createIncrementalSAXSource
public static IncrementalSAXSource createIncrementalSAXSource(SAXParser parser)
deliverMoreNodes
public Object deliverMoreNodes(boolean parsemore)
deliverMoreNodes() is a simple API which tells the coroutine
parser that we need more nodes. This is intended to be called
from one of our partner routines, and serves to encapsulate the
details of how incremental parsing has been achieved.
- deliverMoreNodes in interface IncrementalSAXSource
parsemore
- If true, tells the incremental parser to generate
another chunk of output. If false, tells the parser that we're
satisfied and it can terminate parsing of this document.
- Boolean.TRUE if the CoroutineParser believes more data may be available
for further parsing. Boolean.FALSE if parsing ran to completion.
Exception if the parser objected for some reason.
main
public static void main(args[] )
Simple unit test. Attempt coroutine parsing of document indicated
by first argument (as a URI), report progress.
setContentHandler
public void setContentHandler(org.xml.sax.ContentHandler handler)
startParse
public void startParse(InputSource source)
throws SAXException
startParse() is a simple API which tells the IncrementalSAXSource
to begin reading a document.
- startParse in interface IncrementalSAXSource
Copyright B) 2005 Apache XML Project. All Rights Reserved.