org.apache.xerces.xs

Interface XSElementDeclaration

All Superinterfaces:
XSObject, XSTerm

public interface XSElementDeclaration
extends XSTerm

The interface represents the Element Declaration schema component.

Method Summary

boolean
getAbstract()
{abstract} A boolean.
Object
getActualVC()
Value Constraint: Binding specific actual constraint value or null if the value is in error or there is no value constraint.
short
getActualVCType()
The actual constraint value built-in datatype, e.g.
XSAnnotation
getAnnotation()
An annotation if it exists, otherwise null.
XSObjectList
getAnnotations()
A sequence of [annotations] or an empty XSObjectList.
short
getConstraintType()
[Value constraint]: one of VC_NONE, VC_DEFAULT, VC_FIXED.
String
getConstraintValue()
[Value constraint]: the constraint value with respect to the [type definition], otherwise null.
short
getDisallowedSubstitutions()
[disallowed substitutions]: the returned value is a bit combination of the subset of { DERIVATION_SUBSTITUTION, DERIVATION_EXTENSION, DERIVATION_RESTRICTION } corresponding to substitutions disallowed by this XSElementDeclaration or DERIVATION_NONE.
XSComplexTypeDefinition
getEnclosingCTDefinition()
The complex type definition for locally scoped declarations (see scope), otherwise null if no such definition exists.
XSNamedMap
getIdentityConstraints()
identity-constraint definitions: a set of constraint definitions if it exists, otherwise an empty XSNamedMap.
ShortList
getItemValueTypes()
In the case the actual constraint value represents a list, i.e.
boolean
getNillable()
If nillable is true, then an element may also be valid if it carries the namespace qualified attribute with local name nil from namespace http://www.w3.org/2001/XMLSchema-instance and value true (xsi:nil) even if it has no text or element content despite a content type which would otherwise require content.
short
getScope()
[scope].
XSElementDeclaration
getSubstitutionGroupAffiliation()
[substitution group affiliation]: a top-level element definition if it exists, otherwise null.
short
getSubstitutionGroupExclusions()
[substitution group exclusions]: the returned value is a bit combination of the subset of { DERIVATION_EXTENSION, DERIVATION_RESTRICTION} or DERIVATION_NONE.
XSTypeDefinition
getTypeDefinition()
[type definition]: either a simple type definition or a complex type definition.
boolean
isDisallowedSubstitution(short disallowed)
Convenience method that checks if disallowed is a disallowed substitution for this element declaration.
boolean
isSubstitutionGroupExclusion(short exclusion)
Convenience method that checks if exclusion is a substitution group exclusion for this element declaration.

Methods inherited from interface org.apache.xerces.xs.XSObject

getName, getNamespace, getNamespaceItem, getType

Method Details

getAbstract

public boolean getAbstract()
{abstract} A boolean.

getActualVC

public Object getActualVC()
            throws XSException
Value Constraint: Binding specific actual constraint value or null if the value is in error or there is no value constraint.
Throws:
XSException - NOT_SUPPORTED_ERR: Raised if the implementation does not support this method.

getActualVCType

public short getActualVCType()
            throws XSException
The actual constraint value built-in datatype, e.g. STRING_DT, SHORT_DT. If the type definition of this value is a list type definition, this method returns LIST_DT. If the type definition of this value is a list type definition whose item type is a union type definition, this method returns LISTOFUNION_DT. To query the actual constraint value of the list or list of union type definitions use itemValueTypes. If the actualNormalizedValue is null, this method returns UNAVAILABLE_DT .
Throws:
XSException - NOT_SUPPORTED_ERR: Raised if the implementation does not support this method.

getAnnotation

public XSAnnotation getAnnotation()
An annotation if it exists, otherwise null. If not null then the first [annotation] from the sequence of annotations.

getAnnotations

public XSObjectList getAnnotations()
A sequence of [annotations] or an empty XSObjectList.

getConstraintType

public short getConstraintType()
[Value constraint]: one of VC_NONE, VC_DEFAULT, VC_FIXED.

getConstraintValue

public String getConstraintValue()
[Value constraint]: the constraint value with respect to the [type definition], otherwise null.

getDisallowedSubstitutions

public short getDisallowedSubstitutions()
[disallowed substitutions]: the returned value is a bit combination of the subset of { DERIVATION_SUBSTITUTION, DERIVATION_EXTENSION, DERIVATION_RESTRICTION } corresponding to substitutions disallowed by this XSElementDeclaration or DERIVATION_NONE.

getEnclosingCTDefinition

public XSComplexTypeDefinition getEnclosingCTDefinition()
The complex type definition for locally scoped declarations (see scope), otherwise null if no such definition exists.

getIdentityConstraints

public XSNamedMap getIdentityConstraints()
identity-constraint definitions: a set of constraint definitions if it exists, otherwise an empty XSNamedMap.

getItemValueTypes

public ShortList getItemValueTypes()
            throws XSException
In the case the actual constraint value represents a list, i.e. the actualValueType is LIST_DT, the returned array consists of one type kind which represents the itemType. If the actual constraint value represents a list type definition whose item type is a union type definition, i.e. LISTOFUNION_DT, for each actual constraint value in the list the array contains the corresponding memberType kind. For examples, see ItemPSVI.itemValueTypes.
Throws:
XSException - NOT_SUPPORTED_ERR: Raised if the implementation does not support this method.

getNillable

public boolean getNillable()
If nillable is true, then an element may also be valid if it carries the namespace qualified attribute with local name nil from namespace http://www.w3.org/2001/XMLSchema-instance and value true (xsi:nil) even if it has no text or element content despite a content type which would otherwise require content.

getScope

public short getScope()
[scope]. One of SCOPE_GLOBAL, SCOPE_LOCAL, or SCOPE_ABSENT. If the scope is local, then the enclosingCTDefinition is present.

getSubstitutionGroupAffiliation

public XSElementDeclaration getSubstitutionGroupAffiliation()
[substitution group affiliation]: a top-level element definition if it exists, otherwise null.

getSubstitutionGroupExclusions

public short getSubstitutionGroupExclusions()
[substitution group exclusions]: the returned value is a bit combination of the subset of { DERIVATION_EXTENSION, DERIVATION_RESTRICTION} or DERIVATION_NONE.

getTypeDefinition

public XSTypeDefinition getTypeDefinition()
[type definition]: either a simple type definition or a complex type definition.

isDisallowedSubstitution

public boolean isDisallowedSubstitution(short disallowed)
Convenience method that checks if disallowed is a disallowed substitution for this element declaration.
Parameters:
disallowed - { DERIVATION_SUBSTITUTION, DERIVATION_EXTENSION, DERIVATION_RESTRICTION } or DERIVATION_NONE. Represents a block set for the element.
Returns:
True if disallowed is a part of the substitution group exclusion subset.

isSubstitutionGroupExclusion

public boolean isSubstitutionGroupExclusion(short exclusion)
Convenience method that checks if exclusion is a substitution group exclusion for this element declaration.
Parameters:
exclusion - DERIVATION_EXTENSION, DERIVATION_RESTRICTION or DERIVATION_NONE. Represents final set for the element.
Returns:
True if exclusion is a part of the substitution group exclusion subset.

Copyright © 1999-2007 The Apache Software Foundation. All Rights Reserved.