com.saxonica.schema
Class AttributeDecl

java.lang.Object
  extended by com.saxonica.schema.SchemaStructure
      extended by com.saxonica.schema.AttributeDecl
All Implemented Interfaces:
SerializableSchemaComponent, UserSchemaComponent, Serializable, SourceLocator, SchemaComponent, SchemaDeclaration

public final class AttributeDecl
extends SchemaStructure
implements UserSchemaComponent, SerializableSchemaComponent, SchemaDeclaration

An XML Schema Attribute Declaration. This includes global attribute declarations, local attribute declarations, and "attribute uses". It corresponds to either (a) an attribute declaration schema component for a global attribute, or (b) an attribute declaration schema component for a local attribute, plus an attribute use referencing that attribute declaration, or (c) an attribute use referencing a global attribute declaration.

See Also:
Serialized Form

Field Summary
 
Fields inherited from interface net.sf.saxon.type.SchemaComponent
FIXED_UP, INCOMPLETE, INVALID, UNVALIDATED, VALIDATED, VALIDATING
 
Constructor Summary
AttributeDecl(EnterpriseConfiguration config, boolean global)
          Creates a new AttrDecl in the given schema.
 
Method Summary
 boolean fixup(SchemaCompiler compiler)
          Check references from this component to other components
 UserComplexType getContainingComplexType()
          Get the containing complex type.
 String getDefaultValue()
          Returns the default value of this attribute declaration.
 String getDisplayName()
          Returns the name of the attribute defined by this AttributeDecl.
 int getFingerprint()
          Gets the fingerprint of this attribute name
 Value getFixedValue()
          Returns the fixed value of this attribute declaration.
 String getName()
          Get the local name of this Attribute Declaration.
 int getNameCode()
          Get the nameCode of the name of this attribute declaration in the namePool
 String getNamespace()
          Deprecated. since 9.0: use the renamed method getTargetNamespace()
 SimpleType getSimpleType()
          Get the type associated with this Attribute Declaration.
 String getTargetNamespace()
          Get the namespace URI of this element declaration.
 SimpleType getType()
          Get the type of this attribute declaration.
 boolean isAbstract()
          Determine, in the case of an Element Declaration, whether it is nillable.
 boolean isGlobal()
          Determine whether this attribute declaration is global.
 boolean isInheritable()
          Ask whether this attribute is inheritable
 boolean isNillable()
          Determine, in the case of an Element Declaration, whether it is nillable.
 boolean isSameDeclaration(AttributeDecl other)
          Test whether this is the same declaration as another attribute declaration.
 NodeTest makeSchemaNodeTest()
          Create a NodeTest that implements the semantics of schema-element(name) or schema-attribute(name) applied to this element or attribute declaration.
 void serialize(SchemaModelSerializer serializer)
          Serialize the schema component
 void setContainingComplexType(UserComplexType type)
          Sets the containing complex type definition.
 void setDefaultValue(String value)
          Sets the default value.
 void setFixedValue(Value value)
          Sets the fixed value.
 void setInheritable(boolean inherit)
          Say whether this attribute is inheritable
 void setNameCode(int nameCode)
          Set the name code for this attribute name.
 void setNamespaceResolver(NamespaceResolver resolver)
          Set the namespace resolver for resolving QName-valued fixed and default values
 void setSimpleType(SimpleType simpleType)
          Sets the SimpleType for this attribute declaration.
 void setTypeReference(TypeReference type)
          Sets the schema type for this attribute declaration.
 boolean testFixedValue(CharSequence value, NamespaceResolver resolver)
          Test a value against the fixed value.
 boolean validate(SchemaCompiler compiler)
          Checks the validity of this Attribute declaration
 
