net.sf.saxon.value

Class AnyURIValue

public final class AnyURIValue extends StringValue

An XPath value of type xs:anyURI.

This is implemented as a subtype of StringValue even though xs:anyURI is not a subtype of xs:string in the XPath type hierarchy. This enables type promotion from URI to String to happen automatically in most cases where it is appropriate.

This implementation of xs:anyURI allows any string to be contained in the value space. It is possible to validate that the string is a "valid URI" in the sense of XML Schema Part 2 (which refers to the XLink specification and to RFC 2396); however, this validation is optional, and is not carried out by default. In particular, there is no constraint that namespace URIs, collation URIs, and the like should be valid URIs. However, casting from strings to xs:anyURI does invoke validation.

Field Summary
static AnyURIValueEMPTY_URI
Constructor Summary
AnyURIValue(CharSequence value)
Constructor
Method Summary
AtomicValueconvertPrimitive(BuiltInAtomicType requiredType, boolean validate, XPathContext context)
Convert to target data type
ObjectconvertToJava(Class target, XPathContext context)
Convert to Java object (for passing to external functions)
booleanequals(Object other)
Determine if two AnyURIValues are equal, according to XML Schema rules.
ItemTypegetItemType(TypeHierarchy th)
Return the type of the expression
static booleanisValidURI(CharSequence value)
Check whether a string consititutes a valid URI

Field Detail

EMPTY_URI

public static final AnyURIValue EMPTY_URI

Constructor Detail

AnyURIValue

public AnyURIValue(CharSequence value)
Constructor

Parameters: value the String value. Null is taken as equivalent to "".

Method Detail

convertPrimitive

public AtomicValue convertPrimitive(BuiltInAtomicType requiredType, boolean validate, XPathContext context)
Convert to target data type

Parameters: requiredType integer code representing the item type required context

Returns: the result of the conversion, or an ErrorValue

convertToJava

public Object convertToJava(Class target, XPathContext context)
Convert to Java object (for passing to external functions)

Parameters: target the Java class to which conversion is required

Returns: the result of the conversion

Throws: XPathException if conversion to this target type is not possible

equals

public boolean equals(Object other)
Determine if two AnyURIValues are equal, according to XML Schema rules. (This method is not used for XPath comparisons, which are always under the control of a collation.)

Throws: ClassCastException if the values are not comparable

getItemType

public ItemType getItemType(TypeHierarchy th)
Return the type of the expression

Parameters: th

Returns: Type.ANY_URI_TYPE (always)

isValidURI

public static boolean isValidURI(CharSequence value)
Check whether a string consititutes a valid URI