com.sun.xml.fastinfoset.sax

Class SAXDocumentParser

java.lang.Object

com.sun.xml.fastinfoset.Decoder

com.sun.xml.fastinfoset.sax.SAXDocumentParser

All Implemented Interfaces:

FastInfosetParser, FastInfosetReader, XMLReader

public class SAXDocumentParser
extends Decoder
implements FastInfosetReader

The Fast Infoset SAX parser.

Instantiate this parser to parse a fast infoset document in accordance with the SAX API.

More than one fast infoset document may be decoded from the InputStream.

Nested Class Summary

Nested classes/interfaces inherited from class com.sun.xml.fastinfoset.Decoder

Decoder.EncodingAlgorithmInputStream

Field Summary

Fields

Modifier and Type	Field and Description
protected EncodingAlgorithmContentHandler	_algorithmHandler
protected AttributesHolder	_attributes
protected boolean	_clearAttributes
protected ContentHandler	_contentHandler Reference to content handler.
protected DeclHandler	_declHandler Reference to DTD declaration handler.
protected DTDHandler	_dtdHandler Reference to dtd handler.
protected EntityResolver	_entityResolver Reference to entity resolver.
protected ErrorHandler	_errorHandler Reference to error handler.
protected LexicalHandler	_lexicalHandler Reference to lexical handler.
protected int[]	_namespacePrefixes
protected boolean	_namespacePrefixesFeature SAX Namespace attributes features
protected int	_namespacePrefixesIndex
protected PrimitiveTypeContentHandler	_primitiveHandler
protected BuiltInEncodingAlgorithmState	builtInAlgorithmState

Fields inherited from class com.sun.xml.fastinfoset.Decoder

_addToTable, _attributeNameTable, _attributeValueTable, _b, _bufferSize, _characterContentChunkTable, _charBuffer, _charBufferLength, _doubleTerminate, _duplicateAttributeVerifier, _elementNameTable, _identifier, _integer, _namespaceNameIndex, _needForceStreamClose, _notations, _octetBuffer, _octetBufferEnd, _octetBufferLength, _octetBufferOffset, _octetBufferStart, _parseFragments, _prefixIndex, _prefixTable, _registeredEncodingAlgorithms, _terminate, _unparsedEntities, _v, BUFFER_SIZE_SYSTEM_PROPERTY, NISTRING_EMPTY_STRING, NISTRING_ENCODING_ALGORITHM, NISTRING_INDEX, NISTRING_STRING, STRING_INTERNING_SYSTEM_PROPERTY

Fields inherited from interface org.jvnet.fastinfoset.sax.FastInfosetReader

ENCODING_ALGORITHM_CONTENT_HANDLER_PROPERTY, PRIMITIVE_TYPE_CONTENT_HANDLER_PROPERTY

Fields inherited from interface org.jvnet.fastinfoset.FastInfosetParser

BUFFER_SIZE_PROPERTY, EXTERNAL_VOCABULARIES_PROPERTY, FORCE_STREAM_CLOSE_PROPERTY, REGISTERED_ENCODING_ALGORITHMS_PROPERTY, STRING_INTERNING_PROPERTY

Constructor Summary

Constructors

Constructor and Description
SAXDocumentParser() Creates a new instance of DocumetParser2

Method Summary

Methods

Modifier and Type	Method and Description
ContentHandler	getContentHandler()
DeclHandler	getDeclHandler() Return the current DTD declaration handler.
DTDHandler	getDTDHandler()
EncodingAlgorithmContentHandler	getEncodingAlgorithmContentHandler() Return the current encoding algorithm handler.
EntityResolver	getEntityResolver()
ErrorHandler	getErrorHandler()
boolean	getFeature(String name)
LexicalHandler	getLexicalHandler() Return the current lexical handler.
PrimitiveTypeContentHandler	getPrimitiveTypeContentHandler() Return the current primitive type handler.
Object	getProperty(String name)
void	parse()
void	parse(InputSource input)
void	parse(InputStream s) Parse a fast infoset document from an InputStream.
void	parse(String systemId)
protected void	processAIIEncodingAlgorithm(QualifiedName name, boolean addToTable)
protected void	processAIIs()
protected void	processBuiltInEncodingAlgorithmAsCharacters(StringBuffer buffer)
protected Object	processBuiltInEncodingAlgorithmAsObject()
protected void	processCIIBuiltInEncodingAlgorithmAsPrimitive()
protected void	processCIIEncodingAlgorithm(boolean addToTable)
protected void	processCommentII()
protected void	processDII()
protected void	processDIIFragment()
protected void	processDIIOptionalProperties()
protected void	processEII(QualifiedName name, boolean hasAttributes)
protected void	processEIIWithNamespaces()
protected void	processProcessingII()
protected void	resetOnError()
void	setContentHandler(ContentHandler handler)
void	setDeclHandler(DeclHandler handler) Allow an application to register a DTD declaration handler.
void	setDTDHandler(DTDHandler handler)
void	setEncodingAlgorithmContentHandler(EncodingAlgorithmContentHandler handler) Allow an application to register an encoding algorithm handler.
void	setEntityResolver(EntityResolver resolver)
void	setErrorHandler(ErrorHandler handler)
void	setFeature(String name, boolean value)
void	setLexicalHandler(LexicalHandler handler) Allow an application to register a lexical handler.
void	setPrimitiveTypeContentHandler(PrimitiveTypeContentHandler handler) Allow an application to register a primitive type handler.
void	setProperty(String name, Object value)

