Class InstantiateFactory<T>

java.lang.Object

org.apache.commons.collections4.functors.InstantiateFactory<T>

All Implemented Interfaces:

Factory<T>

public class InstantiateFactory<T>
extends Object
implements Factory<T>

Factory 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	Description
private final Object[]	iArgs	The constructor arguments
private final Class<T>	iClassToInstantiate	The class to create
private Constructor<T>	iConstructor	The constructor
private final Class<?>[]	iParamTypes	The constructor parameter types

Constructor Summary

Constructors

Constructor	Description
InstantiateFactory(Class<T> classToInstantiate)	Constructor that performs no validation.
InstantiateFactory(Class<T> classToInstantiate, Class<?>[] paramTypes, Object[] args)	Constructor that performs no validation.

Method Summary

Modifier and Type	Method	Description
T	create()	Creates an object using the stored constructor.
private void	findConstructor()	Find the Constructor for the class specified.
static <T> Factory<T>	instantiateFactory(Class<T> classToInstantiate, Class<?>[] paramTypes, Object[] args)	Factory method that performs validation.

Methods inherited from class Object

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

Field Details

iClassToInstantiate

private final Class<T> iClassToInstantiate

The class to create

iParamTypes

private final Class<?>[] iParamTypes

The constructor parameter types

iArgs

private final Object[] iArgs

The constructor arguments

iConstructor

private transient Constructor<T> iConstructor

The constructor

Constructor Details

InstantiateFactory

public InstantiateFactory(Class<T> classToInstantiate)

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

Parameters:

classToInstantiate - the class to instantiate

InstantiateFactory

public InstantiateFactory(Class<T> classToInstantiate,
 Class<?>[] paramTypes,
 Object[] args)

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

Parameters:

classToInstantiate - the class to instantiate

paramTypes - the constructor parameter types, cloned

args - the constructor arguments, cloned

Method Details

instantiateFactory

public static <T> Factory<T> instantiateFactory(Class<T> classToInstantiate,
 Class<?>[] paramTypes,
 Object[] args)

Factory method that performs validation.

Type Parameters:

T - the type the factory creates

Parameters:

classToInstantiate - the class to instantiate, not null

paramTypes - the constructor parameter types, cloned

args - the constructor arguments, cloned

Returns:

a new instantiate factory

Throws:

NullPointerException - if classToInstantiate is null

IllegalArgumentException - if paramTypes does not match args

findConstructor

private void findConstructor()

Find the Constructor for the class specified.

create

public T create()

Creates an object using the stored constructor.

Specified by:

create in interface Factory<T>

Returns:

the new object