net.oneandone.mork.reflect

Class Function

java.lang.Object

net.oneandone.mork.reflect.Function

All Implemented Interfaces:

Serializable

Direct Known Subclasses:

CompiledFunctionBase, Composition, Constant, Constructor, Field, Identity, Method, Option, ToArray

public abstract class Function
extends Object
implements Serializable

Interface for anything that can be invoked. Every function has a name, a return type, and parameter types. Invocations takes an array with the number of parameters. Each element must be assignable to the corresponding argument types. Invocations return an Object assignable to the function's return type. Use Object types to get around "static" type checking.

Note: Java reflection automatically wraps and unwraps primitive types, but not arrays of primitive types.

See Also:

Serialized Form

Field Summary

Fields

Modifier and Type	Field and Description
static Class<?>[]	NO_CLASSES

Constructor Summary

Constructors

Constructor and Description
Function()

Method Summary

Modifier and Type	Method and Description
abstract Class<?>[]	getExceptionTypes()
abstract String	getName() Gets the Function name.
abstract Class<?>[]	getParameterTypes() Gets the parameter types of this function.
abstract Class<?>	getReturnType() Gets the return type of this Function.
abstract Object	invoke(Object[] vals) Invokes the function.
Object	invokeN()
Object	invokeN(Object a)
Object	invokeN(Object a, Object b)
Object	invokeN(Object a, Object b, Object c)
boolean	matches(Class<?>[] args) Tests if the functions can be called with arguments of the specified types.
String	toString() Gets a String representation for this Function.
abstract void	translate(Code dest) Generate bytecode equivalent to invoke().

Methods inherited from class java.lang.Object

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

Field Detail

NO_CLASSES

public static final Class<?>[] NO_CLASSES

Constructor Detail

Function

public Function()

Method Detail

getName

public abstract String getName()

Gets the Function name.

Returns:

name the Function name

getReturnType

public abstract Class<?> getReturnType()

Gets the return type of this Function. Every invocation of this Function returns a value assignable to the type returned by this method.

Returns:

the return type of the Function

getParameterTypes

public abstract Class<?>[] getParameterTypes()

Gets the parameter types of this function.

Returns:

parameter types

getExceptionTypes

public abstract Class<?>[] getExceptionTypes()

invoke

public abstract Object invoke(Object[] vals)
                       throws InvocationTargetException

Invokes the function. API.

Parameters:

vals - arguments to call the Function with; length and types must conform the argument count and the argument types of the Function

Returns:

what the functions returned; the type must conform the return type of the Function

Throws:

InvocationTargetException

invokeN

public Object invokeN()
               throws InvocationTargetException

Throws:

InvocationTargetException

invokeN

public Object invokeN(Object a)
               throws InvocationTargetException

Throws:

InvocationTargetException

invokeN

public Object invokeN(Object a,
                      Object b)
               throws InvocationTargetException

Throws:

InvocationTargetException

invokeN

public Object invokeN(Object a,
                      Object b,
                      Object c)
               throws InvocationTargetException

Throws:

InvocationTargetException

matches

public boolean matches(Class<?>[] args)

Tests if the functions can be called with arguments of the specified types.

Parameters:

args - arguement types

Returns:

true, if the function can be called with these types

toString

public String toString()

Gets a String representation for this Function. Implementors don't need to overwrite this methods, a reasonable representation can be built using the Function name, the return type and the argument types.

Overrides:

toString in class Object

Returns:

the String representation

translate

public abstract void translate(Code dest)

Generate bytecode equivalent to invoke(). The generated code expects arguments and the result on the operand stack.