org.apache.xerces.framework
Class XMLDocumentScanner

java.lang.Object
  |
  +--org.apache.xerces.framework.XMLDocumentScanner

public final class XMLDocumentScanner

extends java.lang.Object

This class recognizes most of the grammer for an XML processor. Additional support is provided by the XMLEntityHandler, via the XMLEntityReader instances it creates, which are used to process simple constructs like string literals and character data between markup. The XMLDTDScanner class contains the remaining support for the grammer of DTD declarations. When a <!DOCTYPE ...> is found in the document, the scanDoctypeDecl method will then be called and the XMLDocumentScanner subclass is responsible for "connecting" that method to the corresponding method provided by the XMLDTDScanner class.

Version:

Inner Class Summary

static interface

XMLDocumentScanner.EventHandler This interface must be implemented by the users of the XMLDocumentScanner class.

Field Summary

static int	RESULT_DUPLICATE_ATTR
static int	RESULT_FAILURE
static int	RESULT_SUCCESS

Constructor Summary

XMLDocumentScanner(XMLDocumentScanner.EventHandler eventHandler, StringPool stringPool, XMLErrorReporter errorReporter, XMLEntityHandler entityHandler, XMLEntityHandler.CharBuffer literalData)
Constructor

Method Summary

boolean	atEndOfInput() Tell if scanner has reached end of input
void	checkXMLLangAttributeValue(int langValue) Check the value of an XML Language attribute
void	endOfInput(int entityName, boolean moreToFollow) Handle the end of input
boolean	parseSome(boolean doItAll) Entry point for parsing
void	readerChange(XMLEntityHandler.EntityReader nextReader, int nextReaderId) Change readers
void	reset(StringPool stringPool, XMLEntityHandler.CharBuffer literalData) reset the parser so that the instance can be reused
int	scanAttValue(int elementType, int attrName, boolean asSymbol) Scan an attribute value

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Field Detail

RESULT_SUCCESS

public static final int RESULT_SUCCESS

RESULT_FAILURE

public static final int RESULT_FAILURE

RESULT_DUPLICATE_ATTR

public static final int RESULT_DUPLICATE_ATTR

Constructor Detail

XMLDocumentScanner

public XMLDocumentScanner(XMLDocumentScanner.EventHandler eventHandler,
                          StringPool stringPool,
                          XMLErrorReporter errorReporter,
                          XMLEntityHandler entityHandler,
                          XMLEntityHandler.CharBuffer literalData)

Constructor

Method Detail

reset

public void reset(StringPool stringPool,
                  XMLEntityHandler.CharBuffer literalData)
           throws java.lang.Exception

reset the parser so that the instance can be reused

Parameters:

stringPool - the string pool instance to be used by the reset parser

parseSome

public boolean parseSome(boolean doItAll)
                  throws java.lang.Exception

Entry point for parsing

Parameters:

doItAll - if true the entire document is parsed otherwise just the next segment of the document is parsed

readerChange

public void readerChange(XMLEntityHandler.EntityReader nextReader,
                         int nextReaderId)
                  throws java.lang.Exception

Change readers

Parameters:

nextReader - the new reader that the scanner will use

nextReaderId - id of the reader to change to

Throws:

throws - java.lang.Exception

endOfInput

public void endOfInput(int entityName,
                       boolean moreToFollow)
                throws java.lang.Exception

Handle the end of input

Parameters:

entityName - the handle in the string pool of the name of the entity which has reached end of input

moreToFollow - if true, there is still input left to process in other readers

Throws:

java.lang.Exception -

atEndOfInput

public boolean atEndOfInput()

Tell if scanner has reached end of input

Returns:

true if scanner has reached end of input.

scanAttValue

public int scanAttValue(int elementType,
                        int attrName,
                        boolean asSymbol)
                 throws java.lang.Exception

Scan an attribute value

Parameters:

elementType - handle to the element whose attribute value is being scanned

attrName - handle in the string pool of the name of attribute being scanned

asSymbol - controls whether the value is a string (duplicates allowed) or a symbol (duplicates not allowed)

Returns:

handle in the string pool of the scanned value

Throws:

java.lang.Exception -

checkXMLLangAttributeValue

public void checkXMLLangAttributeValue(int langValue)
                                throws java.lang.Exception

Check the value of an XML Language attribute

Parameters:

langValue - the handle in the string pool of the value to be checked

Throws:

java.lang.Exception -