Package org.apache.commons.collections.list

Class PredicatedList

java.lang.Object
org.apache.commons.collections.collection.AbstractCollectionDecorator
org.apache.commons.collections.collection.AbstractSerializableCollectionDecorator
org.apache.commons.collections.collection.PredicatedCollection
org.apache.commons.collections.list.PredicatedList
All Implemented Interfaces:
Serializable, Iterable, Collection, List, SequencedCollection
@Deprecated(since="2021-04-30") public class PredicatedList extends PredicatedCollection implements List
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 another List to validate that all additions match a specified predicate.

This list exists to provide validation for the decorated list. It is normally created to decorate an empty list. If an object cannot be added to the list, an IllegalArgumentException is thrown.

One usage would be to ensure that no null entries are added to the list. 

List list = PredicatedList.decorate(new ArrayList(), NotNullPredicate.INSTANCE);

This class is Serializable from Commons Collections 3.1.

Since:
Commons Collections 3.0
See Also:

  • Method Details

    • decorate

      public static List decorate(List list, Predicate predicate)
      Deprecated.
      Factory method to create a predicated (validating) list.

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

      Parameters:
      list - the list to decorate, must not be null
      predicate - the predicate to use for validation, must not be null
      Throws:
      IllegalArgumentException - if list or predicate is null
      IllegalArgumentException - if the list contains invalid elements

    • get

      public Object get(int index)
      Deprecated.
      Specified by:
      get in interface List

    • indexOf

      public int indexOf(Object object)
      Deprecated.
      Specified by:
      indexOf in interface List

    • lastIndexOf

      public int lastIndexOf(Object object)
      Deprecated.
      Specified by:
      lastIndexOf in interface List

    • remove

      public Object remove(int index)
      Deprecated.
      Specified by:
      remove in interface List

    • add

      public void add(int index, Object object)
      Deprecated.
      Specified by:
      add in interface List

    • addAll

      public boolean addAll(int index, Collection coll)
      Deprecated.
      Specified by:
      addAll in interface List

    • listIterator

      public ListIterator listIterator()
      Deprecated.
      Specified by:
      listIterator in interface List

    • listIterator

      public ListIterator listIterator(int i)
      Deprecated.
      Specified by:
      listIterator in interface List

    • set

      public Object set(int index, Object object)
      Deprecated.
      Specified by:
      set in interface List

    • subList

      public List subList(int fromIndex, int toIndex)
      Deprecated.
      Specified by:
      subList in interface List