com.ddtek.xquery3
Interface XQItemType

All Superinterfaces:

XQSequenceType

public interface XQItemType

extends XQSequenceType

The XQItemType interface represents an item type as defined in XQuery 1.0: An XML Query language.
The XQItemType extends the XQSequenceType but restricts the occurance indicator to be exactly one. This derivation allows passing an item type wherever a sequence type is expected, but not the other way. The XQItemType interface contains methods to represent information about the following aspects of an item type:

• The kind of the item - one of XQITEMKIND_* constants
• Base type from which the item is derived - one of XQBASETYPE_*constants
• Name of the node, if any
• Type name, if any. If present, then also whether the typename is an anonymous type
• XML Schema URI associated with the type, if any
• The nillability characteristics, if any
• Whether the item type represents an XML schema element

An instance of the XQItemType class is a standalone object that is independant of the XQJConnection and any XQuery static or dynamic context.

Field Summary

static int	XQBASETYPE_ANYATOMICTYPE Represents the schema type xs:anyAtomicType
static int	XQBASETYPE_ANYSIMPLETYPE Represents the schema type xs:anySimpleType
static int	XQBASETYPE_ANYTYPE Represents a complex element with a type annotation of xs:anyType
static int	XQBASETYPE_ANYURI Represents the schema type xs:anyURI
static int	XQBASETYPE_BASE64BINARY Represents the schema type xs:base64Binary
static int	XQBASETYPE_BOOLEAN Represents the schema type xs:boolean
static int	XQBASETYPE_BYTE Represents the schema type xs:byte
static int	XQBASETYPE_DATE Represents the schema type xs:date
static int	XQBASETYPE_DATETIME Represents the schema type xs:dateTime
static int	XQBASETYPE_DAYTIMEDURATION Represents the schema type xs:dayTimeDuration
static int	XQBASETYPE_DECIMAL Represents the schema type xs:decimal
static int	XQBASETYPE_DOUBLE Represents the schema type xs:double
static int	XQBASETYPE_DURATION Represents the schema type xs:duration
static int	XQBASETYPE_ENTITIES Represents the schema type xs:ENTITIES
static int	XQBASETYPE_ENTITY Represents the schema type xs:ENTITY
static int	XQBASETYPE_FLOAT Represents the schema type xs:float
static int	XQBASETYPE_GDAY Represents the schema type xs:gDay
static int	XQBASETYPE_GMONTH Represents the schema type xs:gMonth
static int	XQBASETYPE_GMONTHDAY Represents the schema type xs:gMonthDay
static int	XQBASETYPE_GYEAR Represents the schema type xs:gYear
static int	XQBASETYPE_GYEARMONTH Represents the schema type xs:gYearMonth
static int	XQBASETYPE_HEXBINARY Represents the schema type xs:hexBinary
static int	XQBASETYPE_ID Represents the schema type xs:ID
static int	XQBASETYPE_IDREF Represents the schema type xs:IDREF
static int	XQBASETYPE_IDREFS Represents the schema type xs:IDREFS.
static int	XQBASETYPE_INT Represents the schema type xs:int
static int	XQBASETYPE_INTEGER Represents the schema type xs:integer
static int	XQBASETYPE_LANGUAGE Represents the schema type xs:language
static int	XQBASETYPE_LONG Represents the schema type xs:long
static int	XQBASETYPE_NAME Represents the schema type xs:Name
static int	XQBASETYPE_NCNAME Represents the schema type xs:NCName
static int	XQBASETYPE_NEGATIVE_INTEGER Represents the schema type xs:negativeInteger
static int	XQBASETYPE_NMTOKEN Represents the schema type xs:NMToken
static int	XQBASETYPE_NMTOKENS Represents the schema type xs:NMTOKENS
static int	XQBASETYPE_NONNEGATIVE_INTEGER Represents the schema type xs:nonNegativeInteger
static int	XQBASETYPE_NONPOSITIVE_INTEGER Represents the schema type xs:nonPositiveInteger
static int	XQBASETYPE_NORMALIZED_STRING Represents the schema type xs:normalizedString
static int	XQBASETYPE_NOTATION Represents the schema type xs:NOTATION
static int	XQBASETYPE_POSITIVE_INTEGER Represents the schema type xs:positiveInteger
static int	XQBASETYPE_QNAME Represents the schema type xs:QName
static int	XQBASETYPE_SHORT Represents the schema type xs:short
static int	XQBASETYPE_STRING Represents the schema type xs:string
static int	XQBASETYPE_TIME Represents the schema type xs:time
static int	XQBASETYPE_TOKEN Represents the schema type xs:token
static int	XQBASETYPE_UNSIGNED_BYTE Represents the schema type xs:unsignedByte
static int	XQBASETYPE_UNSIGNED_INT Represents the schema type xs:unsignedInt
static int	XQBASETYPE_UNSIGNED_LONG Represents the schema type xs:unsignedLong
static int	XQBASETYPE_UNSIGNED_SHORT Represents the schema type xs:unsignedShort
static int	XQBASETYPE_UNTYPED Represents an untyped complex node.
static int	XQBASETYPE_UNTYPEDATOMIC Represents the schema type xs:untypedAtomic
static int	XQBASETYPE_XQJ_COMPLEX Represents a complex element that has a schema type associated with it.
static int	XQBASETYPE_XQJ_LISTTYPE Represents a user-defined list or union type
static int	XQBASETYPE_YEARMONTHDURATION Represents the schema type xs:yearMonthDuration
static int	XQITEMKIND_ATOMIC Some atomic type.
static int	XQITEMKIND_ATTRIBUTE Attribute node
static int	XQITEMKIND_COMMENT Comment node
static int	XQITEMKIND_DOCUMENT Document type (the type information represents the type of the document element)
static int	XQITEMKIND_DOCUMENT_ELEMENT Document node containing a single element node as its child (type information represents type of the element child)
static int	XQITEMKIND_ELEMENT Element node
static int	XQITEMKIND_ITEM Any kind of item
static int	XQITEMKIND_NODE Some node type
static int	XQITEMKIND_PI Processing instruction node
static int	XQITEMKIND_TEXT Text node

