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()
Method Detail

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