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

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

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

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

create

public T create()

Creates an object using the stored constructor.

Specified by:

create in interface Factory<T>

Returns:

the new object