Fields inherited from interface com.ddtek.xquery3.XQSequenceType

OCC_EMPTY, OCC_EXACTLY_ONE, OCC_ONE_OR_MORE, OCC_ZERO_OR_MORE, OCC_ZERO_OR_ONE

Method Summary

int	getBaseType() Returns the basic pre-defined type of the item.
int	getItemKind() Returns the basic kind of the item.
int	getItemOccurrence() Returns the occurrence indicator for the item type.
QName	getNodeName() Returns the name of the node in case the item kind is an XQITEMKIND_DOCUMENT_ELEMENT, XQITEMKIND_ELEMENT, or XQITEMKIND_ATTRIBUTE.
String	getPIName() Returns the name of the processing instruction type.
URI	getSchemaURI() Returns the schema location URI of the schema that contains the item's element or type definition.
QName	getTypeName() Represents a type name (global or local).
boolean	isAnonymousType() Represents whether the item type is an anonymous type in the schema.
boolean	isElementNillable() Returns whether the element type is nillable or not.
boolean	isSchemaAttribute() Represents whether the item type represents a schema attribute or not.
boolean	isSchemaElement() Represents whether the item type represents a schema element or not.
String	toString() Returns a string representation of the item type.

Methods inherited from interface com.ddtek.xquery3.XQSequenceType

getItemType

Field Detail

XQITEMKIND_ATOMIC

public static final int XQITEMKIND_ATOMIC

Some atomic type. The atomic type information will give more information of the specific primitive type if available

See Also:

Constant Field Values

XQITEMKIND_ATTRIBUTE

public static final int XQITEMKIND_ATTRIBUTE

Attribute node

See Also:

Constant Field Values

XQITEMKIND_COMMENT

public static final int XQITEMKIND_COMMENT

Comment node

See Also:

Constant Field Values

XQITEMKIND_DOCUMENT

public static final int XQITEMKIND_DOCUMENT

Document type (the type information represents the type of the document element)

See Also:

Constant Field Values

XQITEMKIND_DOCUMENT_ELEMENT

public static final int XQITEMKIND_DOCUMENT_ELEMENT

Document node containing a single element node as its child (type information represents type of the element child)

See Also:

Constant Field Values

XQITEMKIND_ELEMENT

public static final int XQITEMKIND_ELEMENT

Element node

See Also:

Constant Field Values

XQITEMKIND_ITEM

public static final int XQITEMKIND_ITEM

Any kind of item

See Also:

Constant Field Values

XQITEMKIND_NODE

public static final int XQITEMKIND_NODE

Some node type

See Also:

Constant Field Values

XQITEMKIND_PI

public static final int XQITEMKIND_PI

Processing instruction node

See Also:

Constant Field Values

XQITEMKIND_TEXT

public static final int XQITEMKIND_TEXT

