## 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.
`java.lang.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`.
`java.lang.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 Detail

### getTypeDefinition

    public XSTypeDefinition getTypeDefinition()

  [type definition]: either a simple type definition or a complex type definition.

### getScope

    public short getScope()

  [scope]. One of `SCOPE_GLOBAL`, `SCOPE_LOCAL`, or `SCOPE_ABSENT`. If the scope is local, then the `enclosingCTDefinition` is present.

### getEnclosingCTDefinition

    public XSComplexTypeDefinition getEnclosingCTDefinition()

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

### getConstraintType

    public short getConstraintType()

  [Value constraint]: one of `VC_NONE, VC_DEFAULT, VC_FIXED`.

### getConstraintValue

    public java.lang.String getConstraintValue()

  [Value constraint]: the constraint value with respect to the [type definition], otherwise `null`.

### getActualVC

    public java.lang.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.

### 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.

### getIdentityConstraints

    public XSNamedMap getIdentityConstraints()

  identity-constraint definitions: a set of constraint definitions if it exists, otherwise an empty `XSNamedMap`.

### getSubstitutionGroupAffiliation

    public XSElementDeclaration getSubstitutionGroupAffiliation()

  [substitution group affiliation]: a top-level element definition if it exists, otherwise `null`.

### 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.

### 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`.

### 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.

### 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`.

### getAbstract

    public boolean getAbstract()

  {abstract} A boolean.

### 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`.

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