Package org.apache.commons.collections.collection

Class TypedCollection

java.lang.Object
org.apache.commons.collections.collection.TypedCollection
@Deprecated(since="2021-04-30") public class TypedCollection 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.
Decorates a Collection to validate that elements added are of a specific type.

The validation of additions is performed via an instanceof test against a specified Class. If an object cannot be added to the collection, an IllegalArgumentException is thrown.

Since:
Commons Collections 3.0

  • Method Details

    • decorate

      public static Collection decorate(Collection coll, Class type)
      Deprecated.
      Factory method to create a typed collection.

      If there are any elements already in the collection being decorated, they are validated.

      Parameters:
      coll - the collection to decorate, must not be null
      type - the type to allow into the collection, must not be null
      Returns:
      a new typed collection
      Throws:
      IllegalArgumentException - if collection or type is null
      IllegalArgumentException - if the collection contains invalid elements