Package com.ctc.wstx.dtd

Class DTDTypingNonValidator

java.lang.Object

org.codehaus.stax2.validation.XMLValidator

com.ctc.wstx.dtd.DTDValidatorBase

com.ctc.wstx.dtd.DTDTypingNonValidator

All Implemented Interfaces:

NsDefaultProvider

public class DTDTypingNonValidator
extends DTDValidatorBase

This class is a "non-validating validator"; a validator-like object that handles DTD-based non-validation functionality: determining type information and default values. This instance does NOT implement any actual DTD-validation, and is to be used in DTD-aware non-validating mode.

Field Summary

Fields

Modifier and Type	Field	Description
protected BitSet	mCurrDefaultAttrs	Bitset used for keeping track of defaulted attributes for which values have been found.
protected boolean	mHasAttrDefaults	Flag that indicates if current element has any attributes that have default values.
protected boolean	mHasNormalizableAttrs	Flag that indicates whether any of the attributes is potentially normalizable, and we are in attribute-normalizing mode.

Fields inherited from class com.ctc.wstx.dtd.DTDValidatorBase

EMPTY_MAP, mAttrCount, mAttrSpecs, mCurrAttrDefs, mCurrElem, mElemCount, mElems, mIdAttrIndex, mNormAttrs, mTmpKey, NO_ATTRS

Fields inherited from class org.codehaus.stax2.validation.XMLValidator

CONTENT_ALLOW_ANY_TEXT, CONTENT_ALLOW_NONE, CONTENT_ALLOW_UNDEFINED, CONTENT_ALLOW_VALIDATABLE_TEXT, CONTENT_ALLOW_WS, CONTENT_ALLOW_WS_NONSTRICT

Constructor Summary

Constructors

Constructor	Description
DTDTypingNonValidator(DTDSubset schema, ValidationContext ctxt, boolean hasNsDefaults, Map<PrefixedName,DTDElement> elemSpecs, Map<String,EntityDecl> genEntities)

Method Summary

Modifier and Type	Method	Description
protected ElementIdMap	getIdMap()
boolean	reallyValidating()
void	setAttrValueNormalization(boolean state)	This 'validator' will not normalize any attributes, so let's implement this as no-op.
String	validateAttribute(String localName, String uri, String prefix, char[] valueChars, int valueStart, int valueEnd)	Callback method called on validator to give it a chance to validate the value of an attribute, as well as to normalize its value if appropriate (remove leading/trailing/intervening white space for certain token types etc.).
String	validateAttribute(String localName, String uri, String prefix, String value)	Callback method called on validator to give it a chance to validate the value of an attribute, as well as to normalize its value if appropriate (remove leading/trailing/intervening white space for certain token types etc.).
int	validateElementAndAttributes()	Method called after calling XMLValidator.validateAttribute(java.lang.String, java.lang.String, java.lang.String, java.lang.String) on all attributes (if any), but before starting to handle element content.
int	validateElementEnd(String localName, String uri, String prefix)	Method called right after encountering an element close tag.
void	validateElementStart(String localName, String uri, String prefix)	Method called to update information about the newly encountered (start) element.
void	validationCompleted(boolean eod)	Method called when the validation is completed; either due to the input stream ending, or due to an explicit 'stop validation' request by the application (via context object).

Methods inherited from class com.ctc.wstx.dtd.DTDValidatorBase

checkNsDefaults, doAddDefaultValue, doReportValidationProblem, getAttributeType, getIdAttrIndex, getNotationAttrIndex, getSchema, hasNsDefaults, mayHaveNsDefaults, validateText, validateText

Methods inherited from class org.codehaus.stax2.validation.XMLValidator

getSchemaType

Methods inherited from class java.lang.Object

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

Field Detail

mHasAttrDefaults

protected boolean mHasAttrDefaults

Flag that indicates if current element has any attributes that have default values.

mCurrDefaultAttrs

protected BitSet mCurrDefaultAttrs

Bitset used for keeping track of defaulted attributes for which values have been found. Only non-null when current element does have such attributes

mHasNormalizableAttrs

protected boolean mHasNormalizableAttrs

Flag that indicates whether any of the attributes is potentially normalizable, and we are in attribute-normalizing mode.

