Package org.apache.commons.collections.functors

Class PrototypeFactory

java.lang.Object
org.apache.commons.collections.functors.PrototypeFactory
@Deprecated(since="2021-04-30") public class PrototypeFactory extends Object
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 instance each time based on a prototype.
Since:
Commons Collections 3.0

  • Method Details

    • getInstance

      public static Factory getInstance(Object prototype)
      Deprecated.
      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: from v3.2.2 onwards 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
      Parameters:
      prototype - the object to clone each time in the factory
      Returns:
      the prototype factory
      Throws:
      IllegalArgumentException - if the prototype is null
      IllegalArgumentException - if the prototype cannot be cloned