org.springframework.util
Class MethodInvoker

java.lang.Object
  org.springframework.util.MethodInvoker

Direct Known Subclasses:

MethodInvokingFactoryBean, MethodInvokingJobDetailFactoryBean, MethodInvokingTimerTaskFactoryBean

public class MethodInvoker

extends java.lang.Object

Helper class that allows to specify a method to invoke in a declarative fashion, be it static or non-static.

Usage: Specify targetClass/targetMethod respectively targetObject/targetMethod, optionally specify arguments, prepare the invoker. Afterwards, you can invoke the method any number of times.

Typically not used directly but via its subclasses MethodInvokingFactoryBean and MethodInvokingJobDetailFactoryBean.

Since:

19.02.2004

Author:

Colin Sampaleanu, Juergen Hoeller

See Also:

prepare(), invoke(), MethodInvokingFactoryBean, MethodInvokingJobDetailFactoryBean

Nested Class Summary

static class

MethodInvoker.VoidType Special marker class used for a void return value, differentiating void from a null value returned by the method.

Field Summary

static MethodInvoker.VoidType

VOID

Constructor Summary

MethodInvoker()

Method Summary

java.lang.Object[]	getArguments()
java.lang.reflect.Method	getPreparedMethod() Return the prepared Method object that will be invoker.
java.lang.Class	getTargetClass() Return the target class on which to call the target method.
java.lang.String	getTargetMethod() Return the name of the method to be invoked.
java.lang.Object	getTargetObject() Return the target object on which to call the target method.
java.lang.Object	invoke() Invoke the specified method.
void	prepare() Prepare the specified method.
void	setArguments(java.lang.Object[] arguments) Set arguments for the method invocation.
void	setStaticMethod(java.lang.String staticMethod) Set a fully qualified static method name to invoke, e.g.
void	setTargetClass(java.lang.Class targetClass) Set the target class on which to call the target method.
void	setTargetMethod(java.lang.String targetMethod) Set the name of the method to be invoked.
void	setTargetObject(java.lang.Object targetObject) Set the target object on which to call the target method.

Methods inherited from class java.lang.Object

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

Field Detail

VOID

public static final MethodInvoker.VoidType VOID

Constructor Detail

MethodInvoker

public MethodInvoker()

Method Detail

setTargetClass

public void setTargetClass(java.lang.Class targetClass)

Set the target class on which to call the target method. Only necessary when the target method is static; else, a target object needs to be specified anyway.

See Also:

setTargetObject(java.lang.Object), setTargetMethod(java.lang.String)

getTargetClass

public java.lang.Class getTargetClass()

Return the target class on which to call the target method.

setTargetObject

public void setTargetObject(java.lang.Object targetObject)

Set the target object on which to call the target method. Only necessary when the target method is not static; else, a target class is sufficient.

See Also:

setTargetClass(java.lang.Class), setTargetMethod(java.lang.String)

getTargetObject

public java.lang.Object getTargetObject()

Return the target object on which to call the target method.

setTargetMethod

public void setTargetMethod(java.lang.String targetMethod)

Set the name of the method to be invoked. Refers to either a static method or a non-static method, depending on a target object being set.

See Also:

setTargetClass(java.lang.Class), setTargetObject(java.lang.Object)

getTargetMethod

public java.lang.String getTargetMethod()

Return the name of the method to be invoked.

setStaticMethod

public void setStaticMethod(java.lang.String staticMethod)
                     throws java.lang.ClassNotFoundException

Set a fully qualified static method name to invoke, e.g. "example.MyExampleClass.myExampleMethod". Convenient alternative to specifying targetClass and targetMethod.

Throws:

java.lang.ClassNotFoundException

See Also:

setTargetClass(java.lang.Class), setTargetMethod(java.lang.String)

setArguments

public void setArguments(java.lang.Object[] arguments)

Set arguments for the method invocation. If this property is not set, or the Object array is of length 0, a method with no arguments is assumed.

getArguments

public java.lang.Object[] getArguments()

prepare

public void prepare()
             throws java.lang.ClassNotFoundException,
                    java.lang.NoSuchMethodException

Prepare the specified method. The method can be invoked any number of times afterwards.

Throws:

java.lang.ClassNotFoundException

java.lang.NoSuchMethodException

See Also:

getPreparedMethod(), invoke()

getPreparedMethod

public java.lang.reflect.Method getPreparedMethod()

Return the prepared Method object that will be invoker. Can for example be used to determine the return type.

See Also:

prepare(), invoke()

invoke

public java.lang.Object invoke()
                        throws java.lang.reflect.InvocationTargetException,
                               java.lang.IllegalAccessException

Invoke the specified method. The invoker needs to have been prepared before.

Returns:

the object returned by the method invocation, or VOID if the method returns void

Throws:

java.lang.reflect.InvocationTargetException

java.lang.IllegalAccessException

See Also:

prepare(), VOID