- java.lang.Object
-
- javax.xml.validation.TypeInfoProvider
-
public abstract class TypeInfoProvider extends Object
This class provides access to the type information determined byValidatorHandler
.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:
TypeInfo
-
-
Constructor Summary
Constructors Modifier Constructor and Description protected
TypeInfoProvider()
Constructor for the derived class.
-
Method Summary
Methods Modifier and Type Method and Description abstract TypeInfo
getAttributeTypeInfo(int index)
Returns the immutableTypeInfo
object for the specified attribute of the current element.abstract TypeInfo
getElementTypeInfo()
Returns the immutableTypeInfo
object for the current element.abstract boolean
isIdAttribute(int index)
Returnstrue
if the specified attribute is determined to be ID.abstract boolean
isSpecified(int index)
Returnsfalse
if the attribute was added by the validator.
-
-
-
Constructor Detail
-
TypeInfoProvider
protected TypeInfoProvider()
Constructor for the derived class.The constructor does nothing.
-
-
Method Detail
-
getElementTypeInfo
public abstract TypeInfo getElementTypeInfo()
Returns the immutable
TypeInfo
object for the current element.The method may only be called by the startElement event or the endElement event of the
ContentHandler
that the application sets to theValidatorHandler
.When W3C XML Schema validation is being performed, in the case where an element has a union type, the
TypeInfo
returned by a call togetElementTypeInfo()
from the startElement event will be the union type. TheTypeInfo
returned by a call from the endElement event will be the actual member type used to validate the element.- Returns:
- An immutable
TypeInfo
object that represents the type of the current element. Note that the caller can keep references to the obtainedTypeInfo
longer 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 otherContentHandler
methods.
-
getAttributeTypeInfo
public abstract TypeInfo getAttributeTypeInfo(int index)
Returns the immutableTypeInfo
object for the specified attribute of the current element.The method may only be called by the startElement event of the
ContentHandler
that the application sets to theValidatorHandler
.- Parameters:
index
- The index of the attribute. The same index for theAttributes
object passed to thestartElement
callback.- Returns:
- An immutable
TypeInfo
object that represents the type of the specified attribute. Note that the caller can keep references to the obtainedTypeInfo
longer 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 otherContentHandler
methods.
-
isIdAttribute
public abstract boolean isIdAttribute(int index)
Returnstrue
if the specified attribute is determined to be ID.Exacly 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
DocumentBuilder
uses this information to properly implementAttr.isId()
.The method may only be called by the startElement event of the
ContentHandler
that the application sets to theValidatorHandler
.- Parameters:
index
- The index of the attribute. The same index for theAttributes
object passed to thestartElement
callback.- 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 otherContentHandler
methods.
-
isSpecified
public abstract boolean isSpecified(int index)
Returnsfalse
if the attribute was added by the validator.This method provides information necessary for a
DocumentBuilder
to determine what the DOM tree should return from theAttr.getSpecified()
method.The method may only be called by the startElement event of the
ContentHandler
that 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 theAttributes
object passed to thestartElement
callback.- Returns:
true
if the attribute was present before the validator processes input.false
if the attribute was added by the validator.- Throws:
IndexOutOfBoundsException
- If the index is invalid.IllegalStateException
- If this method is called from otherContentHandler
methods.
-
-
Nederlandse vertaling
U hebt gevraagd om deze site in het Nederlands te bezoeken. Voor nu wordt alleen de interface vertaald, maar nog niet alle inhoud.Als je me wilt helpen met vertalingen, is je bijdrage welkom. Het enige dat u hoeft te doen, is u op de site registreren en mij een bericht sturen waarin u wordt gevraagd om u toe te voegen aan de groep vertalers, zodat u de gewenste pagina's kunt vertalen. Een link onderaan elke vertaalde pagina geeft aan dat u de vertaler bent en heeft een link naar uw profiel.
Bij voorbaat dank.
Document heeft de 11/06/2005 gemaakt, de laatste keer de 04/03/2020 gewijzigd
Bron van het afgedrukte document:https://www.gaudry.be/nl/java-api-rf-javax/xml/validation/typeinfoprovider.html
De infobrol is een persoonlijke site waarvan de inhoud uitsluitend mijn verantwoordelijkheid is. De tekst is beschikbaar onder CreativeCommons-licentie (BY-NC-SA). Meer info op de gebruiksvoorwaarden en de auteur.
Referenties
Deze verwijzingen en links verwijzen naar documenten die geraadpleegd zijn tijdens het schrijven van deze pagina, of die aanvullende informatie kunnen geven, maar de auteurs van deze bronnen kunnen niet verantwoordelijk worden gehouden voor de inhoud van deze pagina.
De auteur Deze site is als enige verantwoordelijk voor de manier waarop de verschillende concepten, en de vrijheden die met de referentiewerken worden genomen, hier worden gepresenteerd. Vergeet niet dat u meerdere broninformatie moet doorgeven om het risico op fouten te verkleinen.