Package org.apache.commons.collections.list

Class LazyList

java.lang.Object
org.apache.commons.collections.collection.AbstractCollectionDecorator
org.apache.commons.collections.list.AbstractListDecorator
org.apache.commons.collections.list.AbstractSerializableListDecorator
org.apache.commons.collections.list.LazyList
All Implemented Interfaces:
Serializable, Iterable, Collection, List, SequencedCollection
@Deprecated(since="2021-04-30") public class LazyList extends AbstractSerializableListDecorator
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 create objects in the list on demand.

When the get(int) method is called with an index greater than the size of the list, the list will automatically grow in size and return a new object from the specified factory. The gaps will be filled by null. If a get method call encounters a null, it will be replaced with a new object from the factory. Thus this list is unsuitable for storing null objects.

For instance: 

  Factory factory = new Factory() {
      public Object create() {
          return new Date();
      }
  }
  List lazy = LazyList.decorate(new ArrayList(), factory);
  Object obj = lazy.get(3);
After the above code is executed, obj will contain a new Date instance. Furthermore, that Date instance is the fourth element in the list. The first, second, and third element are all set to null.

This class differs from GrowthList because here growth occurs on get, where GrowthList grows on set and add. However, they could easily be used together by decorating twice.

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, Factory factory)
      Deprecated.
      Factory method to create a lazily instantiating list.
      Parameters:
      list - the list to decorate, must not be null
      factory - the factory to use for creation, must not be null
      Throws:
      IllegalArgumentException - if list or factory is null

    • get

      public Object get(int index)
      Deprecated.
      Decorate the get method to perform the lazy behaviour.

      If the requested index is greater than the current size, the list will grow to the new size and a new object will be returned from the factory. Indexes in-between the old size and the requested size are left with a placeholder that is replaced with a factory object when requested.

      Specified by:
      get in interface List
      Overrides:
      get in class AbstractListDecorator
      Parameters:
      index - the index to retrieve

    • subList

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