Text node

See Also:

Constant Field Values

XQBASETYPE_UNTYPED

public static final int XQBASETYPE_UNTYPED

Represents an untyped complex node. Item Kind must be one of DOCUMENT, DOCUMENT_ELEMENT or ELEMENT.

See Also:

Constant Field Values

XQBASETYPE_XQJ_COMPLEX

public static final int XQBASETYPE_XQJ_COMPLEX

Represents a complex element that has a schema type associated with it. The optional schema information may be available by getting the type name and schema URI. An implementation may not provide the extra details. Valid only when the item kind is XQITEMKIND_DOCUMENT_ELEMENT or XQITEMKIND_ELEMENT.

See Also:

Constant Field Values

XQBASETYPE_ANYTYPE

public static final int XQBASETYPE_ANYTYPE

Represents a complex element with a type annotation of xs:anyType

See Also:

Constant Field Values

XQBASETYPE_ANYSIMPLETYPE

public static final int XQBASETYPE_ANYSIMPLETYPE

Represents the schema type xs:anySimpleType

See Also:

Constant Field Values

XQBASETYPE_ANYATOMICTYPE

public static final int XQBASETYPE_ANYATOMICTYPE

Represents the schema type xs:anyAtomicType

See Also:

Constant Field Values

XQBASETYPE_UNTYPEDATOMIC

public static final int XQBASETYPE_UNTYPEDATOMIC

Represents the schema type xs:untypedAtomic

See Also:

Constant Field Values

XQBASETYPE_DAYTIMEDURATION

public static final int XQBASETYPE_DAYTIMEDURATION

Represents the schema type xs:dayTimeDuration

See Also:

Constant Field Values

XQBASETYPE_YEARMONTHDURATION

public static final int XQBASETYPE_YEARMONTHDURATION

Represents the schema type xs:yearMonthDuration

See Also:

Constant Field Values

XQBASETYPE_ANYURI

public static final int XQBASETYPE_ANYURI

Represents the schema type xs:anyURI

See Also:

Constant Field Values

XQBASETYPE_BASE64BINARY

public static final int XQBASETYPE_BASE64BINARY

Represents the schema type xs:base64Binary

See Also:

Constant Field Values

XQBASETYPE_BOOLEAN

public static final int XQBASETYPE_BOOLEAN

Represents the schema type xs:boolean

See Also:

Constant Field Values

XQBASETYPE_DATE

public static final int XQBASETYPE_DATE

Represents the schema type xs:date

See Also:

Constant Field Values

XQBASETYPE_INT

public static final int XQBASETYPE_INT

Represents the schema type xs:int

See Also:

Constant Field Values

XQBASETYPE_INTEGER

public static final int XQBASETYPE_INTEGER

Represents the schema type xs:integer

See Also:

Constant Field Values

XQBASETYPE_SHORT

public static final int XQBASETYPE_SHORT

Represents the schema type xs:short

See Also:

Constant Field Values

XQBASETYPE_LONG

public static final int XQBASETYPE_LONG

Represents the schema type xs:long

See Also:

Constant Field Values

XQBASETYPE_DATETIME

public static final int XQBASETYPE_DATETIME

Represents the schema type xs:dateTime

See Also:

Constant Field Values

XQBASETYPE_DECIMAL

public static final int XQBASETYPE_DECIMAL

Represents the schema type xs:decimal

See Also:

Constant Field Values

XQBASETYPE_DOUBLE

public static final int XQBASETYPE_DOUBLE

Represents the schema type xs:double

See Also:

Constant Field Values

XQBASETYPE_DURATION

public static final int XQBASETYPE_DURATION

Represents the schema type xs:duration

See Also:

Constant Field Values

XQBASETYPE_FLOAT

public static final int XQBASETYPE_FLOAT

Represents the schema type xs:float

See Also:

Constant Field Values

XQBASETYPE_GDAY

public static final int XQBASETYPE_GDAY

Represents the schema type xs:gDay

See Also:

Constant Field Values

XQBASETYPE_GMONTH

public static final int XQBASETYPE_GMONTH

Represents the schema type xs:gMonth

See Also:

Constant Field Values

XQBASETYPE_GMONTHDAY

public static final int XQBASETYPE_GMONTHDAY

Represents the schema type xs:gMonthDay

See Also:

Constant Field Values

XQBASETYPE_GYEAR

public static final int XQBASETYPE_GYEAR

Represents the schema type xs:gYear

See Also:

Constant Field Values