Constructor Detail

DTDTypingNonValidator

public DTDTypingNonValidator(DTDSubset schema,
                             ValidationContext ctxt,
                             boolean hasNsDefaults,
                             Map<PrefixedName,DTDElement> elemSpecs,
                             Map<String,EntityDecl> genEntities)

Method Detail

reallyValidating

public final boolean reallyValidating()

Specified by:

reallyValidating in class DTDValidatorBase

Returns:

False, since this is not a real validator

setAttrValueNormalization

public void setAttrValueNormalization(boolean state)

This 'validator' will not normalize any attributes, so let's implement this as no-op.

Overrides:

setAttrValueNormalization in class DTDValidatorBase

validateElementStart

public void validateElementStart(String localName,
                                 String uri,
                                 String prefix)
                          throws XMLStreamException

Description copied from class: DTDValidatorBase

Method called to update information about the newly encountered (start) element. At this point namespace information has been resolved, but no DTD validation has been done. Validator is to do these validations, including checking for attribute value (and existence) compatibility.

Specified by:

validateElementStart in class DTDValidatorBase

Throws:

XMLStreamException

validateAttribute

public String validateAttribute(String localName,
                                String uri,
                                String prefix,
                                String value)
                         throws XMLStreamException

Description copied from class: XMLValidator

Callback method called on validator to give it a chance to validate the value of an attribute, as well as to normalize its value if appropriate (remove leading/trailing/intervening white space for certain token types etc.).

Specified by:

validateAttribute in class DTDValidatorBase

Returns:

Null, if the passed value is fine as is; or a String, if it needs to be replaced. In latter case, caller will replace the value before passing it to other validators. Also, if the attribute value is accessible via caller (as is the case for stream readers), caller should return this value, instead of the original one.

Throws:

XMLStreamException

validateAttribute

public String validateAttribute(String localName,
                                String uri,
                                String prefix,
                                char[] valueChars,
                                int valueStart,
                                int valueEnd)
                         throws XMLStreamException

Description copied from class: XMLValidator

Callback method called on validator to give it a chance to validate the value of an attribute, as well as to normalize its value if appropriate (remove leading/trailing/intervening white space for certain token types etc.).

Specified by:

validateAttribute in class DTDValidatorBase

valueChars - Character array that contains value (possibly along with some other text)

valueStart - Index of the first character of the value in in valueChars array

valueEnd - Index of the character AFTER the last character; so that the length of the value String is valueEnd - valueStart

Returns:

Null, if the passed value is fine as is; or a String, if it needs to be replaced. In latter case, caller will replace the value before passing it to other validators. Also, if the attribute value is accessible via caller (as is the case for stream readers), caller should return this value, instead of the original one.

Throws:

XMLStreamException

validateElementAndAttributes

public int validateElementAndAttributes()
                                 throws XMLStreamException

Description copied from class: XMLValidator

Method called after calling XMLValidator.validateAttribute(java.lang.String, java.lang.String, java.lang.String, java.lang.String) on all attributes (if any), but before starting to handle element content.

Specified by:

validateElementAndAttributes in class DTDValidatorBase

Returns:

One of CONTENT_ALLOW_ constants, to indicate what kind of textual content is allowed at the scope returned to after the element has closed.

Throws:

XMLStreamException

validateElementEnd

public int validateElementEnd(String localName,
                              String uri,
                              String prefix)
                       throws XMLStreamException

Description copied from class: XMLValidator

Method called right after encountering an element close tag.

Specified by:

validateElementEnd in class DTDValidatorBase

Returns:

Validation state that should be effective for the parent element state

Throws:

XMLStreamException

validationCompleted

public void validationCompleted(boolean eod)

Description copied from class: XMLValidator

Method called when the validation is completed; either due to the input stream ending, or due to an explicit 'stop validation' request by the application (via context object).

Specified by:

validationCompleted in class DTDValidatorBase

Parameters:

eod - Flag that indicates whether this method was called by the context due to the end of the stream (true); or by an application requesting end of validation (false).

getIdMap

protected ElementIdMap getIdMap()

Specified by:

getIdMap in class DTDValidatorBase