|
|||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | ||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |
java.lang.Object net.sf.saxon.s9api.XdmValue net.sf.saxon.s9api.XdmItem
public abstract class XdmItem
The class XdmItem represents an item in a sequence, as defined by the XDM data model. An item is either an atomic value or a node.
An item is a member of a sequence, but it can also be considered as a sequence (of length one) in its own right. XdmItem is a subtype of XdmValue because every Item in the XDM data model is also a value.
It cannot be assumed that every sequence of length one will be represented by an XdmItem. It is quite possible for an XdmValue that is not an XdmItem to hold a singleton sequence.
Saxon provides two concrete subclasses of XdmItem
, namely
XdmNode
and XdmAtomicValue
. Users must not attempt to create
additional subclasses.
Constructor Summary | |
---|---|
protected |
XdmItem()
|
protected |
XdmItem(Item item)
Construct an XdmItem as a wrapper around an existing NodeInfo object |
Method Summary | |
---|---|
String |
getStringValue()
Get the string value of the item. |
boolean |
isAtomicValue()
Determine whether the item is an atomic value or a node |
static XdmItem |
newAtomicValue(String value,
ItemType type)
Deprecated. since 9.1. This factory method duplicates the constructor XdmAtomicValue.XdmAtomicValue(String, ItemType) which should be used in preference |
int |
size()
Get the number of items in the sequence |
protected static XdmItem |
wrapItem(Item item)
|
Methods inherited from class net.sf.saxon.s9api.XdmValue |
---|
append, getUnderlyingValue, itemAt, iterator, setValue, wrap |
Methods inherited from class java.lang.Object |
---|
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait |
Constructor Detail |
---|
protected XdmItem()
protected XdmItem(Item item)
item
- the NodeInfo object to be wrapped. This can be retrieved using the
XdmValue.getUnderlyingValue()
method.
NullPointerException
- if item is nullMethod Detail |
---|
protected static XdmItem wrapItem(Item item)
public static XdmItem newAtomicValue(String value, ItemType type) throws SaxonApiException
XdmAtomicValue.XdmAtomicValue(String, ItemType)
which should be used in preference
value
- the lexical representation of the required valuetype
- the item type of the required value
SaxonApiException
- if the supplied string is not in the lexical space of the target type, or
if the target type is not atomicpublic String getStringValue()
For atomic values, the result is the same as the result of calling
toString
. This is not the case for nodes, where toString
returns an XML serialization of the node.
public boolean isAtomicValue()
public int size()
size
in class XdmValue
|
|||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | ||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |