jdk7u.jaxp.org.apache.xerces.external.impl

Class XMLDocumentScannerImpl

java.lang.Object

jdk7u.jaxp.org.apache.xerces.external.impl.XMLScanner

jdk7u.jaxp.org.apache.xerces.external.impl.XMLDocumentFragmentScannerImpl

jdk7u.jaxp.org.apache.xerces.external.impl.XMLDocumentScannerImpl

All Implemented Interfaces:

XMLEntityHandler, XMLComponent, XMLDocumentScanner, XMLDocumentSource, XMLBufferListener

Direct Known Subclasses:

XML11DocumentScannerImpl, XMLNSDocumentScannerImpl

public class XMLDocumentScannerImpl
extends XMLDocumentFragmentScannerImpl

This class is responsible for scanning XML document structure and content. This class has been modified as per the new design which is more suited to efficiently build pull parser. Lot of improvements have been done and the code has been added to support stax functionality/features.

Version:

$Id: XMLDocumentScannerImpl.java,v 1.17 2010-11-01 04:39:41 joehw Exp $

Author:

Neeraj Bajaj, Sun Microsystems, K.Venugopal, Sun Microsystems, Glenn Marcy, IBM, Andy Clark, IBM, Arnaud Le Hors, IBM, Eric Ye, IBM, Sunitha Reddy, Sun Microsystems Refer to the table in unit-test javax.xml.stream.XMLStreamReaderTest.SupportDTD for changes related to property SupportDTD., Joe Wang, Sun Microsystems

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
protected class	XMLDocumentScannerImpl.ContentDriver Driver to handle content scanning.
protected class	XMLDocumentScannerImpl.DTDDriver Driver to handle the internal and external DTD subsets.
protected class	XMLDocumentScannerImpl.PrologDriver Driver to handle prolog scanning.
protected class	XMLDocumentScannerImpl.TrailingMiscDriver Driver to handle trailing miscellaneous section scanning.
protected class	XMLDocumentScannerImpl.XMLDeclDriver Driver to handle XMLDecl scanning.

Nested classes/interfaces inherited from class jdk7u.jaxp.org.apache.xerces.external.impl.XMLDocumentFragmentScannerImpl

XMLDocumentFragmentScannerImpl.Driver, XMLDocumentFragmentScannerImpl.Element, XMLDocumentFragmentScannerImpl.ElementStack, XMLDocumentFragmentScannerImpl.ElementStack2, XMLDocumentFragmentScannerImpl.FragmentContentDriver

Field Summary

Fields

Modifier and Type	Field and Description
protected static String	DISALLOW_DOCTYPE_DECL_FEATURE Feature identifier: load external DTD.
protected static String	DOCUMENT_SCANNER Property identifier document scanner:
protected static String	DTD_SCANNER Property identifier: DTD scanner.
protected boolean	fAddedListener
protected String	fDoctypeName Doctype name.
protected String	fDoctypePublicId Doctype declaration public identifier.
protected String	fDoctypeSystemId Doctype declaration system identifier.
protected XMLStringBuffer	fDTDDecl
protected XMLDocumentFragmentScannerImpl.Driver	fDTDDriver DTD driver.
protected XMLDTDScanner	fDTDScanner DTD scanner.
protected int	fEndPos
protected boolean	fLoadExternalDTD Load external DTD.
protected NamespaceContext	fNamespaceContext Namespace support.
protected XMLDocumentFragmentScannerImpl.Driver	fPrologDriver Prolog driver.
protected boolean	fReadingDTD
protected boolean	fScanEndElement
protected boolean	fSeenDoctypeDecl Seen doctype declaration.
protected boolean	fSeenInternalSubset
protected int	fStartPos
protected XMLDocumentFragmentScannerImpl.Driver	fTrailingMiscDriver Trailing miscellaneous section driver.
protected ValidationManager	fValidationManager Validation manager .
protected XMLDocumentFragmentScannerImpl.Driver	fXMLDeclDriver XML declaration driver.
protected static String	LOAD_EXTERNAL_DTD Feature identifier: load external DTD.
protected static String	NAMESPACE_CONTEXT property identifier: NamespaceContext
protected static int	SCANNER_STATE_DTD_EXTERNAL Scanner state: open DTD external subset.
protected static int	SCANNER_STATE_DTD_EXTERNAL_DECLS Scanner state: DTD external declarations.
protected static int	SCANNER_STATE_DTD_INTERNAL_DECLS Scanner state: DTD internal declarations.
protected static int	SCANNER_STATE_NO_SUCH_ELEMENT_EXCEPTION Scanner state: NO MORE ELEMENTS.
protected static int	SCANNER_STATE_PROLOG Scanner state: prolog.
protected static int	SCANNER_STATE_TRAILING_MISC Scanner state: trailing misc.
protected static int	SCANNER_STATE_XML_DECL Scanner state: XML declaration.
protected static String	VALIDATION_MANAGER

