Package org.apache.commons.collections4.functors

# Class PrototypeFactory

java.lang.Object
org.apache.commons.collections4.functors.PrototypeFactory

public class PrototypeFactory extends Object
Factory implementation that creates a new instance each time based on a prototype.

WARNING: from v4.1 onwards `Factory` instances returned by `prototypeFactory(Object)` 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

- ## Method Summary

  Modifier and Type
  Method
  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`

- ## Method Details

  - ### 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
    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:
      `IllegalArgumentException` - if the prototype cannot be cloned