java.io.Serializable
, PullEvent
, SequenceIterable
, GroundedValue
, Item
, ValueRepresentation
, ConversionResult
public final class AnyURIValue extends StringValue
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.
StringValue.CharacterIterator
Modifier and Type | Field | Description |
---|---|---|
static AnyURIValue |
EMPTY_URI |
typeLabel
EMPTY_STRING, FALSE, length, SINGLE_SPACE, TRUE, value
EMPTY_CLASS_ARRAY, INDETERMINATE_ORDERING
EMPTY_VALUE_ARRAY
Constructor | Description |
---|---|
AnyURIValue(java.lang.CharSequence value) |
Constructor
|
AnyURIValue(java.lang.CharSequence value,
AtomicType type) |
Constructor for a user-defined subtype of anyURI
|
Modifier and Type | Method | Description |
---|---|---|
ConversionResult |
convertPrimitive(BuiltInAtomicType requiredType,
boolean validate,
XPathContext context) |
Convert to target data type
|
AtomicValue |
copyAsSubType(AtomicType typeLabel) |
Create a copy of this atomic value, with a different type label
|
BuiltInAtomicType |
getPrimitiveType() |
Determine the primitive type of the value.
|
static boolean |
isValidURI(java.lang.CharSequence value) |
Check whether a string consititutes a valid URI
|
asAtomic, checkPermittedContents, convert, convert, getCardinality, getComponent, getItemType, getLength, getTypedValue, getTypeLabel, isNaN, itemAt, iterate, process, setTypeLabel, subsequence
clone, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait
codepointEquals, containsSurrogatePairs, contract, convertStringToAtomicType, convertStringToBuiltInType, diagnosticDisplay, effectiveBooleanValue, equals, expand, expand, getSchemaComparable, getStringLength, getStringLength, getStringValue, getStringValueCS, getXPathComparable, isZeroLength, iterateCharacters, makeRestrictedString, makeStringValue, setStringValueCS, toString, validate
asItem, asItem, asIterator, asValue, convertToJava, fromItem, getCanonicalLexicalRepresentation, getIterator, iterate, makeQNameValue, reduce, stringToNumber
public static final AnyURIValue EMPTY_URI
public AnyURIValue(java.lang.CharSequence value)
value
- the String value. Null is taken as equivalent to "". This constructor
does not check that the value is a valid anyURI instance.public AnyURIValue(java.lang.CharSequence value, AtomicType type)
value
- the String value. Null is taken as equivalent to "".type
- a user-defined subtype of anyURI. It is the caller's responsibility
to ensure that this is actually a subtype of anyURI, and that the value conforms
to the definition of this type.public AtomicValue copyAsSubType(AtomicType typeLabel)
copyAsSubType
in class StringValue
typeLabel
- the type label of the new copy. The caller is responsible for checking that
the value actually conforms to this type.public static boolean isValidURI(java.lang.CharSequence value)
value
- the string to be testedpublic BuiltInAtomicType getPrimitiveType()
StringValue
getPrimitiveType
in class StringValue
public ConversionResult convertPrimitive(BuiltInAtomicType requiredType, boolean validate, XPathContext context)
convertPrimitive
in class StringValue
requiredType
- integer code representing the item type requiredcontext
- the XPath dynamic evaluation contextvalidate
- true if validation is required. If set to false, the caller guarantees that
the value is valid for the target data type, and that further validation is therefore not required.
Note that a validation failure may be reported even if validation was not requested.