org.apache.commons.collections4.functors

Class InstantiateFactory<T>

java.lang.Object

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

All Implemented Interfaces:

Factory<T>

public class InstantiateFactory<T>
extends java.lang.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 and Description
private java.lang.Object[]	iArgs The constructor arguments
private java.lang.Class<T>	iClassToInstantiate The class to create
private java.lang.reflect.Constructor<T>	iConstructor The constructor
private java.lang.Class<?>[]	iParamTypes The constructor parameter types

Constructor Summary

Constructors

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

Method Summary

Modifier and Type	Method and 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(java.lang.Class<T> classToInstantiate, java.lang.Class<?>[] paramTypes, java.lang.Object[] args) Factory method that performs validation.

Methods inherited from class java.lang.Object

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

Field Detail

iClassToInstantiate

private final java.lang.Class<T> iClassToInstantiate

The class to create

iParamTypes

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

The constructor parameter types

iArgs

private final java.lang.Object[] iArgs

The constructor arguments

iConstructor

private transient java.lang.reflect.Constructor<T> iConstructor

The constructor

Constructor Detail

InstantiateFactory

public InstantiateFactory(java.lang.Class<T> classToInstantiate)

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

Parameters:

classToInstantiate - the class to instantiate

InstantiateFactory

public InstantiateFactory(java.lang.Class<T> classToInstantiate,
                          java.lang.Class<?>[] paramTypes,
                          java.lang.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 Detail

instantiateFactory

public static <T> Factory<T> instantiateFactory(java.lang.Class<T> classToInstantiate,
                                                java.lang.Class<?>[] paramTypes,
                                                java.lang.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:

java.lang.NullPointerException - if classToInstantiate is null

java.lang.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