XQBASETYPE_GYEARMONTH

public static final int XQBASETYPE_GYEARMONTH

Represents the schema type xs:gYearMonth

See Also:

Constant Field Values

XQBASETYPE_HEXBINARY

public static final int XQBASETYPE_HEXBINARY

Represents the schema type xs:hexBinary

See Also:

Constant Field Values

XQBASETYPE_NOTATION

public static final int XQBASETYPE_NOTATION

Represents the schema type xs:NOTATION

See Also:

Constant Field Values

XQBASETYPE_QNAME

public static final int XQBASETYPE_QNAME

Represents the schema type xs:QName

See Also:

Constant Field Values

XQBASETYPE_STRING

public static final int XQBASETYPE_STRING

Represents the schema type xs:string

See Also:

Constant Field Values

XQBASETYPE_TIME

public static final int XQBASETYPE_TIME

Represents the schema type xs:time

See Also:

Constant Field Values

XQBASETYPE_BYTE

public static final int XQBASETYPE_BYTE

Represents the schema type xs:byte

See Also:

Constant Field Values

XQBASETYPE_NONPOSITIVE_INTEGER

public static final int XQBASETYPE_NONPOSITIVE_INTEGER

Represents the schema type xs:nonPositiveInteger

See Also:

Constant Field Values

XQBASETYPE_NONNEGATIVE_INTEGER

public static final int XQBASETYPE_NONNEGATIVE_INTEGER

Represents the schema type xs:nonNegativeInteger

See Also:

Constant Field Values

XQBASETYPE_NEGATIVE_INTEGER

public static final int XQBASETYPE_NEGATIVE_INTEGER

Represents the schema type xs:negativeInteger

See Also:

Constant Field Values

XQBASETYPE_POSITIVE_INTEGER

public static final int XQBASETYPE_POSITIVE_INTEGER

Represents the schema type xs:positiveInteger

See Also:

Constant Field Values

XQBASETYPE_UNSIGNED_LONG

public static final int XQBASETYPE_UNSIGNED_LONG

Represents the schema type xs:unsignedLong

See Also:

Constant Field Values

XQBASETYPE_UNSIGNED_INT

public static final int XQBASETYPE_UNSIGNED_INT

Represents the schema type xs:unsignedInt

See Also:

Constant Field Values

XQBASETYPE_UNSIGNED_SHORT

public static final int XQBASETYPE_UNSIGNED_SHORT

Represents the schema type xs:unsignedShort

See Also:

Constant Field Values

XQBASETYPE_UNSIGNED_BYTE

public static final int XQBASETYPE_UNSIGNED_BYTE

Represents the schema type xs:unsignedByte

See Also:

Constant Field Values

XQBASETYPE_NORMALIZED_STRING

public static final int XQBASETYPE_NORMALIZED_STRING

Represents the schema type xs:normalizedString

See Also:

Constant Field Values

XQBASETYPE_TOKEN

public static final int XQBASETYPE_TOKEN

Represents the schema type xs:token

See Also:

Constant Field Values

XQBASETYPE_LANGUAGE

public static final int XQBASETYPE_LANGUAGE

Represents the schema type xs:language

See Also:

Constant Field Values

XQBASETYPE_NAME

public static final int XQBASETYPE_NAME

Represents the schema type xs:Name

See Also:

Constant Field Values

XQBASETYPE_NCNAME

public static final int XQBASETYPE_NCNAME

Represents the schema type xs:NCName

See Also:

Constant Field Values

XQBASETYPE_NMTOKEN

public static final int XQBASETYPE_NMTOKEN

Represents the schema type xs:NMToken

See Also:

Constant Field Values

XQBASETYPE_ID

public static final int XQBASETYPE_ID

Represents the schema type xs:ID

See Also:

Constant Field Values

XQBASETYPE_IDREF

public static final int XQBASETYPE_IDREF

Represents the schema type xs:IDREF

See Also:

Constant Field Values

XQBASETYPE_ENTITY

public static final int XQBASETYPE_ENTITY

Represents the schema type xs:ENTITY

See Also:

Constant Field Values

XQBASETYPE_IDREFS

public static final int XQBASETYPE_IDREFS

Represents the schema type xs:IDREFS. Valid only if the item kind is XQITEMKIND_ELEMENT, XQITEMKIND_DOCUMENT_ELEMENT, or XQITEMKIND_ATTRIBUTE

See Also:

Constant Field Values

XQBASETYPE_ENTITIES

public static final int XQBASETYPE_ENTITIES

