public class DotNetExtensionFunctionCall extends FunctionCall
Note that the binding of an XPath function call to a .NET method is done in
class DotNetExtensionLibrary
Modifier and Type | Field and Description |
---|---|
static cli.System.Type |
CLI_ARRAYLIST |
static cli.System.Type |
CLI_BOOLEAN |
static cli.System.Type |
CLI_DECIMAL |
static cli.System.Type |
CLI_DOCUMENTINFO |
static cli.System.Type |
CLI_DOUBLE |
static cli.System.Type |
CLI_ICOLLECTION |
static cli.System.Type |
CLI_IENUMERABLE |
static cli.System.Type |
CLI_INT16 |
static cli.System.Type |
CLI_INT32 |
static cli.System.Type |
CLI_INT64 |
static cli.System.Type |
CLI_ITEM |
static cli.System.Type |
CLI_NODEINFO |
static cli.System.Type |
CLI_OBJECT |
static cli.System.Type |
CLI_SEQUENCEITERATOR |
static cli.System.Type |
CLI_SINGLE |
static cli.System.Type |
CLI_STRING |
static cli.System.Type |
CLI_VALUE |
argument
EVALUATE_METHOD, ITERATE_METHOD, locationId, PROCESS_METHOD, staticProperties
Constructor and Description |
---|
DotNetExtensionFunctionCall()
Default constructor
|
Modifier and Type | Method and Description |
---|---|
PathMap.PathMapNodeSet |
addToPathMap(PathMap pathMap,
PathMap.PathMapNodeSet pathMapNodeSet)
Add a representation of this expression to a PathMap.
|
void |
checkArguments(ExpressionVisitor visitor)
Method called by the expression parser when all arguments have been supplied
|
int |
computeCardinality()
Compute the static cardinality of this expression
|
static java.lang.Object |
convertToDotNet(Value value,
cli.System.Type targetType,
XPathContext context)
Convert an XPath value to a .NET object
|
Expression |
copy()
Copy an expression.
|
protected java.lang.Object |
getField(FieldInfo field,
java.lang.Object instance)
Access a field.
|
int |
getIntrinsicDependencies()
Determine which aspects of the context the expression depends on.
|
ItemType |
getItemType(TypeHierarchy th)
Determine the data type of the expression, if possible.
|
protected java.lang.Object |
getProperty(PropertyInfo property,
java.lang.Object instance)
Access a property.
|
cli.System.Type |
getTargetClass()
Get the class containing the method being called
|
MemberInfo |
getTargetMethod()
Get the target method (or field, property, or constructor) being called
|
void |
init(StructuredQName functionName,
cli.System.Type theClass,
MemberInfo object,
Configuration config)
Initialization: creates an ExtensionFunctionCall
|
protected java.lang.Object |
invokeConstructor(ConstructorInfo constructor,
java.lang.Object[] params)
Invoke a constructor.
|
protected java.lang.Object |
invokeMethod(MethodInfo method,
java.lang.Object instance,
java.lang.Object[] params)
Invoke a method.
|
SequenceIterator |
iterate(XPathContext context)
Evaluate the function.
|
Expression |
preEvaluate(ExpressionVisitor visitor)
preEvaluate: this method suppresses compile-time evaluation by doing nothing
(because the external function might have side-effects and might use the context)
|
static cli.System.Type |
type(java.lang.String name) |
addExternalFunctionCallToPathMap, checkArgumentCount, equals, explain, getArguments, getDisplayName, getFunctionName, getNumberOfArguments, hashCode, iterateSubExpressions, optimize, promote, replaceSubExpression, setArguments, setFunctionName, simplify, simplifyArguments, toString, typeCheck
adoptChildExpression, checkForUpdatingSubexpressions, checkPermittedContents, computeDependencies, computeSpecialProperties, computeStaticProperties, display, doPromotion, dynamicError, effectiveBooleanValue, evaluateAsString, evaluateItem, evaluatePendingUpdates, explain, findParentOf, getCardinality, getColumnNumber, getColumnNumber, getConstructType, getContainer, getDependencies, getExecutable, getHostLanguage, getImplementationMethod, getLineNumber, getLineNumber, getLocationId, getLocationProvider, getObjectName, getProperties, getProperty, getPublicId, getSlotsUsed, getSpecialProperties, getSystemId, getSystemId, hasLoopingSubexpression, implementsStaticTypeCheck, isUpdatingExpression, iterateEvents, markTailFunctionCalls, process, resetLocalStaticProperties, setContainer, setFiltered, setFlattened, setLocationId, staticTypeCheck, suppressValidation, typeError
public static cli.System.Type CLI_BOOLEAN
public static cli.System.Type CLI_INT64
public static cli.System.Type CLI_INT32
public static cli.System.Type CLI_INT16
public static cli.System.Type CLI_DOUBLE
public static cli.System.Type CLI_SINGLE
public static cli.System.Type CLI_DECIMAL
public static cli.System.Type CLI_STRING
public static cli.System.Type CLI_OBJECT
public static cli.System.Type CLI_ICOLLECTION
public static cli.System.Type CLI_IENUMERABLE
public static cli.System.Type CLI_ARRAYLIST
public static cli.System.Type CLI_NODEINFO
public static cli.System.Type CLI_DOCUMENTINFO
public static cli.System.Type CLI_ITEM
public static cli.System.Type CLI_VALUE
public static cli.System.Type CLI_SEQUENCEITERATOR
public DotNetExtensionFunctionCall()
public void init(StructuredQName functionName, cli.System.Type theClass, MemberInfo object, Configuration config)
functionName
- the name of the function, for display purposestheClass
- the .NET class containing the method to be calledobject
- the method, field, or constructor of the .NET class to be calledconfig
- the Saxon configurationpublic Expression preEvaluate(ExpressionVisitor visitor)
preEvaluate
in class FunctionCall
visitor
- an expression visitorpublic void checkArguments(ExpressionVisitor visitor) throws XPathException
checkArguments
in class FunctionCall
visitor
- the expression visitorXPathException
public PathMap.PathMapNodeSet addToPathMap(PathMap pathMap, PathMap.PathMapNodeSet pathMapNodeSet)
The default implementation of this method assumes that an expression does no navigation other than the navigation done by evaluating its subexpressions, and that the subexpressions are evaluated in the same context as the containing expression. The method must be overridden for any expression where these assumptions do not hold. For example, implementations exist for AxisExpression, ParentExpression, and RootExpression (because they perform navigation), and for the doc(), document(), and collection() functions because they create a new navigation root. Implementations also exist for PathExpression and FilterExpression because they have subexpressions that are evaluated in a different context from the calling expression.
addToPathMap
in class Expression
pathMap
- the PathMap to which the expression should be addedpathMapNodeSet
- public int getIntrinsicDependencies()
getIntrinsicDependencies
in class Expression
public Expression copy()
copy
in class Expression
public SequenceIterator iterate(XPathContext context) throws XPathException
iterate
in interface SequenceIterable
iterate
in class Expression
context
- The context in which the function is to be evaluatedXPathException
- if the function cannot be evaluated.public cli.System.Type getTargetClass()
public MemberInfo getTargetMethod()
public ItemType getItemType(TypeHierarchy th)
This method will always return a result, though it may be the best approximation that is available at the time.
getItemType
in class Expression
th
- type hierarchy cachepublic int computeCardinality()
Expression
computeCardinality
in class Expression
StaticProperty.ALLOWS_ZERO_OR_ONE
,
StaticProperty.EXACTLY_ONE
, StaticProperty.ALLOWS_ONE_OR_MORE
,
StaticProperty.ALLOWS_ZERO_OR_MORE
protected java.lang.Object invokeConstructor(ConstructorInfo constructor, java.lang.Object[] params) throws java.lang.InstantiationException, java.lang.IllegalAccessException, java.lang.reflect.InvocationTargetException
constructor
- The constructor to be invokedparams
- The parameters to be passed to the constructorjava.lang.InstantiationException
- if the invocation throws an InstantiationExceptionjava.lang.IllegalAccessException
- if the invocation throws an IllegalAccessExceptionjava.lang.reflect.InvocationTargetException
- if the invocation throws an InvocationTargetException (which happens
when the constructor itself throws an exception)protected java.lang.Object invokeMethod(MethodInfo method, java.lang.Object instance, java.lang.Object[] params) throws java.lang.IllegalAccessException, java.lang.reflect.InvocationTargetException
method
- The method to be invokedinstance
- The object on which the method is to be invoked. This is set to null if the
method is static.params
- The parameters to be passed to the methodjava.lang.IllegalAccessException
- if the invocation throws an IllegalAccessExceptionjava.lang.reflect.InvocationTargetException
- if the invocation throws an InvocationTargetException (which happens
when the method itself throws an exception)protected java.lang.Object getProperty(PropertyInfo property, java.lang.Object instance) throws java.lang.IllegalAccessException
property
- The property to be retrievedinstance
- The object whose property is to be retrieved. This is set to null if the
property is static.java.lang.IllegalAccessException
- if the invocation throws an IllegalAccessExceptionprotected java.lang.Object getField(FieldInfo field, java.lang.Object instance) throws java.lang.IllegalAccessException
field
- The field to be retrievedinstance
- The object whose field is to be retrieved. This is set to null if the
field is static.java.lang.IllegalAccessException
- if the invocation throws an IllegalAccessExceptionpublic static java.lang.Object convertToDotNet(Value value, cli.System.Type targetType, XPathContext context) throws XPathException
value
- the XPath value to be convertedtargetType
- the target type of the .NET objectcontext
- XPath dynamic contextXPathException
public static cli.System.Type type(java.lang.String name)