Class MethodExecutionStrategy

java.lang.Object

ch.obermuhlner.scriptengine.java.execution.MethodExecutionStrategy

All Implemented Interfaces:

ExecutionStrategy

public class MethodExecutionStrategy
extends Object
implements ExecutionStrategy

The ExecutionStrategy that executes a specific method. This implementation has three static constructor methods to define the method that should be called:

• byMethod(Method, Object...) to call the specified method and pass it the specified arguments.
• byArgumentTypes(Class, String, Class[], Object...) to call the public method with the specified argument types and pass it the specified arguments.
• byMatchingArguments(Class, String, Object...) to call a public method that matches the specified arguments.

Method Summary

Modifier and Type	Method	Description
static MethodExecutionStrategy	byArgumentTypes(Class<?> clazz, String methodName, Class<?>[] argumentTypes, Object... arguments)	Creates a MethodExecutionStrategy that will call the public method with the specified argument types and passes the specified argument list.
static MethodExecutionStrategy	byMainMethod(Class<?> clazz, String... arguments)	Creates a MethodExecutionStrategy that will call the public static void main(String[] args) with the specified arguments.
static MethodExecutionStrategy	byMatchingArguments(Class<?> clazz, String methodName, Object... arguments)	Creates a MethodExecutionStrategy that will call a public method that matches the specified arguments.
static MethodExecutionStrategy	byMethod(Method method, Object... arguments)	Creates a MethodExecutionStrategy that will call the specified Method.
Object	execute(Object instance)	Executes a method on an object instance, or a static method if the specified instance is null.

Methods inherited from class Object

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

Method Details

execute

public Object execute(Object instance)
               throws ScriptException

Description copied from interface: ExecutionStrategy

Executes a method on an object instance, or a static method if the specified instance is null.

Specified by:

execute in interface ExecutionStrategy

Parameters:

instance - the object instance to be executed or null to execute a static method

Returns:

the return value of the method, or null

Throws:

ScriptException - if no method to execute was found

byMethod

public static MethodExecutionStrategy byMethod(Method method,
 Object... arguments)

Creates a MethodExecutionStrategy that will call the specified Method.

Parameters:

method - the Method to execute

arguments - the arguments to be passed to the method

Returns:

the value returned by the method, or null

byMainMethod

public static MethodExecutionStrategy byMainMethod(Class<?> clazz,
 String... arguments)
                                            throws ScriptException

Creates a MethodExecutionStrategy that will call the public static void main(String[] args) with the specified arguments.

Parameters:

clazz - the Class

arguments - the arguments to pass to the main method

Returns:

the created MethodExecutionStrategy

Throws:

ScriptException - if no public static void main(String[] args) method was found

byArgumentTypes

public static MethodExecutionStrategy byArgumentTypes(Class<?> clazz,
 String methodName,
 Class<?>[] argumentTypes,
 Object... arguments)
                                               throws ScriptException

Creates a MethodExecutionStrategy that will call the public method with the specified argument types and passes the specified argument list.

Parameters:

clazz - the Class

methodName - the method name

argumentTypes - the argument types defining the constructor to call

arguments - the arguments to pass to the constructor (may contain null)

Returns:

the created MethodExecutionStrategy

Throws:

ScriptException - if no matching public method was found

byMatchingArguments

public static MethodExecutionStrategy byMatchingArguments(Class<?> clazz,
 String methodName,
 Object... arguments)
                                                   throws ScriptException

Creates a MethodExecutionStrategy that will call a public method that matches the specified arguments. A method must match all specified arguments, except null values which match any non-primitive type. The conversion from object types into corresponding primitive types (for example Integer into int) is handled automatically.

Parameters:

clazz - the Class

methodName - the method name

arguments - the arguments to be passed to the method

Returns:

the created MethodExecutionStrategy

Throws:

ScriptException - if no matching public method was found