org.apache.commons.collections4.functors

Class InvokerTransformer<I,O>

java.lang.Object

org.apache.commons.collections4.functors.InvokerTransformer<I,O>

All Implemented Interfaces:

Transformer<I,O>

public class InvokerTransformer<I,O>
extends java.lang.Object
implements Transformer<I,O>

Transformer implementation that creates a new object instance by reflection.

WARNING: from v4.1 onwards this class will not be serializable anymore in order to prevent potential remote code execution exploits. Please refer to COLLECTIONS-580 for more details.

Since:

3.0

Field Summary

Fields

Modifier and Type	Field and Description
private java.lang.Object[]	iArgs The array of reflection arguments
private java.lang.String	iMethodName The method name to call
private java.lang.Class<?>[]	iParamTypes The array of reflection parameter types

Constructor Summary

Constructors

Modifier	Constructor and Description
private	InvokerTransformer(java.lang.String methodName) Constructor for no arg instance.
	InvokerTransformer(java.lang.String methodName, java.lang.Class<?>[] paramTypes, java.lang.Object[] args) Constructor that performs no validation.

Method Summary

Modifier and Type	Method and Description
static <I,O> Transformer<I,O>	invokerTransformer(java.lang.String methodName) Gets an instance of this transformer calling a specific method with no arguments.
static <I,O> Transformer<I,O>	invokerTransformer(java.lang.String methodName, java.lang.Class<?>[] paramTypes, java.lang.Object[] args) Gets an instance of this transformer calling a specific method with specific values.
O	transform(java.lang.Object input) Transforms the input to result by invoking a method on the input.

Methods inherited from class java.lang.Object

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

Field Detail

iMethodName

private final java.lang.String iMethodName

The method name to call

iParamTypes

private final java.lang.Class<?>[] iParamTypes

The array of reflection parameter types

iArgs

private final java.lang.Object[] iArgs

The array of reflection arguments

Constructor Detail

InvokerTransformer

private InvokerTransformer(java.lang.String methodName)

Constructor for no arg instance.

Parameters:

methodName - the method to call

InvokerTransformer

public InvokerTransformer(java.lang.String methodName,
                          java.lang.Class<?>[] paramTypes,
                          java.lang.Object[] args)

Constructor that performs no validation. Use invokerTransformer if you want that.

Note: from 4.0, the input parameters will be cloned

Parameters:

methodName - the method to call

paramTypes - the constructor parameter types

args - the constructor arguments

Method Detail

invokerTransformer

public static <I,O> Transformer<I,O> invokerTransformer(java.lang.String methodName)

Gets an instance of this transformer calling a specific method with no arguments.

Type Parameters:

I - the input type

O - the output type

Parameters:

methodName - the method name to call

Returns:

an invoker transformer

Throws:

java.lang.NullPointerException - if methodName is null

Since:

3.1

invokerTransformer

public static <I,O> Transformer<I,O> invokerTransformer(java.lang.String methodName,
                                                        java.lang.Class<?>[] paramTypes,
                                                        java.lang.Object[] args)

Gets an instance of this transformer calling a specific method with specific values.

Type Parameters:

I - the input type

O - the output type

Parameters:

methodName - the method name to call

paramTypes - the parameter types of the method

args - the arguments to pass to the method

Returns:

an invoker transformer

Throws:

java.lang.NullPointerException - if methodName is null

java.lang.IllegalArgumentException - if paramTypes does not match args

transform

public O transform(java.lang.Object input)

Transforms the input to result by invoking a method on the input.

Specified by:

transform in interface Transformer<I,O>

Parameters:

input - the input object to transform

Returns:

the transformed result, null if null input