com.ctc.wstx.sr

Class NonNsInputElementStack

java.lang.Object

com.ctc.wstx.sr.InputElementStack

com.ctc.wstx.sr.NonNsInputElementStack

All Implemented Interfaces:

javax.xml.namespace.NamespaceContext, AttributeInfo, ValidationContext

public final class NonNsInputElementStack
extends InputElementStack

Sub-class of InputElementStack used when operating in non-namespace-aware, non validating mode.

Field Summary

Fields

Modifier and Type	Field and Description
protected NonNsAttributeCollector	mAttrCollector
protected java.lang.String[]	mElements Array that contains path of open elements from root, one String for each open start element.
protected java.lang.String	mLastLocalName
protected javax.xml.namespace.QName	mLastName
protected int	mSize Number of Strings in mElements that are valid.

Fields inherited from class com.ctc.wstx.sr.InputElementStack

mConfig, mIdAttrIndex, mReporter, mValidator

Constructor Summary

Constructors

Constructor and Description
NonNsInputElementStack(int initialSize, ReaderConfig cfg)

Method Summary

Methods

Modifier and Type	Method and Description
int	addDefaultAttribute(java.lang.String localName, java.lang.String uri, java.lang.String prefix, java.lang.String value) Method called by actual validator instances when attributes with default values have no explicit values for the element; if so, default value needs to be added as if it was parsed from the element.
void	addNsBinding(java.lang.String prefix, java.lang.String uri)
BaseNsContext	createNonTransientNsContext(javax.xml.stream.Location loc) Method called to construct a non-transient NamespaceContext instance; generally needed when creating events to return from event-based iterators.
int	findAttributeIndex(java.lang.String nsURI, java.lang.String localName)
AttributeCollector	getAttrCollector() Method called by BasicStreamReader, to retrieve the attribute collector it needs for some direct access.
int	getAttributeCount() This method returns number of attributes accessible from within currently active start element.
javax.xml.namespace.QName	getCurrentElementName() Method that can be used to access name information of the innermost (top) element in the element stack.
int	getCurrentNsCount()
java.lang.String	getDefaultNsURI()
int	getDepth()
java.lang.String	getLocalName()
java.lang.String	getLocalNsPrefix(int index)
java.lang.String	getLocalNsURI(int index)
java.lang.String	getNamespaceURI(java.lang.String prefix) Method that can be called by the validator to resolve a namespace prefix of the currently active top-level element.
java.lang.String	getNsURI()
java.lang.String	getPrefix()
java.lang.String	getPrefix(java.lang.String nsURI)
java.util.Iterator	getPrefixes(java.lang.String nsURI)
java.lang.String	getTopElementDesc()
int	getTotalNsCount()
boolean	isEmpty()
boolean	isNamespaceAware()
boolean	isPrefixLocallyDeclared(java.lang.String internedPrefix)
boolean	matches(java.lang.String prefix, java.lang.String localName)
int	pop() Method called by the stream reader to remove the topmost (start) element from the stack; called when an end element is encountered during parsing.
void	push(java.lang.String fullName) Method called by the stream reader to add new (start) element into the stack in non-namespace mode; called when a start element is encountered during parsing, but only in non-namespace mode.
void	push(java.lang.String prefix, java.lang.String localName) Method called by the stream reader to add new (start) element into the stack in namespace-aware mode; called when a start element is encountered during parsing, but only in ns-aware mode.
int	resolveAndValidateElement() Method called to update information about top of the stack, with attribute information passed in.
protected void	setAutomaticDTDValidator(XMLValidator validator, NsDefaultProvider nsDefs) Method called to connect the automatically handled DTD validator (one detected from DOCTYPE, loaded and completely handled by the stream reader without application calling validation methods).

Methods inherited from class com.ctc.wstx.sr.InputElementStack

addValidator, connectReporter, getAttributeLocalName, getAttributeNamespace, getAttributePrefix, getAttributeType, getAttributeValue, getAttributeValue, getBaseUri, getIdAttributeIndex, getNotationAttributeIndex, getValidationLocation, getXmlVersion, isNotationDeclared, isUnparsedEntityDeclared, normalizeXmlIdAttr, reallyValidating, reportProblem, stopValidatingAgainst, stopValidatingAgainst, validateAgainst, validateText

Methods inherited from class java.lang.Object

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

Field Detail

mAttrCollector

protected final NonNsAttributeCollector mAttrCollector

mElements

protected java.lang.String[] mElements

Array that contains path of open elements from root, one String for each open start element.

mSize

protected int mSize

Number of Strings in mElements that are valid.

mLastLocalName

protected java.lang.String mLastLocalName

mLastName

protected javax.xml.namespace.QName mLastName

Constructor Detail

NonNsInputElementStack

public NonNsInputElementStack(int initialSize,
                      ReaderConfig cfg)

Method Detail

setAutomaticDTDValidator

protected void setAutomaticDTDValidator(XMLValidator validator,
                            NsDefaultProvider nsDefs)

Description copied from class: InputElementStack

Method called to connect the automatically handled DTD validator (one detected from DOCTYPE, loaded and completely handled by the stream reader without application calling validation methods). Handled separately, since its behaviour is potentially different from that of explicitly added validators.

Specified by:

setAutomaticDTDValidator in class InputElementStack

push

public final void push(java.lang.String prefix,
        java.lang.String localName)

Description copied from class: InputElementStack

Method called by the stream reader to add new (start) element into the stack in namespace-aware mode; called when a start element is encountered during parsing, but only in ns-aware mode.

Specified by:

push in class InputElementStack

push

public final void push(java.lang.String fullName)

Description copied from class: InputElementStack

Method called by the stream reader to add new (start) element into the stack in non-namespace mode; called when a start element is encountered during parsing, but only in non-namespace mode.

Specified by:

push in class InputElementStack

pop

public int pop()
        throws javax.xml.stream.XMLStreamException

Description copied from class: InputElementStack

Method called by the stream reader to remove the topmost (start) element from the stack; called when an end element is encountered during parsing.

Specified by:

pop in class InputElementStack

Returns:

Validation state that should be effective for the parent element state

Throws:

javax.xml.stream.XMLStreamException

resolveAndValidateElement

public int resolveAndValidateElement()
                              throws javax.xml.stream.XMLStreamException

Method called to update information about top of the stack, with attribute information passed in. Will resolve namespace references, and update namespace stack with information.

Specified by:

resolveAndValidateElement in class InputElementStack

Returns:

Validation state that should be effective for the fully resolved element context

Throws:

javax.xml.stream.XMLStreamException

isNamespaceAware

public final boolean isNamespaceAware()

Specified by:

isNamespaceAware in class InputElementStack

getDepth

public final int getDepth()

Specified by:

getDepth in class InputElementStack

Returns:

Number of open elements in the stack; 0 when parser is in prolog/epilog, 1 inside root element and so on.

getAttrCollector

public final AttributeCollector getAttrCollector()

Description copied from class: InputElementStack

Method called by BasicStreamReader, to retrieve the attribute collector it needs for some direct access.

Specified by:

getAttrCollector in class InputElementStack

createNonTransientNsContext

public final BaseNsContext createNonTransientNsContext(javax.xml.stream.Location loc)

Method called to construct a non-transient NamespaceContext instance; generally needed when creating events to return from event-based iterators.

Specified by:

createNonTransientNsContext in class InputElementStack

getNamespaceURI

public final java.lang.String getNamespaceURI(java.lang.String prefix)

Description copied from interface: ValidationContext

Method that can be called by the validator to resolve a namespace prefix of the currently active top-level element. This may be necessary for things like DTD validators (which may need to heuristically guess proper namespace URI of attributes, esp. ones with default values).

Specified by:

getNamespaceURI in interface javax.xml.namespace.NamespaceContext

Specified by:

getNamespaceURI in interface ValidationContext

Specified by:

getNamespaceURI in class InputElementStack

getPrefix

public final java.lang.String getPrefix(java.lang.String nsURI)

Specified by:

getPrefix in interface javax.xml.namespace.NamespaceContext

Specified by:

getPrefix in class InputElementStack

getPrefixes

public final java.util.Iterator getPrefixes(java.lang.String nsURI)

Specified by:

getPrefixes in interface javax.xml.namespace.NamespaceContext

Specified by:

getPrefixes in class InputElementStack

getAttributeCount

public final int getAttributeCount()

Description copied from interface: ValidationContext

