org.apache.commons.collections.functors

Class InstantiateTransformer

java.lang.Object

org.apache.commons.collections.functors.InstantiateTransformer

All Implemented Interfaces:

java.io.Serializable, Transformer

public class InstantiateTransformer
extends java.lang.Object
implements Transformer, java.io.Serializable

Transformer implementation that creates a new object instance by reflection.

WARNING: from v3.2.2 onwards this class will throw an UnsupportedOperationException when trying to serialize or de-serialize an instance to prevent potential remote code execution exploits.

In order to re-enable serialization support for InstantiateTransformer the following system property can be used (via -Dproperty=true):

 org.apache.commons.collections.enableUnsafeSerialization
 

Since:

Commons Collections 3.0

See Also:

Serialized Form

Field Summary

Fields

Modifier and Type	Field and Description
static Transformer	NO_ARG_INSTANCE Singleton instance that uses the no arg constructor

Constructor Summary

Constructors

Constructor and Description
InstantiateTransformer(java.lang.Class[] paramTypes, java.lang.Object[] args) Constructor that performs no validation.

Method Summary

Modifier and Type	Method and Description
static Transformer	getInstance(java.lang.Class[] paramTypes, java.lang.Object[] args) Transformer method that performs validation.
java.lang.Object	transform(java.lang.Object input) Transforms the input Class object to a result by instantiation.

Methods inherited from class java.lang.Object

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

Field Detail

NO_ARG_INSTANCE

public static final Transformer NO_ARG_INSTANCE

Singleton instance that uses the no arg constructor

Constructor Detail

InstantiateTransformer

public InstantiateTransformer(java.lang.Class[] paramTypes,
                              java.lang.Object[] args)

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

Parameters:

paramTypes - the constructor parameter types, not cloned

args - the constructor arguments, not cloned

Method Detail

getInstance

public static Transformer getInstance(java.lang.Class[] paramTypes,
                                      java.lang.Object[] args)

Transformer method that performs validation.

Parameters:

paramTypes - the constructor parameter types

args - the constructor arguments

Returns:

an instantiate transformer

transform

public java.lang.Object transform(java.lang.Object input)

Transforms the input Class object to a result by instantiation.

Specified by:

transform in interface Transformer

Parameters:

input - the input object to transform

Returns:

the transformed result