Package org.apache.commons.collections.functors

Class InstantiateFactory

java.lang.Object

org.apache.commons.collections.functors.InstantiateFactory

All Implemented Interfaces:

Serializable, Factory

@Deprecated(since="2021-04-30")
public class InstantiateFactory
extends Object
implements Factory, Serializable

Deprecated.

Apache Commons Collections version 3.x is being deprecated from AEMaaCS. The upgraded version 4.4 of Commons Collections is already included as replacement. Customers are advised to upgrade to this version of the library. Please note: the package name was changed to org.apache.commons.collections4. Further note that there are AEM APIs currently exposing the old collections classes; these will be updated in upcoming releases.

Factory 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

Constructor Summary

Constructors

Constructor	Description
InstantiateFactory(Class classToInstantiate)	Deprecated. Constructor that performs no validation.
InstantiateFactory(Class classToInstantiate, Class[] paramTypes, Object[] args)	Deprecated. Constructor that performs no validation.

Method Summary

Modifier and Type	Method	Description
Object	create()	Deprecated. Creates an object using the stored constructor.
static Factory	getInstance(Class classToInstantiate, Class[] paramTypes, Object[] args)	Deprecated. Factory method that performs validation.

Methods inherited from class java.lang.Object

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

Constructor Details

InstantiateFactory

public InstantiateFactory(Class classToInstantiate)

Deprecated.

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

Parameters:

classToInstantiate - the class to instantiate

InstantiateFactory

public InstantiateFactory(Class classToInstantiate,
 Class[] paramTypes,
 Object[] args)

Deprecated.

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

Parameters:

classToInstantiate - the class to instantiate

paramTypes - the constructor parameter types, not cloned

args - the constructor arguments, not cloned

Method Details

getInstance

public static Factory getInstance(Class classToInstantiate,
 Class[] paramTypes,
 Object[] args)

Deprecated.

Factory method that performs validation.

Parameters:

classToInstantiate - the class to instantiate, not null

paramTypes - the constructor parameter types

args - the constructor arguments

Returns:

a new instantiate factory

create

public Object create()

Deprecated.

Creates an object using the stored constructor.

Specified by:

create in interface Factory

Returns:

the new object