Methods inherited from class com.sun.xml.fastinfoset.Decoder

_isFastInfosetDocument, closeIfRequired, createQualifiedNameString, createQualifiedNameString, decodeAdditionalData, decodeAlphabetOctetsAsCharBuffer, decodeCharacterEncodingScheme, decodeDII, decodeEIIIndexLarge, decodeEIIIndexMedium, decodeFourBitAlphabetOctetsAsCharBuffer, decodeHeader, decodeIdentifyingNonEmptyStringIndexOnFirstBitAsNamespaceName, decodeIdentifyingNonEmptyStringIndexOnFirstBitAsPrefix, decodeIdentifyingNonEmptyStringOnFirstBit, decodeIdentifyingNonEmptyStringOnFirstBitAsNamespaceName, decodeIdentifyingNonEmptyStringOnFirstBitAsPrefix, decodeInitialVocabulary, decodeIntegerIndexOnSecondBit, decodeLiteralQualifiedName, decodeNonEmptyOctetStringLengthOnSecondBit, decodeNonEmptyOctetStringOnSecondBitAsUtf8CharArray, decodeNonEmptyOctetStringOnSecondBitAsUtf8String, decodeNonIdentifyingStringOnFirstBit, decodeNotations, decodeOctetsOnFifthBitOfNonIdentifyingStringOnFirstBit, decodeOctetsOnSeventhBitOfNonIdentifyingStringOnThirdBit, decodeRAOctetsAsString, decodeRestrictedAlphabetAsCharBuffer, decodeRestrictedAlphabetAsString, decodeUnparsedEntities, decodeUtf16StringAsCharBuffer, decodeUtf16StringAsString, decodeUtf8NCNameIntoCharBuffer, decodeUtf8StringAsCharBuffer, decodeUtf8StringAsCharBuffer, decodeUtf8StringAsString, decodeUtf8StringIntoCharBuffer, decodeUtf8StringIntoCharBuffer, decodeVersion, getBufferSize, getExternalVocabularies, getForceStreamClose, getParseFragments, getRegisteredEncodingAlgorithms, getStringInterning, isFastInfosetDocument, peek, peek, peek2, read, reset, setBufferSize, setExternalVocabularies, setForceStreamClose, setInputStream, setParseFragments, setRegisteredEncodingAlgorithms, setStringInterning, setVocabulary

Methods inherited from class java.lang.Object

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

Methods inherited from interface org.jvnet.fastinfoset.FastInfosetParser

getBufferSize, getExternalVocabularies, getForceStreamClose, getParseFragments, getRegisteredEncodingAlgorithms, getStringInterning, setBufferSize, setExternalVocabularies, setForceStreamClose, setParseFragments, setRegisteredEncodingAlgorithms, setStringInterning

Field Detail

_namespacePrefixesFeature

protected boolean _namespacePrefixesFeature

SAX Namespace attributes features

_entityResolver

protected EntityResolver _entityResolver

Reference to entity resolver.

_dtdHandler

protected DTDHandler _dtdHandler

Reference to dtd handler.

_contentHandler

protected ContentHandler _contentHandler

Reference to content handler.

_errorHandler

protected ErrorHandler _errorHandler

Reference to error handler.

_lexicalHandler

protected LexicalHandler _lexicalHandler

Reference to lexical handler.

_declHandler

protected DeclHandler _declHandler

Reference to DTD declaration handler.

_algorithmHandler

protected EncodingAlgorithmContentHandler _algorithmHandler

_primitiveHandler

protected PrimitiveTypeContentHandler _primitiveHandler

builtInAlgorithmState

protected BuiltInEncodingAlgorithmState builtInAlgorithmState

_attributes

protected AttributesHolder _attributes

_namespacePrefixes

protected int[] _namespacePrefixes

_namespacePrefixesIndex

protected int _namespacePrefixesIndex

_clearAttributes

protected boolean _clearAttributes

Constructor Detail

