net.sf.saxon.value
Class AtomicValue

java.lang.Object
  |
  +--net.sf.saxon.value.Value
        |
        +--net.sf.saxon.value.AtomicValue

All Implemented Interfaces:

Expression, Item, java.io.Serializable

Direct Known Subclasses:

AnyURIValue, Base64BinaryValue, BooleanValue, CalendarValue, DerivedAtomicValue, DurationValue, HexBinaryValue, NumericValue, ObjectValue, QNameValue, StringValue

public abstract class AtomicValue

extends Value

implements Item

A AtomicValue is a value that isn't a sequence and isn't a node. More strictly, it is any sequence of length one whose content is not a node.

See Also:

Serialized Form

Constructor Summary

AtomicValue()

 

Method Summary
int	conversionPreference(java.lang.Class required, Configuration config)           Get conversion preference for this value to a Java class.
AtomicValue	convert(AtomicType targetType)           Convert the value to a given type.
abstract  AtomicValue	convert(int requiredType)           Convert the value to a given type.
java.lang.Object	convertToJava(java.lang.Class target, Configuration config)           Convert to Java object (for passing to external functions)
boolean	effectiveBooleanValue(XPathContext context)           Get the effective boolean value of the value
java.lang.String	evaluateAsString(XPathContext context)           Evaluate as a string
Item	evaluateItem(XPathContext context)           Evaluate the value (this simply returns the value unchanged)
int	getCardinality()           Determine the static cardinality
AtomicValue	getComponent(int component)           Method to extract components of a value.
AtomicValue	getPrimitiveValue()           Get the primitive value (the value in the value space).
SequenceIterator	getTypedValue(Configuration config)           Get the typed value of this item
SequenceIterator	iterate(XPathContext context)           Iterate over the (single) item in the sequence

 

Methods inherited from class net.sf.saxon.value.Value

analyze, asItem, asValue, collapseWhitespace, getDependencies, getSpecialProperties, getStringValue, getSubExpressions, inverse, normalizeWhitespace, promote, simplify, stringToNumber, trimWhitespace

 

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

 

Methods inherited from interface net.sf.saxon.om.Item

getStringValue

 

Methods inherited from interface net.sf.saxon.expr.Expression

display, getItemType

 

Constructor Detail

AtomicValue

public AtomicValue()

getCardinality

public final int getCardinality()

Determine the static cardinality

Specified by:

getCardinality in interface Expression

Returns:

code identifying the cardinality

See Also:

Cardinality

convert

public abstract AtomicValue convert(int requiredType)
                             throws XPathException

Convert the value to a given type. The result of the conversion will be an atomic value of the required type. This method works only where the target type is a built-in type.

Parameters:

requiredType - type code of the required atomic type

Returns:

the result of the conversion, if conversion was possible. This will always be an instance of the class corresponding to the type of value requested

Throws:

XPathException - if conversion is not allowed for this required type, or if the particular value cannot be converted

convert

public final AtomicValue convert(AtomicType targetType)
                          throws XPathException

Convert the value to a given type. The result of the conversion will be an atomic value of the required type. This method works where the target type is a built-in atomic type and also where it is a user-defined atomic type.

XPathException

evaluateItem

public Item evaluateItem(XPathContext context)
                  throws XPathException

Evaluate the value (this simply returns the value unchanged)

Specified by:

evaluateItem in interface Expression

Parameters:

context - the evaluation context (not used in this implementation)

Returns:

the value, unchanged

Throws:

XPathException

iterate

public final SequenceIterator iterate(XPathContext context)

Iterate over the (single) item in the sequence

Specified by:

iterate in interface Expression

Parameters:

context - the evaluation context (not used in this implementation)

Returns:

a SequenceIterator that iterates over the single item in this value

evaluateAsString

public final java.lang.String evaluateAsString(XPathContext context)
                                        throws XPathException

Evaluate as a string

Specified by:

evaluateAsString in interface Expression

Parameters:

context - The context in which the expression is to be evaluated

Returns:

the value of the expression, evaluated in the current context. The expression must return a string or (); if the value of the expression is (), this method returns "".

Throws:

XPathException - if any dynamic error occurs evaluating the expression

getTypedValue

public final SequenceIterator getTypedValue(Configuration config)

Get the typed value of this item

Specified by:

getTypedValue in interface Item

Parameters:

config - the configuration: this is needed because it provides access to schema information needed to interpret the type annotation

Returns:

the typed value of the expression (which is this value)

getPrimitiveValue

public AtomicValue getPrimitiveValue()

Get the primitive value (the value in the value space). This returns an AtomicValue of a class that would be used to represent the primitive value. In effect this means that for built-in types, it returns the value itself, but for user-defined type, it returns the primitive value minus the type annotation

effectiveBooleanValue

public boolean effectiveBooleanValue(XPathContext context)

Get the effective boolean value of the value

Specified by:

effectiveBooleanValue in interface Expression

Parameters:

context - the evaluation context (not used in this implementation)

Returns:

true, unless the value is boolean false, numeric zero, or zero-length string

getComponent

public AtomicValue getComponent(int component)
                         throws XPathException

Method to extract components of a value. Implemented by some subclasses, but defined at this level for convenience

XPathException

conversionPreference

public int conversionPreference(java.lang.Class required,
                                Configuration config)

Get conversion preference for this value to a Java class. A low result indicates higher preference. This method is overridden in subclasses, but it contains common functionality to supply a scalar value to a method expecting a list or iterator.

Specified by:

conversionPreference in class Value

convertToJava

public java.lang.Object convertToJava(java.lang.Class target,
                                      Configuration config)
                               throws XPathException

Convert to Java object (for passing to external functions)

Specified by:

convertToJava in class Value

Parameters:

target - The class required by the external function

config - The configuration (needed for access to schema information)

Returns:

an object of the target class

XPathException