Fields inherited from class jdk7u.jaxp.org.apache.xerces.external.impl.XMLDocumentFragmentScannerImpl

DEBUG, DEBUG_COALESCE, DEBUG_NEXT, DEBUG_START_END_ELEMENT, dtdGrammarUtil, ENTITY_RESOLVER, fAccessExternalDTD, fAdd, fAddDefaultAttr, fAttributeQName, fAttributes, fContentBuffer, fContentDriver, fCurrentElement, fDeclaredEncoding, fDisallowDoctype, fDocumentHandler, fDriver, fElementAttributeLimit, fElementQName, fElementRawname, fElementStack, fElementStack2, fEmptyElement, fEntityStack, fEntityStore, fExternalSubsetResolver, fHasExternalDTD, fInScanContent, fIsCoalesce, fLastSectionWasCData, fLastSectionWasCharacterData, fLastSectionWasEntityReference, fMarkupDepth, fNotifyBuiltInRefs, foundBuiltInRefs, fPIData, fPITarget, fReadingAttributes, fReplaceEntityReferences, fReportCdataEvent, fScannerLastState, fScannerState, fScanToEnd, fShouldSkip, fSkip, fStandalone, fStandaloneSet, fStrictURI, fStringBuffer, fStringBuffer2, fSupportDTD, fSupportExternalEntities, fTempString, fTempString2, fUsebuffer, fVersion, NOTIFY_BUILTIN_REFS, SCANNER_STATE_ATTRIBUTE, SCANNER_STATE_ATTRIBUTE_VALUE, SCANNER_STATE_BUILT_IN_REFS, SCANNER_STATE_CDATA, SCANNER_STATE_CHAR_REFERENCE, SCANNER_STATE_CHARACTER_DATA, SCANNER_STATE_COMMENT, SCANNER_STATE_CONTENT, SCANNER_STATE_DOCTYPE, SCANNER_STATE_END_ELEMENT_TAG, SCANNER_STATE_END_OF_INPUT, SCANNER_STATE_PI, SCANNER_STATE_REFERENCE, SCANNER_STATE_ROOT_ELEMENT, SCANNER_STATE_START_ELEMENT_TAG, SCANNER_STATE_START_OF_MARKUP, SCANNER_STATE_TERMINATED, SCANNER_STATE_TEXT_DECL, STANDARD_URI_CONFORMANT

Fields inherited from class jdk7u.jaxp.org.apache.xerces.external.impl.XMLScanner

attributeValueCache, DEBUG_ATTR_NORMALIZATION, ENTITY_MANAGER, ERROR_REPORTER, fAmpSymbol, fAposSymbol, fAttributeCacheInitDone, fAttributeCacheUsedCount, fCharRefLiteral, fEncodingSymbol, fEntityDepth, fEntityManager, fEntityScanner, fErrorReporter, fEvent, fGtSymbol, fLimitAnalyzer, fLtSymbol, fNamespaces, fNotifyCharRefs, fParserSettings, fPropertyManager, fQuotSymbol, fReportEntity, fResourceIdentifier, fScanningAttribute, fSecurityManager, fStandaloneSymbol, fStringBufferIndex, fSymbolTable, fValidation, fVersionSymbol, NAMESPACES, NOTIFY_CHAR_REFS, PARSER_SETTINGS, stringBufferCache, SYMBOL_TABLE, VALIDATION

Constructor Summary

Constructors

Constructor and Description
XMLDocumentScannerImpl() Default constructor.

Method Summary

Methods

Modifier and Type	Method and Description
protected XMLDocumentFragmentScannerImpl.Driver	createContentDriver() Creates a content driver.
void	endEntity(String name, Augmentations augs) This method notifies the end of an entity.
String	getCharacterEncodingScheme()
XMLStringBuffer	getDTDDecl()
Boolean	getFeatureDefault(String featureId) Returns the default state for a feature, or null if this component does not want to report a default value for this feature.
NamespaceContext	getNamespaceContext()
Object	getPropertyDefault(String propertyId) Returns the default state for a property, or null if this component does not want to report a default value for this property.
String[]	getRecognizedFeatures() Returns a list of feature identifiers that are recognized by this component.
String[]	getRecognizedProperties() Returns a list of property identifiers that are recognized by this component.
protected String	getScannerStateName(int state) Returns the scanner state name.
int	getScannetState() return the state of the scanner
int	next() return the next state on the input
void	refresh(int refreshPosition) receives callbacks from XMLEntityReader when buffer is being changed.
void	reset(PropertyManager propertyManager)
void	reset(XMLComponentManager componentManager) Resets the component.
protected boolean	scanDoctypeDecl(boolean supportDTD) Scans a doctype declaration.
protected void	setEndDTDScanState() Set the scanner state after scanning DTD
void	setFeature(String featureId, boolean state) Sets the state of a feature.
void	setInputSource(XMLInputSource inputSource) Sets the input source.
void	setProperty(String propertyId, Object value) Sets the value of a property.
void	startEntity(String name, XMLResourceIdentifier identifier, String encoding, Augmentations augs) This method notifies of the start of an entity.

Methods inherited from class jdk7u.jaxp.org.apache.xerces.external.impl.XMLDocumentFragmentScannerImpl

getAttributeIterator, getCharacterData, getComment, getDocumentHandler, getDriverName, getElementQName, getEntityName, getPIData, getPITarget, getString, hasAttributes, isStandAlone, refresh, scanAttribute, scanCDATASection, scanCharReference, scanComment, scanContent, scanDocument, scanEndElement, scanEntityReference, scanPIData, scanStartElement, scanXMLDeclOrTextDecl, seekCloseOfStartTag, setDocumentHandler, setDriver, setScannerState, skipElement, standaloneSet

Methods inherited from class jdk7u.jaxp.org.apache.xerces.external.impl.XMLScanner

getFeature, isInvalid, isInvalidLiteral, isValidNameChar, isValidNameStartChar, isValidNCName, normalizeWhitespace, reportFatalError, reset, scanAttributeValue, scanCharReferenceValue, scanComment, scanExternalID, scanPI, scanPseudoAttribute, scanPubidLiteral, scanSurrogates, scanXMLDeclOrTextDecl, setPropertyManager, versionSupported

Methods inherited from class java.lang.Object

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

Field Detail

SCANNER_STATE_XML_DECL

protected static final int SCANNER_STATE_XML_DECL

Scanner state: XML declaration.

See Also:

Constant Field Values

SCANNER_STATE_PROLOG

protected static final int SCANNER_STATE_PROLOG

Scanner state: prolog.

See Also:

Constant Field Values

SCANNER_STATE_TRAILING_MISC

protected static final int SCANNER_STATE_TRAILING_MISC

Scanner state: trailing misc.

See Also:

Constant Field Values

SCANNER_STATE_DTD_INTERNAL_DECLS

protected static final int SCANNER_STATE_DTD_INTERNAL_DECLS

Scanner state: DTD internal declarations.

See Also:

Constant Field Values

SCANNER_STATE_DTD_EXTERNAL

protected static final int SCANNER_STATE_DTD_EXTERNAL

Scanner state: open DTD external subset.

See Also:

Constant Field Values

SCANNER_STATE_DTD_EXTERNAL_DECLS

protected static final int SCANNER_STATE_DTD_EXTERNAL_DECLS

Scanner state: DTD external declarations.

See Also:

Constant Field Values

SCANNER_STATE_NO_SUCH_ELEMENT_EXCEPTION

protected static final int SCANNER_STATE_NO_SUCH_ELEMENT_EXCEPTION

Scanner state: NO MORE ELEMENTS.

See Also:

Constant Field Values

DOCUMENT_SCANNER

protected static final String DOCUMENT_SCANNER

Property identifier document scanner:

See Also:

Constant Field Values

LOAD_EXTERNAL_DTD

protected static final String LOAD_EXTERNAL_DTD

Feature identifier: load external DTD.

See Also:

Constant Field Values

DISALLOW_DOCTYPE_DECL_FEATURE

protected static final String DISALLOW_DOCTYPE_DECL_FEATURE

