Class TypeInfoProvider
ValidatorHandler.
Some schema languages, such as W3C XML Schema, encourages a validator to report the "type" it assigns to each attribute/element. Those applications who wish to access this type information can invoke methods defined on this "interface" to access such type information.
Implementation of this "interface" can be obtained through the
ValidatorHandler.getTypeInfoProvider() method.
- Since:
- 1.5
- See Also:
-
Constructor Summary
Constructors -
Method Summary
Modifier and TypeMethodDescriptionabstract TypeInfogetAttributeTypeInfo(int index) Returns the immutableTypeInfoobject for the specified attribute of the current element.abstract TypeInfoReturns the immutableTypeInfoobject for the current element.abstract booleanisIdAttribute(int index) Returnstrueif the specified attribute is determined to be ID.abstract booleanisSpecified(int index) Returnsfalseif the attribute was added by the validator.
-
Constructor Details
-
TypeInfoProvider
protected TypeInfoProvider()Constructor for the derived class.The constructor does nothing.
-
-
Method Details
-
getElementTypeInfo
Returns the immutable
TypeInfoobject for the current element.The method may only be called by the startElement event or the endElement event of the
ContentHandlerthat the application sets to theValidatorHandler.When W3C XML Schema validation is being performed, in the case where an element has a union type, the
TypeInforeturned by a call togetElementTypeInfo()from the startElement event will be the union type. TheTypeInforeturned by a call from the endElement event will be the actual member type used to validate the element.- Returns:
- An immutable
TypeInfoobject that represents the type of the current element. Note that the caller can keep references to the obtainedTypeInfolonger than the callback scope. Otherwise, this method returns null if the validator is unable to determine the type of the current element for some reason (for example, if the validator is recovering from an earlier error.) - Throws:
IllegalStateException- If this method is called from otherContentHandlermethods.
-
getAttributeTypeInfo
Returns the immutableTypeInfoobject for the specified attribute of the current element.The method may only be called by the startElement event of the
ContentHandlerthat the application sets to theValidatorHandler.- Parameters:
index- The index of the attribute. The same index for theAttributesobject passed to thestartElementcallback.- Returns:
- An immutable
TypeInfoobject that represents the type of the specified attribute. Note that the caller can keep references to the obtainedTypeInfolonger than the callback scope. Otherwise, this method returns null if the validator is unable to determine the type. - Throws:
IndexOutOfBoundsException- If the index is invalid.IllegalStateException- If this method is called from otherContentHandlermethods.
-
isIdAttribute
public abstract boolean isIdAttribute(int index) Returnstrueif the specified attribute is determined to be ID.Exactly how an attribute is "determined to be ID" is up to the schema language. In case of W3C XML Schema, this means that the actual type of the attribute is the built-in ID type or its derived type.
A
DocumentBuilderuses this information to properly implementAttr.isId().The method may only be called by the startElement event of the
ContentHandlerthat the application sets to theValidatorHandler.- Parameters:
index- The index of the attribute. The same index for theAttributesobject passed to thestartElementcallback.- Returns:
- true if the type of the specified attribute is ID.
- Throws:
IndexOutOfBoundsException- If the index is invalid.IllegalStateException- If this method is called from otherContentHandlermethods.
-
isSpecified
public abstract boolean isSpecified(int index) Returnsfalseif the attribute was added by the validator.This method provides information necessary for a
DocumentBuilderto determine what the DOM tree should return from theAttr.getSpecified()method.The method may only be called by the startElement event of the
ContentHandlerthat the application sets to theValidatorHandler.A general guideline for validators is to return true if the attribute was originally present in the pipeline, and false if it was added by the validator.
- Parameters:
index- The index of the attribute. The same index for theAttributesobject passed to thestartElementcallback.- Returns:
trueif the attribute was present before the validator processes input.falseif the attribute was added by the validator.- Throws:
IndexOutOfBoundsException- If the index is invalid.IllegalStateException- If this method is called from otherContentHandlermethods.
-