|
|||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | ||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |
java.lang.Objectnet.sf.saxon.expr.Expression
net.sf.saxon.expr.FunctionCall
net.sf.saxon.dotnet.DotNetExtensionFunctionCall
public class DotNetExtensionFunctionCall
This class acts as a container for an extension function defined to call a method in a user-defined .NET class.
Note that the binding of an XPath function call to a .NET method is done in
class DotNetExtensionLibrary
Field Summary | |
---|---|
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
|
Fields inherited from class net.sf.saxon.expr.FunctionCall |
---|
argument |
Fields inherited from class net.sf.saxon.expr.Expression |
---|
EVALUATE_METHOD, ITERATE_METHOD, locationId, PROCESS_METHOD, staticProperties |
Constructor Summary | |
---|---|
DotNetExtensionFunctionCall()
Default constructor |
Method Summary | |
---|---|
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 Value |
convertFromDotNet(java.lang.Object result,
cli.System.Type returnType,
XPathContext context)
|
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)
|
Methods inherited from class net.sf.saxon.expr.FunctionCall |
---|
addExternalFunctionCallToPathMap, checkArgumentCount, equals, explain, getArguments, getDisplayName, getFunctionName, getNumberOfArguments, hashCode, iterateSubExpressions, optimize, promote, replaceSubExpression, setArguments, setFunctionName, simplify, simplifyArguments, toString, typeCheck |
Methods inherited from class java.lang.Object |
---|
clone, finalize, getClass, notify, notifyAll, wait, wait, wait |
Field Detail |
---|
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
Constructor Detail |
---|
public DotNetExtensionFunctionCall()
Method Detail |
---|
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 visitor
public void checkArguments(ExpressionVisitor visitor) throws XPathException
checkArguments
in class FunctionCall
visitor
- the expression visitor
XPathException
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 evaluated
XPathException
- 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 cache
public 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 constructor
java.lang.InstantiationException
- if the invocation throws an InstantiationException
java.lang.IllegalAccessException
- if the invocation throws an IllegalAccessException
java.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 method
java.lang.IllegalAccessException
- if the invocation throws an IllegalAccessException
java.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 context
XPathException
public static cli.System.Type type(java.lang.String name)
public static Value convertFromDotNet(java.lang.Object result, cli.System.Type returnType, XPathContext context)
|
|||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | ||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |