Package org.apache.commons.collections.functors

Class InstantiateTransformer

  • All Implemented Interfaces:
    java.io.Serializable, Transformer
    public class InstantiateTransformer
extends java.lang.Object
implements Transformer, java.io.Serializable
    Transformer 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

    • Field Summary

      Fields 
      Modifier and Type Field Description
      static Transformer NO_ARG_INSTANCE
      Singleton instance that uses the no arg constructor

    • Constructor Summary

      Constructors 
      Constructor Description
      InstantiateTransformer​(java.lang.Class[] paramTypes, java.lang.Object[] args)
      Constructor that performs no validation.

    • Method Summary

      All Methods Static Methods Instance Methods Concrete Methods 
      Modifier and Type Method Description
      static Transformer getInstance​(java.lang.Class[] paramTypes, java.lang.Object[] args)
      Transformer method that performs validation.
      java.lang.Object transform​(java.lang.Object input)
      Transforms the input Class object to a result by instantiation.

      • Methods inherited from class java.lang.Object

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

    • Field Detail

      • NO_ARG_INSTANCE

        public static final Transformer NO_ARG_INSTANCE
        Singleton instance that uses the no arg constructor

    • Constructor Detail

      • InstantiateTransformer

        public InstantiateTransformer​(java.lang.Class[] paramTypes,
                              java.lang.Object[] args)
        Constructor that performs no validation. Use getInstance if you want that.
        Parameters:
        paramTypes - the constructor parameter types, not cloned
        args - the constructor arguments, not cloned

    • Method Detail

      • getInstance

        public static Transformer getInstance​(java.lang.Class[] paramTypes,
                                      java.lang.Object[] args)
        Transformer method that performs validation.
        Parameters:
        paramTypes - the constructor parameter types
        args - the constructor arguments
        Returns:
        an instantiate transformer

      • transform

        public java.lang.Object transform​(java.lang.Object input)
        Transforms the input Class object to a result by instantiation.
        Specified by:
        transform in interface Transformer
        Parameters:
        input - the input object to transform
        Returns:
        the transformed result