Methods inherited from class com.saxonica.schema.SchemaStructure
elaborate, getColumnNumber, getConfiguration, getFixupStatus, getLineNumber, getPublicId, getRedefinitionLevel, getSchemaDocumentURI, getSystemId, getValidationStatus, lookForCycles, setConfiguration, setFixupStatus, setLineNumber, setLocator, setRedefinitionLevel, setSchemaDocumentURI, setSystemId, setValidationStatus
 
Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
 
Methods inherited from interface com.saxonica.schema.UserSchemaComponent
elaborate, lookForCycles
 
Methods inherited from interface net.sf.saxon.type.SchemaComponent
getRedefinitionLevel, getValidationStatus
 

Constructor Detail

AttributeDecl

public AttributeDecl(EnterpriseConfiguration config,
                     boolean global)
Creates a new AttrDecl in the given schema. For system use only.

Parameters:
config - the configuration that contains the new attrDecl
global - true if the attribute declaration is global
Method Detail

isGlobal

public boolean isGlobal()
Determine whether this attribute declaration is global. This represents one aspect of the {scope} property defined in the schema data model.

Returns:
true if the attribute declaration is global, false if it is local

setContainingComplexType

public void setContainingComplexType(UserComplexType type)
Sets the containing complex type definition. For internal use only.

Parameters:
type - the containing complex type

getContainingComplexType

public UserComplexType getContainingComplexType()
Get the containing complex type. This represents one aspect of the {scope} property defined in the schema component model. If the attribute is a local attribute declaration and is defined as part of a complex type (and not as part of a named attribute group), returns the complex type definition. Otherwise, returns null.

Returns:
the containing complex type definition if there is one, otherwise null

getName

public String getName()
Get the local name of this Attribute Declaration. This corresponds to the {name} property as defined in the schema component model.

Returns:
the local name of the attribute

getNamespace

public String getNamespace()
Deprecated. since 9.0: use the renamed method getTargetNamespace()

Get the namespace part of the name of this Attribute Declaration. This corresponds to the {targetNamespace} property as defined in the schema component model.

Returns:
the namespace URI part of the name of the attribute

getTargetNamespace

public String getTargetNamespace()
Get the namespace URI of this element declaration. This corresponds to the {targetNamespace} property defined in the schema component model.

Returns:
the target namespace URI

getDisplayName

public String getDisplayName()
Returns the name of the attribute defined by this AttributeDecl. This is used only for diagnostic display purposes

Returns:
the name of the attribute as a lexical QName.

setNameCode

public void setNameCode(int nameCode)
Set the name code for this attribute name. For internal use only.

Parameters:
nameCode - the nameCode, as allocated from the name pool.

setTypeReference

public void setTypeReference(TypeReference type)
Sets the schema type for this attribute declaration. For internal use only.

Parameters:
type - the schema type for this element declaration.

getFingerprint

public int getFingerprint()
Gets the fingerprint of this attribute name

Specified by:
getFingerprint in interface SchemaDeclaration
Returns:
the fingerprint of the attribute name in the NamePool

getNameCode

public int getNameCode()
Get the nameCode of the name of this attribute declaration in the namePool

Returns:
the nameCode of the attribute name

getSimpleType

public SimpleType getSimpleType()
                         throws UnresolvedReferenceException
Get the type associated with this Attribute Declaration.

Returns:
the type of this attribute.
Throws:
UnresolvedReferenceException - if the reference from the attribute declaration to its type has not been resolved

getType

public SimpleType getType()
                   throws UnresolvedReferenceException
Get the type of this attribute declaration. This corresponds to the {typeDefinition} property defined in the schema component model

Specified by:
getType in interface SchemaDeclaration
Returns:
the type of this attribute. The returned SchemaType will always be an instanceof SimpleType
Throws:
UnresolvedReferenceException

getDefaultValue

public String getDefaultValue()
Returns the default value of this attribute declaration. This corresponds to one aspect of the {valueConstraint} property defined in the schema component model.

Returns:
the default value defined by this attribute declaration, or null if no default was specified. The default value is always maintained as a string, in the form supplied in the original schema document.