Represents the schema type xs:ENTITIES

See Also:

Constant Field Values

XQBASETYPE_NMTOKENS

public static final int XQBASETYPE_NMTOKENS

Represents the schema type xs:NMTOKENS

See Also:

Constant Field Values

XQBASETYPE_XQJ_LISTTYPE

public static final int XQBASETYPE_XQJ_LISTTYPE

Represents a user-defined list or union type

See Also:

Constant Field Values

Method Detail

getBaseType

public int getBaseType()
                throws XQException

Returns the basic pre-defined type of the item. One of the XQBASETYPE_* constants.

Returns:

int one of the XQBASETYPE_* constants indicating the basic type of the item

Throws:

XQException - if the item kind is not one of: XQITEMKIND_DOCUMENT_ELEMENT, XQITEMKIND_ELEMENT, XQITEMKIND_ATTRIBUTE, or XQITEMKIND_ATOMIC

getItemKind

public int getItemKind()

Returns the basic kind of the item. One of the XQITEMKIND_* constants.

Returns:

int one of the XQITEMKIND_* constants indicating the basic kind of the item

getItemOccurrence

public int getItemOccurrence()

Returns the occurrence indicator for the item type. This method will always return the value XQSequenceType.OCC_EXACTLY_ONE.

Specified by:

getItemOccurrence in interface XQSequenceType

Returns:

int indicating the occurrence indicator

toString

public String toString()

Returns a string representation of the item type.

Specified by:

toString in interface XQSequenceType

Returns:

String a string representation of the item type

getNodeName

public QName getNodeName()
                  throws XQException

Returns the name of the node in case the item kind is an XQITEMKIND_DOCUMENT_ELEMENT, XQITEMKIND_ELEMENT, or XQITEMKIND_ATTRIBUTE. For example, in the case of a type for element "foo" this will return the QName foo. For wildcard entries a null value will be returned.

Returns:

QName for the name of the element, attribute, or document element node. null if it is a wildcard

Throws:

XQException - if the item kind is not one of: XQITEMKIND_DOCUMENT_ELEMENT, XQITEMKIND_ELEMENT, or XQITEMKIND_ATTRIBUTE

getSchemaURI

public URI getSchemaURI()

Returns the schema location URI of the schema that contains the item's element or type definition. This method is implementation defined and an implementation will return a null value if it does not support retrieving the schema location URI. If the item corresponds to a validated global element in a schema, the result will be the schema location URI to the XMLSchema containing the element definition. Otherwise if the item is a schema validated node, the result will be the schema location URI of the XMLSchema containing the type definition of that node. If the item is not schema validated, the result is null

Returns:

URI representing the schema location URI of the XMLSchema containing the global element definition or the type definition of the current item. null in case the item is not schema validated or if the implementation does not support retrieving the schema URI.

getTypeName

public QName getTypeName()
                  throws XQException

Represents a type name (global or local). This can be used to represent specific type name such as, element foo of type hatsize. The schema type name is represented as a single QName. If the return type is an anonymous type, the actual QName value returned is implementation defined.

Returns:

the QName of the schema type in case of a user defined or anonoymous types. For a built-in type, returns a predefined type name as QName (e.g.xs:anyType, xs:decimal, etc). Cannot be null

Throws:

XQException - if the item kind is not one of: XQITEMKIND_DOCUMENT_ELEMENT, XQITEMKIND_ELEMENT, XQITEMKIND_ATTRIBUTE, or XQITEMKIND_ATOMIC

isAnonymousType

public boolean isAnonymousType()

Represents whether the item type is an anonymous type in the schema.

Returns:

true if the item type is an anonymous type in the schema, false otherwise

isElementNillable

public boolean isElementNillable()

Returns whether the element type is nillable or not.

Returns:

true if the element type is nillable, false otherwise

isSchemaElement

public boolean isSchemaElement()

Represents whether the item type represents a schema element or not. This is only relevant for static types.

Returns:

true if the item type represents a schema element, false otherwise

isSchemaAttribute

public boolean isSchemaAttribute()

Represents whether the item type represents a schema attribute or not. This is only relevant for static types.

Returns:

true if the item type represents a schema attribute, false otherwise

getPIName

public String getPIName()
                 throws XQException

Returns the name of the processing instruction type. As such the item kind of this XQItemType must be XQITEMKIND_PI.

Returns:

the name of the processing instruction type. null if it is a wildcard

Throws:

XQException - if the item kind is not XQITEMKIND_PI