software.amazon.awssdk.utils

Class ReflectionMethodInvoker<T,R>

java.lang.Object

software.amazon.awssdk.utils.ReflectionMethodInvoker<T,R>

Type Parameters:

T - The class type that has the method to be invoked.

R - The expected return type of the method invocation.

public class ReflectionMethodInvoker<T,R>
extends Object

This class acts as a proxy to invoke a specific method on objects of a specific class. It will use the JDK's reflection library to find and invoke the method.

The relatively expensive call to find the correct method on the class is lazy and will not be performed until the first invocation or until the invoker is explicitly initialized. Once found, the method is cached so repeated calls to initialize() or invoke() will not incur the reflection cost of searching for the method on the class.

Example: ReflectionMethodInvoker<String, Integer> invoker = new ReflectionMethodInvoker<String, Integer>(String.class, Integer.class, "indexOf", String.class, int.class); invoker.invoke("ababab", "ab", 1); // This is equivalent to calling "ababab".indexOf("ab", 1);

Constructor Summary

Constructors

Constructor and Description
ReflectionMethodInvoker(Class<T> clazz, Class<R> returnType, String methodName, Class<?>... parameterTypes) Construct an instance of ReflectionMethodInvoker.

Method Summary

Modifier and Type	Method and Description
void	initialize() Initializes the method invoker by finding and caching the target method from the target class that will be used for subsequent invoke operations.
R	invoke(T obj, Object... args) Attempt to invoke the method this proxy targets for on the given object with the given arguments.
boolean	isInitialized() Gets the initialization state of the invoker.

Methods inherited from class java.lang.Object

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

Constructor Detail

ReflectionMethodInvoker

public ReflectionMethodInvoker(Class<T> clazz,
                               Class<R> returnType,
                               String methodName,
                               Class<?>... parameterTypes)

Construct an instance of ReflectionMethodInvoker.

This constructor will not make any reflection calls as part of initialization; i.e. no validation of the existence of the given method signature will occur.

Parameters:

clazz - The class that has the method to be invoked.

returnType - The expected return class of the method invocation. The object returned by the invocation will be cast to this class.

methodName - The name of the method to invoke.

parameterTypes - The classes of the parameters of the method to invoke.

Method Detail

invoke

public R invoke(T obj,
                Object... args)
         throws NoSuchMethodException

Attempt to invoke the method this proxy targets for on the given object with the given arguments. If the invoker has not yet been initialized, an attempt to initialize the invoker will be made first. If the call succeeds the invoker will be in an initialized state after this call and future calls to the same method will not incur an initialization cost. If the call fails because the target method could not be found, the invoker will remain in an uninitialized state after the exception is thrown.

Parameters:

obj - The object to invoke the method on.

args - The arguments to pass to the method. These arguments must match the signature of the method.

Returns:

The returned value of the method cast to the 'returnType' class that this proxy was initialized with.

Throws:

NoSuchMethodException - if the JVM could not find a method matching the signature specified in the initialization of this proxy.

RuntimeException - if any other exception is thrown when attempting to invoke the method or by the method itself. The cause of this exception will be the exception that was actually thrown.

initialize

public void initialize()
                throws NoSuchMethodException

Initializes the method invoker by finding and caching the target method from the target class that will be used for subsequent invoke operations. If the invoker is already initialized this call will do nothing.

Throws:

NoSuchMethodException - if the JVM could not find a method matching the signature specified in the initialization of this proxy.

isInitialized

public boolean isInitialized()

Gets the initialization state of the invoker.

Returns:

true if the invoker has been initialized and the method has been cached for invocation; otherwise false.