Feature identifier: load external DTD.

See Also:

Constant Field Values

DTD_SCANNER

protected static final String DTD_SCANNER

Property identifier: DTD scanner.

See Also:

Constant Field Values

VALIDATION_MANAGER

protected static final String VALIDATION_MANAGER

See Also:

Constant Field Values

NAMESPACE_CONTEXT

protected static final String NAMESPACE_CONTEXT

property identifier: NamespaceContext

See Also:

Constant Field Values

fDTDScanner

protected XMLDTDScanner fDTDScanner

DTD scanner.

fValidationManager

protected ValidationManager fValidationManager

Validation manager .

fDTDDecl

protected XMLStringBuffer fDTDDecl

fReadingDTD

protected boolean fReadingDTD

fAddedListener

protected boolean fAddedListener

fDoctypeName

protected String fDoctypeName

Doctype name.

fDoctypePublicId

protected String fDoctypePublicId

Doctype declaration public identifier.

fDoctypeSystemId

protected String fDoctypeSystemId

Doctype declaration system identifier.

fNamespaceContext

protected NamespaceContext fNamespaceContext

Namespace support.

fLoadExternalDTD

protected boolean fLoadExternalDTD

Load external DTD.

fSeenDoctypeDecl

protected boolean fSeenDoctypeDecl

Seen doctype declaration.

fScanEndElement

protected boolean fScanEndElement

fXMLDeclDriver

protected XMLDocumentFragmentScannerImpl.Driver fXMLDeclDriver

XML declaration driver.

fPrologDriver

protected XMLDocumentFragmentScannerImpl.Driver fPrologDriver

Prolog driver.

fDTDDriver

protected XMLDocumentFragmentScannerImpl.Driver fDTDDriver

DTD driver.

fTrailingMiscDriver

protected XMLDocumentFragmentScannerImpl.Driver fTrailingMiscDriver

Trailing miscellaneous section driver.

fStartPos

protected int fStartPos

fEndPos

protected int fEndPos

fSeenInternalSubset

protected boolean fSeenInternalSubset

Constructor Detail

XMLDocumentScannerImpl

public XMLDocumentScannerImpl()

Default constructor.

Method Detail

setInputSource

public void setInputSource(XMLInputSource inputSource)
                    throws IOException

Sets the input source.

Specified by:

setInputSource in interface XMLDocumentScanner

Overrides:

setInputSource in class XMLDocumentFragmentScannerImpl

Parameters:

inputSource - The input source.

Throws:

IOException - Thrown on i/o error.

getScannetState

public int getScannetState()

return the state of the scanner

reset

public void reset(PropertyManager propertyManager)

Overrides:

reset in class XMLDocumentFragmentScannerImpl

reset

public void reset(XMLComponentManager componentManager)
           throws XMLConfigurationException

Resets the component. The component can query the component manager about any features and properties that affect the operation of the component.

Specified by:

reset in interface XMLComponent

Overrides:

reset in class XMLDocumentFragmentScannerImpl

Parameters:

componentManager - The component manager.

Throws:

SAXException - Thrown by component on initialization error. For example, if a feature or property is required for the operation of the component, the component manager may throw a SAXNotRecognizedException or a SAXNotSupportedException.

XMLConfigurationException

getRecognizedFeatures

public String[] getRecognizedFeatures()

Returns a list of feature identifiers that are recognized by this component. This method may return null if no features are recognized by this component.

Specified by:

getRecognizedFeatures in interface XMLComponent

Overrides:

getRecognizedFeatures in class XMLDocumentFragmentScannerImpl

setFeature

public void setFeature(String featureId,
              boolean state)
                throws XMLConfigurationException

Sets the state of a feature. This method is called by the component manager any time after reset when a feature changes state.

Note: Components should silently ignore features that do not affect the operation of the component.

Specified by:

setFeature in interface XMLComponent

Overrides:

setFeature in class XMLDocumentFragmentScannerImpl

Parameters:

featureId - The feature identifier.

state - The state of the feature.

Throws:

SAXNotRecognizedException - The component should not throw this exception.

SAXNotSupportedException - The component should not throw this exception.

XMLConfigurationException - Thrown for configuration error. In general, components should only throw this exception if it is really a critical error.

getRecognizedProperties

public String[] getRecognizedProperties()

Returns a list of property identifiers that are recognized by this component. This method may return null if no properties are recognized by this component.

