org.apache.commons.collections4.functors

Class PrototypeFactory

java.lang.Object

org.apache.commons.collections4.functors.PrototypeFactory

public class PrototypeFactory
extends java.lang.Object

Factory implementation that creates a new instance each time based on a prototype.

Since:

3.0

Version:

$Id: PrototypeFactory.java 1477798 2013-04-30 19:49:02Z tn $

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
(package private) static class	PrototypeFactory.PrototypeCloneFactory<T> PrototypeCloneFactory creates objects by copying a prototype using the clone method.
(package private) static class	PrototypeFactory.PrototypeSerializationFactory<T extends java.io.Serializable> PrototypeSerializationFactory creates objects by cloning a prototype using serialization.

Constructor Summary

Constructors

Modifier	Constructor and Description
private	PrototypeFactory() Restricted constructor.

Method Summary

Modifier and Type	Method and Description
static <T> Factory<T>	prototypeFactory(T prototype) Factory method that performs validation.

Methods inherited from class java.lang.Object

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

Constructor Detail

PrototypeFactory

private PrototypeFactory()

Restricted constructor.

Method Detail

prototypeFactory

public static <T> Factory<T> prototypeFactory(T prototype)

Factory method that performs validation.

Creates a Factory that will return a clone of the same prototype object each time the factory is used. The prototype will be cloned using one of these techniques (in order):

• public clone method
• public copy constructor
• serialization clone

  WARNING: This method will return a Factory that will throw an UnsupportedOperationException when trying to serialize or de-serialize it to prevent potential remote code execution exploits.

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

   org.apache.commons.collections.enableUnsafeSerialization
   

Type Parameters:

T - the type the factory creates

Parameters:

prototype - the object to clone each time in the factory

Returns:

the prototype factory, or a ConstantFactory.NULL_INSTANCE if the prototype is null

Throws:

java.lang.IllegalArgumentException - if the prototype cannot be cloned