getFixedValue

public Value getFixedValue()
Returns the fixed value of this attribute declaration. This corresponds to one aspect of the {valueConstraint} property defined in the schema component model.

Returns:
the fixed value defined by this attribute declaration, or null if no fixed value was specified. Once the schema has been compiled this will be the correctly-typed value; until then it will be the string value as specified in the source schema document.

setSimpleType

public void setSimpleType(SimpleType simpleType)
Sets the SimpleType for this attribute declaration. For internal use only.

Parameters:
simpleType - the SimpleType for this attribute declaration

setDefaultValue

public void setDefaultValue(String value)
Sets the default value. For internal use only.

Parameters:
value - the default value

setFixedValue

public void setFixedValue(Value value)
Sets the fixed value. For internal use only.

Parameters:
value - the fixed value. This will initially be saved as an UntypedAtomicValue; later, when the type is known, it will be converted to the correct type

setNamespaceResolver

public void setNamespaceResolver(NamespaceResolver resolver)
Set the namespace resolver for resolving QName-valued fixed and default values

Parameters:
resolver - the namespace resolver

makeSchemaNodeTest

public NodeTest makeSchemaNodeTest()
Create a NodeTest that implements the semantics of schema-element(name) or schema-attribute(name) applied to this element or attribute declaration.

Specified by:
makeSchemaNodeTest in interface SchemaDeclaration

setInheritable

public void setInheritable(boolean inherit)
Say whether this attribute is inheritable

Parameters:
inherit - true if it is inheritable

isInheritable

public boolean isInheritable()
Ask whether this attribute is inheritable

Returns:
true if it is inheritable

fixup

public boolean fixup(SchemaCompiler compiler)
              throws SchemaException,
                     UnresolvedReferenceException
Check references from this component to other components

Specified by:
fixup in interface UserSchemaComponent
Overrides:
fixup in class SchemaStructure
Parameters:
compiler - used for error reporting
Returns:
true if all is well, false if errors found
Throws:
SchemaException
UnresolvedReferenceException

validate

public boolean validate(SchemaCompiler compiler)
                 throws SchemaException
Checks the validity of this Attribute declaration

Specified by:
validate in interface UserSchemaComponent
Returns:
true when this Schema definition is valid, otherwise false.
Throws:
SchemaException - if the error listener decides an error is fatal

testFixedValue

public boolean testFixedValue(CharSequence value,
                              NamespaceResolver resolver)
                       throws ValidationException
Test a value against the fixed value. This tests both against the fixed value for this attribute use, and the fixed value of the corresponding attribute declaration (which must be equivalent if they are both present).

Parameters:
value - the value to be tested
resolver - Namespace resolver for use if the value is namespace-sensitive (QName or NOTATION)
Returns:
true if it matches (or if there is no fixed value), false otherwise
Throws:
ValidationException - if the value is not valid for this type

isSameDeclaration

public boolean isSameDeclaration(AttributeDecl other)
Test whether this is the same declaration as another attribute declaration. They are considered to be the same declaration if they came from the same xs:attribute element in the same schema document

Parameters:
other - the other attribute declaration
Returns:
true if the two attribute declarations are considered identical

isNillable

public boolean isNillable()
Determine, in the case of an Element Declaration, whether it is nillable. For an Attribute declaration, always return false;

Specified by:
isNillable in interface SchemaDeclaration

isAbstract

public boolean isAbstract()
Determine, in the case of an Element Declaration, whether it is nillable. For an Attribute declaration, always return false;

Specified by:
isAbstract in interface SchemaDeclaration

serialize

public void serialize(SchemaModelSerializer serializer)
               throws XPathException
Serialize the schema component

Specified by:
serialize in interface SerializableSchemaComponent
Parameters:
serializer - the object responsible for performing the serialization
Throws:
XPathException - if serialization fails


Copyright (c) 2004-2011 Saxonica Limited. All rights reserved.