Specified by:

getRecognizedProperties in interface XMLComponent

Overrides:

getRecognizedProperties in class XMLDocumentFragmentScannerImpl

setProperty

public void setProperty(String propertyId,
               Object value)
                 throws XMLConfigurationException

Sets the value of a property. This method is called by the component manager any time after reset when a property changes value.

Note: Components should silently ignore properties that do not affect the operation of the component.

Specified by:

setProperty in interface XMLComponent

Overrides:

setProperty in class XMLDocumentFragmentScannerImpl

Parameters:

propertyId - The property identifier.

value - The value of the property.

Throws:

SAXNotRecognizedException - The component should not throw this exception.

SAXNotSupportedException - The component should not throw this exception.

XMLConfigurationException - Thrown for configuration error. In general, components should only throw this exception if it is really a critical error.

getFeatureDefault

public Boolean getFeatureDefault(String featureId)

Returns the default state for a feature, or null if this component does not want to report a default value for this feature.

Specified by:

getFeatureDefault in interface XMLComponent

Overrides:

getFeatureDefault in class XMLDocumentFragmentScannerImpl

Parameters:

featureId - The feature identifier.

Since:

Xerces 2.2.0

getPropertyDefault

public Object getPropertyDefault(String propertyId)

Returns the default state for a property, or null if this component does not want to report a default value for this property.

Specified by:

getPropertyDefault in interface XMLComponent

Overrides:

getPropertyDefault in class XMLDocumentFragmentScannerImpl

Parameters:

propertyId - The property identifier.

Since:

Xerces 2.2.0

startEntity

public void startEntity(String name,
               XMLResourceIdentifier identifier,
               String encoding,
               Augmentations augs)
                 throws XNIException

This method notifies of the start of an entity. The DTD has the pseudo-name of "[dtd]" parameter entity names start with '%'; and general entities are just specified by their name.

Specified by:

startEntity in interface XMLEntityHandler

Overrides:

startEntity in class XMLDocumentFragmentScannerImpl

Parameters:

name - The name of the entity.

identifier - The resource identifier.

encoding - The auto-detected IANA encoding name of the entity stream. This value will be null in those situations where the entity encoding is not auto-detected (e.g. internal entities or a document entity that is parsed from a java.io.Reader).

augs - Additional information that may include infoset augmentations

Throws:

XNIException - Thrown by handler to signal an error.

endEntity

public void endEntity(String name,
             Augmentations augs)
               throws IOException,
                      XNIException

This method notifies the end of an entity. The DTD has the pseudo-name of "[dtd]" parameter entity names start with '%'; and general entities are just specified by their name.

Specified by:

endEntity in interface XMLEntityHandler

Overrides:

endEntity in class XMLDocumentFragmentScannerImpl

Parameters:

name - The name of the entity.

augs - Additional information that may include infoset augmentations

Throws:

XNIException - Thrown by handler to signal an error.

IOException - This exception might be thrown when there is premature end of entity

getDTDDecl

public XMLStringBuffer getDTDDecl()

getCharacterEncodingScheme

public String getCharacterEncodingScheme()

next

public int next()
         throws IOException,
                XNIException

return the next state on the input

Specified by:

next in interface XMLDocumentScanner

Overrides:

next in class XMLDocumentFragmentScannerImpl

Returns:

int

Throws:

IOException

XNIException

getNamespaceContext

public NamespaceContext getNamespaceContext()

createContentDriver

protected XMLDocumentFragmentScannerImpl.Driver createContentDriver()

Creates a content driver.

Overrides:

createContentDriver in class XMLDocumentFragmentScannerImpl

scanDoctypeDecl

protected boolean scanDoctypeDecl(boolean supportDTD)
                           throws IOException,
                                  XNIException

Scans a doctype declaration.

Throws:

IOException

XNIException

setEndDTDScanState

protected void setEndDTDScanState()

Set the scanner state after scanning DTD

getScannerStateName

protected String getScannerStateName(int state)

Returns the scanner state name.

Overrides:

getScannerStateName in class XMLDocumentFragmentScannerImpl

refresh

public void refresh(int refreshPosition)

receives callbacks from XMLEntityReader when buffer is being changed.

Specified by:

refresh in interface XMLBufferListener

Overrides:

refresh in class XMLDocumentFragmentScannerImpl

Parameters:

refreshPosition -