SAXDocumentParser

public SAXDocumentParser()

Creates a new instance of DocumetParser2

Method Detail

resetOnError

protected void resetOnError()

getFeature

public boolean getFeature(String name)
                   throws SAXNotRecognizedException,
                          SAXNotSupportedException

Specified by:

getFeature in interface XMLReader

Throws:

SAXNotRecognizedException

SAXNotSupportedException

setFeature

public void setFeature(String name,
              boolean value)
                throws SAXNotRecognizedException,
                       SAXNotSupportedException

Specified by:

setFeature in interface XMLReader

Throws:

SAXNotRecognizedException

SAXNotSupportedException

getProperty

public Object getProperty(String name)
                   throws SAXNotRecognizedException,
                          SAXNotSupportedException

Specified by:

getProperty in interface XMLReader

Throws:

SAXNotRecognizedException

SAXNotSupportedException

setProperty

public void setProperty(String name,
               Object value)
                 throws SAXNotRecognizedException,
                        SAXNotSupportedException

Specified by:

setProperty in interface XMLReader

Throws:

SAXNotRecognizedException

SAXNotSupportedException

setEntityResolver

public void setEntityResolver(EntityResolver resolver)

Specified by:

setEntityResolver in interface XMLReader

getEntityResolver

public EntityResolver getEntityResolver()

Specified by:

getEntityResolver in interface XMLReader

setDTDHandler

public void setDTDHandler(DTDHandler handler)

Specified by:

setDTDHandler in interface XMLReader

getDTDHandler

public DTDHandler getDTDHandler()

Specified by:

getDTDHandler in interface XMLReader

setContentHandler

public void setContentHandler(ContentHandler handler)

Specified by:

setContentHandler in interface XMLReader

getContentHandler

public ContentHandler getContentHandler()

Specified by:

getContentHandler in interface XMLReader

setErrorHandler

public void setErrorHandler(ErrorHandler handler)

Specified by:

setErrorHandler in interface XMLReader

getErrorHandler

public ErrorHandler getErrorHandler()

Specified by:

getErrorHandler in interface XMLReader

parse

public void parse(InputSource input)
           throws IOException,
                  SAXException

Specified by:

parse in interface XMLReader

Throws:

IOException

SAXException

parse

public void parse(String systemId)
           throws IOException,
                  SAXException

Specified by:

parse in interface XMLReader

Throws:

IOException

SAXException

parse

public final void parse(InputStream s)
                 throws IOException,
                        FastInfosetException,
                        SAXException

Description copied from interface: FastInfosetReader

Parse a fast infoset document from an InputStream.

The application can use this method to instruct the Fast Infoset reader to begin parsing a fast infoset document from a byte stream.

Applications may not invoke this method while a parse is in progress (they should create a new XMLReader instead for each nested XML document). Once a parse is complete, an application may reuse the same FastInfosetReader object, possibly with a different byte stream.

During the parse, the FastInfosetReader will provide information about the fast infoset document through the registered event handlers.

This method is synchronous: it will not return until parsing has ended. If a client application wants to terminate parsing early, it should throw an exception.

Specified by:

parse in interface FastInfosetReader

Parameters:

s - The byte stream to parse from.

Throws:

IOException

FastInfosetException

SAXException

setLexicalHandler

public void setLexicalHandler(LexicalHandler handler)

Description copied from interface: FastInfosetReader

Allow an application to register a lexical handler.

Applications may register a new or different handler in the middle of a parse, and the SAX parser must begin using the new handler immediately.

Specified by:

setLexicalHandler in interface FastInfosetReader

Parameters:

handler - The lexical handler.

See Also:

FastInfosetReader.getLexicalHandler()

getLexicalHandler

public LexicalHandler getLexicalHandler()

Description copied from interface: FastInfosetReader

Return the current lexical handler.

Specified by:

getLexicalHandler in interface FastInfosetReader

Returns:

The current lexical handler, or null if none has been registered.

See Also:

FastInfosetReader.setLexicalHandler(org.xml.sax.ext.LexicalHandler)

setDeclHandler

public void setDeclHandler(DeclHandler handler)

Description copied from interface: FastInfosetReader

Allow an application to register a DTD declaration handler.

Applications may register a new or different handler in the middle of a parse, and the SAX parser must begin using the new handler immediately.

Specified by:

setDeclHandler in interface FastInfosetReader

Parameters:

handler - The DTD declaration handler.

See Also:

FastInfosetReader.getLexicalHandler()

getDeclHandler

public DeclHandler getDeclHandler()

Description copied from interface: FastInfosetReader

Return the current DTD declaration handler.

Specified by:

getDeclHandler in interface FastInfosetReader

Returns:

