net.sf.saxon.type

Class ExternalObjectType

java.lang.Object

net.sf.saxon.type.ExternalObjectType

Direct Known Subclasses:

JavaExternalObjectType

public abstract class ExternalObjectType
extends java.lang.Object

This class represents the type of an external object returned by an extension function, or supplied as an external variable/parameter.

Constructor Summary

Constructors

Constructor and Description
ExternalObjectType()

Method Summary

Modifier and Type	Method and Description
java.lang.String	generateJavaScriptItemTypeAcceptor(java.lang.String errorCode, int targetVersion) Generate Javascript code to convert a supplied Javascript value to this item type, if conversion is possible, or throw an error otherwise.
java.lang.String	generateJavaScriptItemTypeTest(ItemType knownToBe, int targetVersion) Generate Javascript code to test whether an item conforms to this item type
abstract java.lang.String	getName() Get the name of this type.
abstract int	getPrimitiveType() Return the integer fingerprint of the underlying primitive type
abstract java.lang.String	getTargetNamespace() Get the target namespace of this type.
abstract StructuredQName	getTypeName() Get the name of this type
boolean	isExternalType() Ask whether this is an external type
boolean	isPlainType() Ask whether this is a plain type (a type whose instances are always atomic values)

Methods inherited from class java.lang.Object

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

Constructor Detail

ExternalObjectType

public ExternalObjectType()

Method Detail

getName

public abstract java.lang.String getName()

Get the name of this type.

Returns:

the fully qualified name of the Java or .NET class.

getTargetNamespace

public abstract java.lang.String getTargetNamespace()

Get the target namespace of this type. For Java this is always NamespaceConstant.JAVA_TYPE. For .net it is always NamespaceConstant.DOT_NET_TYPE

Returns:

the target namespace of this type definition.

isExternalType

public boolean isExternalType()

Ask whether this is an external type

Returns:

true (it is)

getTypeName

public abstract StructuredQName getTypeName()

Get the name of this type

Returns:

a name whose namespace indicates the space of Java or .net classes, and whose local name is derived from the fully qualified name of the Java or .net class

isPlainType

public final boolean isPlainType()

Ask whether this is a plain type (a type whose instances are always atomic values)

Returns:

false. External object types are not considered to be atomic types

getPrimitiveType

public abstract int getPrimitiveType()

Return the integer fingerprint of the underlying primitive type

Returns:

the fingerprint of the primitive type

generateJavaScriptItemTypeTest

public java.lang.String generateJavaScriptItemTypeTest(ItemType knownToBe,
                                                       int targetVersion)
                                                throws XPathException

Generate Javascript code to test whether an item conforms to this item type

Parameters:

knownToBe -

targetVersion -

Returns:

a Javascript instruction or sequence of instructions, which can be used as the body of a Javascript function, and which returns a boolean indication whether the value of the variable "item" is an instance of this item type.

Throws:

XPathException - if JS code cannot be generated for this item type, for example because the test is schema-aware.

generateJavaScriptItemTypeAcceptor

public java.lang.String generateJavaScriptItemTypeAcceptor(java.lang.String errorCode,
                                                           int targetVersion)
                                                    throws XPathException

Generate Javascript code to convert a supplied Javascript value to this item type, if conversion is possible, or throw an error otherwise.

Parameters:

errorCode - the error to be thrown if conversion is not possible

targetVersion -

Returns:

a Javascript instruction or sequence of instructions, which can be used as the body of a Javascript function, and which returns the result of conversion to this type, or throws an error if conversion is not possible. The variable "val" will hold the supplied Javascript value.

Throws:

XPathException