Interface XMLDocumentScanner

All Superinterfaces:

XMLDocumentSource

All Known Implementing Classes:

HTMLScanner

public interface XMLDocumentScanner
extends XMLDocumentSource

This interface defines a generic document scanner. This interface allows a scanner to be used interchangably in existing parser configurations.

If the parser configuration uses a document scanner that implements this interface, components should be able to query the scanner instance from the component manager using the following property identifier:

"http://apache.org/xml/properties/internal/document-scanner"

Method Summary

Modifier and Type	Method	Description
boolean	scanDocument(boolean complete)	Scans a document.
void	setInputSource(XMLInputSource inputSource)	Sets the input source.

Methods inherited from interface XMLDocumentSource

getDocumentHandler, setDocumentHandler

Method Details

setInputSource

void setInputSource(XMLInputSource inputSource)
             throws IOException

Sets the input source.

Parameters:

inputSource - The input source.

Throws:

IOException - Thrown on i/o error.

scanDocument

boolean scanDocument(boolean complete)
              throws IOException,
XNIException

Scans a document.

Parameters:

complete - True if the scanner should scan the document completely, pushing all events to the registered document handler. A value of false indicates that that the scanner should only scan the next portion of the document and return. A scanner instance is permitted to completely scan a document if it does not support this "pull" scanning model.

Returns:

True if there is more to scan, false otherwise.

Throws:

IOException - Thrown on i/o error.

XNIException - on error.