The current DTD declaration handler, or null if none has been registered.

See Also:

FastInfosetReader.setLexicalHandler(org.xml.sax.ext.LexicalHandler)

setEncodingAlgorithmContentHandler

public void setEncodingAlgorithmContentHandler(EncodingAlgorithmContentHandler handler)

Description copied from interface: FastInfosetReader

Allow an application to register an encoding algorithm handler.

Applications may register a new or different handler in the middle of a parse, and the SAX parser must begin using the new handler immediately.

Specified by:

setEncodingAlgorithmContentHandler in interface FastInfosetReader

Parameters:

handler - The encoding algorithm handler.

See Also:

FastInfosetReader.getEncodingAlgorithmContentHandler()

getEncodingAlgorithmContentHandler

public EncodingAlgorithmContentHandler getEncodingAlgorithmContentHandler()

Description copied from interface: FastInfosetReader

Return the current encoding algorithm handler.

Specified by:

getEncodingAlgorithmContentHandler in interface FastInfosetReader

Returns:

The current encoding algorithm handler, or null if none has been registered.

See Also:

FastInfosetReader.setEncodingAlgorithmContentHandler(org.jvnet.fastinfoset.sax.EncodingAlgorithmContentHandler)

setPrimitiveTypeContentHandler

public void setPrimitiveTypeContentHandler(PrimitiveTypeContentHandler handler)

Description copied from interface: FastInfosetReader

Allow an application to register a primitive type handler.

Applications may register a new or different handler in the middle of a parse, and the SAX parser must begin using the new handler immediately.

Specified by:

setPrimitiveTypeContentHandler in interface FastInfosetReader

Parameters:

handler - The primitive type handler.

See Also:

FastInfosetReader.getPrimitiveTypeContentHandler()

getPrimitiveTypeContentHandler

public PrimitiveTypeContentHandler getPrimitiveTypeContentHandler()

Description copied from interface: FastInfosetReader

Return the current primitive type handler.

Specified by:

getPrimitiveTypeContentHandler in interface FastInfosetReader

Returns:

The current primitive type handler, or null if none has been registered.

See Also:

FastInfosetReader.setPrimitiveTypeContentHandler(org.jvnet.fastinfoset.sax.PrimitiveTypeContentHandler)

parse

public final void parse()
                 throws FastInfosetException,
                        IOException

Throws:

FastInfosetException

IOException

processDII

protected final void processDII()
                         throws FastInfosetException,
                                IOException

Throws:

FastInfosetException

IOException

processDIIFragment

protected final void processDIIFragment()
                                 throws FastInfosetException,
                                        IOException

Throws:

FastInfosetException

IOException

processDIIOptionalProperties

protected final void processDIIOptionalProperties()
                                           throws FastInfosetException,
                                                  IOException

Throws:

FastInfosetException

IOException

processEII

protected final void processEII(QualifiedName name,
              boolean hasAttributes)
                         throws FastInfosetException,
                                IOException

Throws:

FastInfosetException

IOException

processEIIWithNamespaces

protected final void processEIIWithNamespaces()
                                       throws FastInfosetException,
                                              IOException

Throws:

FastInfosetException

IOException

processAIIs

protected final void processAIIs()
                          throws FastInfosetException,
                                 IOException

Throws:

FastInfosetException

IOException

processCommentII

protected final void processCommentII()
                               throws FastInfosetException,
                                      IOException

Throws:

FastInfosetException

IOException

processProcessingII

protected final void processProcessingII()
                                  throws FastInfosetException,
                                         IOException

Throws:

FastInfosetException

IOException

processCIIEncodingAlgorithm

protected final void processCIIEncodingAlgorithm(boolean addToTable)
                                          throws FastInfosetException,
                                                 IOException

Throws:

FastInfosetException

IOException

processCIIBuiltInEncodingAlgorithmAsPrimitive

protected final void processCIIBuiltInEncodingAlgorithmAsPrimitive()
                                                            throws FastInfosetException,
                                                                   IOException

Throws:

FastInfosetException

IOException

processAIIEncodingAlgorithm

protected final void processAIIEncodingAlgorithm(QualifiedName name,
                               boolean addToTable)
                                          throws FastInfosetException,
                                                 IOException

Throws:

FastInfosetException

IOException

processBuiltInEncodingAlgorithmAsCharacters

protected final void processBuiltInEncodingAlgorithmAsCharacters(StringBuffer buffer)
                                                          throws FastInfosetException,
                                                                 IOException

Throws:

FastInfosetException

IOException

processBuiltInEncodingAlgorithmAsObject

protected final Object processBuiltInEncodingAlgorithmAsObject()
                                                        throws FastInfosetException,
                                                               IOException

Throws:

FastInfosetException

IOException