This method returns number of attributes accessible from within currently active start element.

Note: this method is only guaranteed to be callable during execution of XMLValidator methods XMLValidator.validateElementStart(java.lang.String, java.lang.String, java.lang.String), XMLValidator.validateAttribute(java.lang.String, java.lang.String, java.lang.String, java.lang.String) and XMLValidator.validateElementAndAttributes(). At other times implementations may choose to allow it to be called (for example, with information regarding last start element processed), to throw a IllegalArgumentException, or to return 0 to indicate no attribute information is available.

Also note that whether defaulted attributes (attributes for which values are only available via attribute defaulting) are accessible depends on exact time when this method is called, and in general can not be assumed to function reliably.

Specified by:

getAttributeCount in interface AttributeInfo

Specified by:

getAttributeCount in interface ValidationContext

Specified by:

getAttributeCount in class InputElementStack

Returns:

Number of all attributes accessible (including ones created from the default values, if any) using this Object.

findAttributeIndex

public final int findAttributeIndex(java.lang.String nsURI,
                     java.lang.String localName)

Specified by:

findAttributeIndex in interface AttributeInfo

Specified by:

findAttributeIndex in interface ValidationContext

Specified by:

findAttributeIndex in class InputElementStack

Returns:

Index of the specified attribute, if the current element has such an attribute (explicit, or one created via default value expansion); -1 if not.

getCurrentElementName

public final javax.xml.namespace.QName getCurrentElementName()

Description copied from interface: ValidationContext

Method that can be used to access name information of the innermost (top) element in the element stack.

Specified by:

getCurrentElementName in interface ValidationContext

Specified by:

getCurrentElementName in class InputElementStack

Returns:

Name of the element at the top of the current element stack, if any. During validation calls it refers to the element being processed (start or end tag), or its parent (when processing text nodes), or null (in document prolog and epilog).

addDefaultAttribute

public int addDefaultAttribute(java.lang.String localName,
                      java.lang.String uri,
                      java.lang.String prefix,
                      java.lang.String value)

Description copied from class: InputElementStack

Method called by actual validator instances when attributes with default values have no explicit values for the element; if so, default value needs to be added as if it was parsed from the element.

Specified by:

addDefaultAttribute in interface ValidationContext

Specified by:

addDefaultAttribute in class InputElementStack

Returns:

Index of the newly added attribute, if operation was succesful; -1 if not.

isPrefixLocallyDeclared

public boolean isPrefixLocallyDeclared(java.lang.String internedPrefix)

Specified by:

isPrefixLocallyDeclared in class InputElementStack

Returns:

True, if the given prefix ("" for default namespace) was bound/unbound in the current element (one at the top of the stack); false if not.

addNsBinding

public void addNsBinding(java.lang.String prefix,
                java.lang.String uri)

Specified by:

addNsBinding in class InputElementStack

isEmpty

public final boolean isEmpty()

Specified by:

isEmpty in class InputElementStack

getDefaultNsURI

public final java.lang.String getDefaultNsURI()

Specified by:

getDefaultNsURI in class InputElementStack

getNsURI

public final java.lang.String getNsURI()

Specified by:

getNsURI in class InputElementStack

getPrefix

public final java.lang.String getPrefix()

Specified by:

getPrefix in class InputElementStack

getLocalName

public final java.lang.String getLocalName()

Specified by:

getLocalName in class InputElementStack

matches

public final boolean matches(java.lang.String prefix,
              java.lang.String localName)

Specified by:

matches in class InputElementStack

getTopElementDesc

public final java.lang.String getTopElementDesc()

Specified by:

getTopElementDesc in class InputElementStack

getTotalNsCount

public final int getTotalNsCount()

Specified by:

getTotalNsCount in class InputElementStack

getCurrentNsCount

public final int getCurrentNsCount()

Specified by:

getCurrentNsCount in class InputElementStack

Returns:

Number of active prefix/namespace mappings for current scope, NOT including mappings from enclosing elements.

getLocalNsPrefix

public final java.lang.String getLocalNsPrefix(int index)

Specified by:

getLocalNsPrefix in class InputElementStack

getLocalNsURI

public final java.lang.String getLocalNsURI(int index)

Specified by:

getLocalNsURI in class InputElementStack