ReflectionInvoker (srp-reflection 0.8.3 API)

java.lang.Object
- org.srplib.reflection.ReflectionInvoker<T,V>

public class ReflectionInvoker<T,V>
extends java.lang.Object

Simplifies method invocation via reflection.

Encapsulates method signature: class, parameter parameters. So invoker may be reused to create multiple instances.
Wraps checked exception into unchecked.
Provides very detailed error message.

Client should specify parameters for a method invocation.

      // Using ReflectionUtils
      ReflectionUtils.newInstance(Person.class,
          new Class[] {String.class, String.class, int.class},
          new Object[] {"John", "Smith", 35})

      // Using ReflectionInvoker
      Person person = ReflectionInvoker.constructor(Person.class)
          .parameters(String.class, String.class, int.class)
          .invoke("John", "Smith", 35);

      // Invoke constructor without parameters
      ReflectionInvoker.constructor(Person.class).invoke();

      // Invoke method
      Person person = ...
      ReflectionInvoker.method(person, "setName").invoke("James");

      // Create invoker for multiple invocations
      ReflectionInvoker invoker = ReflectionInvoker.method(person, "setName");
      invoker.invoke("John");
      ...
      invoker.invoke("James");

      // Create invoker for multiple constructor invocation
      ReflectionInvoker invoker = ReflectionInvoker.constructor(Person.class).parameters(String.class, Integer.class);

      Person john = invoker.invoke("John", 24);
      Person james = invoker.invoke("James", 33);

Constructor Summary

Constructors
Constructor and Description
`ReflectionInvoker(java.lang.Class<T> clazz, java.lang.String methodName, java.lang.Class<?>... parameters)` Creates builder for specified class.

Method Summary

All Methods Static Methods Instance Methods Concrete Methods
Modifier and Type	Method and Description
`static <T> ReflectionInvoker<T,T>`	`constructor(java.lang.Class<T> clazz)` Create constructor invoker.
`ReflectionInvoker<T,V>`	`errorMessage(java.lang.String pattern, java.lang.Object... parameters)` An error message to be added to standard exception message.
`V`	`invoke(java.lang.Object... arguments)` Creates new instance.
`static <T> T`	`invokeMethod(java.lang.Object target, java.lang.reflect.Method method, java.lang.Object... arguments)` Invokes specified method of specified target using reflection.
`static <T,V> ReflectionInvoker<T,V>`	`method(java.lang.Class<T> clazz, java.lang.String methodName)` Create method invoker for specified class and method name.
`static <T,V> ReflectionInvoker<T,V>`	`method(T target, java.lang.String methodName)` Create method invoker for specified method of target object.
`static <T> T`	`newInstance(java.lang.Class<T> clazz, java.lang.Class[] parameters, java.lang.Object[] arguments)` Creates instance of specified class and wraps checked exceptions into unchecked ones.
`ReflectionInvoker<T,V>`	`parameters(java.lang.Class<?>... parameters)` Specify parameter parameters as vararg.
`ReflectionInvoker<T,V>`	`parameters(java.util.List<java.lang.Class<?>> types)` Specify parameter parameters as list.
`ReflectionInvoker<T,V>`	`target(T target)` Specify parameter parameters as list.

Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

- Constructor Detail
  - ReflectionInvoker
```
public ReflectionInvoker(java.lang.Class<T> clazz,
                         java.lang.String methodName,
                         java.lang.Class<?>... parameters)
```
    Creates builder for specified class.
    
    Parameters:
    
    clazz - Class a class to create instance of
- Method Detail
  - constructor
```
public static <T> ReflectionInvoker<T,T> constructor(java.lang.Class<T> clazz)
```
    Create constructor invoker.
    
    Parameters:
    
    clazz - Class a class to create instance of
    
    Returns:
    
    ReflectionInvoker
  - method
```
public static <T,V> ReflectionInvoker<T,V> method(java.lang.Class<T> clazz,
                                                  java.lang.String methodName)
```
    Create method invoker for specified class and method name.
    This method is used if target object isn't known and should be provided later with target method.
    
    Parameters:
    
    clazz - Class a class of target object
    
    methodName - String name of method to invoke
    
    Returns:
    
    ReflectionInvoker
  - method
```
public static <T,V> ReflectionInvoker<T,V> method(T target,
                                                  java.lang.String methodName)
```
    Create method invoker for specified method of target object.
    
    Parameters:
    
    target - Class a class to create instance of
    
    methodName - String name of method to invoke
    
    Returns:
    
    ReflectionBeanBuilder
  - target
```
public ReflectionInvoker<T,V> target(T target)
```
    Specify parameter parameters as list.
    
    Parameters:
    
    target - Object set target object to invoke methods on
    
    Returns:
    
    this
  - parameters
```
public ReflectionInvoker<T,V> parameters(java.util.List<java.lang.Class<?>> types)
```
    Specify parameter parameters as list.
    
    Parameters:
    
    types - List constructor parameter parameters.
    
    Returns:
    
    this
  - parameters
```
public ReflectionInvoker<T,V> parameters(java.lang.Class<?>... parameters)
```
    Specify parameter parameters as vararg.
    
    Parameters:
    
    parameters - vararg constructor parameter parameters.
    
    Returns:
    
    this
  - errorMessage
```
public ReflectionInvoker<T,V> errorMessage(java.lang.String pattern,
                                           java.lang.Object... parameters)
```
    An error message to be added to standard exception message.
    
    Parameters:
    
    pattern - String error message pattern.
    
    parameters - vararg message pattern parameters.
    
    Returns:
    
    this
  - invoke
```
public V invoke(java.lang.Object... arguments)
```
    Creates new instance.
    
    Parameters:
    
    arguments - vararg of actual parameters.
    
    Returns:
    
    new instance
    
    Throws:
    
    java.lang.IllegalArgumentException - if number actual parameters more or less than number of formal parameters (parameters).
    
    ReflectionException - if object creation fails
  - invokeMethod
```
public static <T> T invokeMethod(java.lang.Object target,
                                 java.lang.reflect.Method method,
                                 java.lang.Object... arguments)
```
    Invokes specified method of specified target using reflection.
    Method wraps all checked exceptions into unchecked exceptions.
    
    Parameters:
    
    method - Method to invoke
    
    target - Object the target the underlying method is invoked from
    
    arguments - vararg array of method arguments.
    
    Returns:
    
    method invocation result
  - newInstance
```
public static <T> T newInstance(java.lang.Class<T> clazz,
                                java.lang.Class[] parameters,
                                java.lang.Object[] arguments)
```
    Creates instance of specified class and wraps checked exceptions into unchecked ones.
    Converts checked exceptions to unchecked
    
    Parameters:
    
    clazz - Class a class to create instance
    
    parameters - Class[] array of constructor parameters (parameter types).
    
    arguments - Object[] an array of constructor arguments.
    
    Returns:
    
    an instance of specified class

Class ReflectionInvoker<T,V>

Constructor Summary

Method Summary

Methods inherited from class java.lang.Object

Constructor Detail

ReflectionInvoker

Method Detail

constructor

method

method

target

parameters

parameters

errorMessage

invoke

invokeMethod

newInstance