Class COWArrayList<E>

  • All Implemented Interfaces:
    java.lang.Iterable<E>, java.util.Collection<E>, java.util.List<E>

    @Deprecated(since="2022-01-27")
    public class COWArrayList<E>
    extends java.lang.Object
    implements java.util.List<E>
    Deprecated.
    This internal logback API is not supported by AEM as a Cloud Service.
    A GC-free lock-free thread-safe implementation of the List interface for use cases where iterations over the list vastly out-number modifications on the list.

    Underneath, it wraps an instance of CopyOnWriteArrayList and exposes a copy of the array used by that instance.

    Typical use:

        COWArrayList list = new COWArrayList(new Integer[0]);
    
        // modify the list
        list.add(1);
        list.add(2);
    
        Integer[] intArray = list.asTypedArray();
        int sum = 0;
        // iteration over the array is thread-safe
        for(int i = 0; i < intArray.length; i++) {
          sum != intArray[i];
        }
      

    If the list is not modified, then repetitive calls to asTypedArray(), toArray() and toArray(Object[]) are guaranteed to be GC-free. Note that iterating over the list using iterator() and listIterator() are not GC-free.

    Since:
    1.1.10
    • Constructor Summary

      Constructors 
      Constructor Description
      COWArrayList​(E[] modelArray)
      Deprecated.
       
    • Method Summary

      All Methods Instance Methods Concrete Methods Deprecated Methods 
      Modifier and Type Method Description
      void add​(int index, E element)
      Deprecated.
       
      boolean add​(E e)
      Deprecated.
       
      boolean addAll​(int index, java.util.Collection<? extends E> col)
      Deprecated.
       
      boolean addAll​(java.util.Collection<? extends E> c)
      Deprecated.
       
      void addIfAbsent​(E e)
      Deprecated.
       
      E[] asTypedArray()
      Deprecated.
      Return an array of type E[].
      void clear()
      Deprecated.
       
      boolean contains​(java.lang.Object o)
      Deprecated.
       
      boolean containsAll​(java.util.Collection<?> c)
      Deprecated.
       
      E get​(int index)
      Deprecated.
       
      int indexOf​(java.lang.Object o)
      Deprecated.
       
      boolean isEmpty()
      Deprecated.
       
      java.util.Iterator<E> iterator()
      Deprecated.
       
      int lastIndexOf​(java.lang.Object o)
      Deprecated.
       
      java.util.ListIterator<E> listIterator()
      Deprecated.
       
      java.util.ListIterator<E> listIterator​(int index)
      Deprecated.
       
      E remove​(int index)
      Deprecated.
       
      boolean remove​(java.lang.Object o)
      Deprecated.
       
      boolean removeAll​(java.util.Collection<?> col)
      Deprecated.
       
      boolean retainAll​(java.util.Collection<?> col)
      Deprecated.
       
      E set​(int index, E element)
      Deprecated.
       
      int size()
      Deprecated.
       
      java.util.List<E> subList​(int fromIndex, int toIndex)
      Deprecated.
       
      java.lang.Object[] toArray()
      Deprecated.
       
      <T> T[] toArray​(T[] a)
      Deprecated.
       
      • Methods inherited from class java.lang.Object

        equals, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
      • Methods inherited from interface java.util.Collection

        parallelStream, removeIf, stream, toArray
      • Methods inherited from interface java.lang.Iterable

        forEach
      • Methods inherited from interface java.util.List

        equals, hashCode, replaceAll, sort, spliterator
    • Constructor Detail

      • COWArrayList

        public COWArrayList​(E[] modelArray)
        Deprecated.
    • Method Detail

      • size

        public int size()
        Deprecated.
        Specified by:
        size in interface java.util.Collection<E>
        Specified by:
        size in interface java.util.List<E>
      • isEmpty

        public boolean isEmpty()
        Deprecated.
        Specified by:
        isEmpty in interface java.util.Collection<E>
        Specified by:
        isEmpty in interface java.util.List<E>
      • contains

        public boolean contains​(java.lang.Object o)
        Deprecated.
        Specified by:
        contains in interface java.util.Collection<E>
        Specified by:
        contains in interface java.util.List<E>
      • iterator

        public java.util.Iterator<E> iterator()
        Deprecated.
        Specified by:
        iterator in interface java.util.Collection<E>
        Specified by:
        iterator in interface java.lang.Iterable<E>
        Specified by:
        iterator in interface java.util.List<E>
      • toArray

        public java.lang.Object[] toArray()
        Deprecated.
        Specified by:
        toArray in interface java.util.Collection<E>
        Specified by:
        toArray in interface java.util.List<E>
      • toArray

        public <T> T[] toArray​(T[] a)
        Deprecated.
        Specified by:
        toArray in interface java.util.Collection<E>
        Specified by:
        toArray in interface java.util.List<E>
      • asTypedArray

        public E[] asTypedArray()
        Deprecated.
        Return an array of type E[]. The returned array is intended to be iterated over. If the list is modified, subsequent calls to this method will return different/modified array instances.
        Returns:
      • addIfAbsent

        public void addIfAbsent​(E e)
        Deprecated.
      • add

        public boolean add​(E e)
        Deprecated.
        Specified by:
        add in interface java.util.Collection<E>
        Specified by:
        add in interface java.util.List<E>
      • remove

        public boolean remove​(java.lang.Object o)
        Deprecated.
        Specified by:
        remove in interface java.util.Collection<E>
        Specified by:
        remove in interface java.util.List<E>
      • containsAll

        public boolean containsAll​(java.util.Collection<?> c)
        Deprecated.
        Specified by:
        containsAll in interface java.util.Collection<E>
        Specified by:
        containsAll in interface java.util.List<E>
      • addAll

        public boolean addAll​(java.util.Collection<? extends E> c)
        Deprecated.
        Specified by:
        addAll in interface java.util.Collection<E>
        Specified by:
        addAll in interface java.util.List<E>
      • addAll

        public boolean addAll​(int index,
                              java.util.Collection<? extends E> col)
        Deprecated.
        Specified by:
        addAll in interface java.util.List<E>
      • removeAll

        public boolean removeAll​(java.util.Collection<?> col)
        Deprecated.
        Specified by:
        removeAll in interface java.util.Collection<E>
        Specified by:
        removeAll in interface java.util.List<E>
      • retainAll

        public boolean retainAll​(java.util.Collection<?> col)
        Deprecated.
        Specified by:
        retainAll in interface java.util.Collection<E>
        Specified by:
        retainAll in interface java.util.List<E>
      • clear

        public void clear()
        Deprecated.
        Specified by:
        clear in interface java.util.Collection<E>
        Specified by:
        clear in interface java.util.List<E>
      • get

        public E get​(int index)
        Deprecated.
        Specified by:
        get in interface java.util.List<E>
      • set

        public E set​(int index,
                     E element)
        Deprecated.
        Specified by:
        set in interface java.util.List<E>
      • add

        public void add​(int index,
                        E element)
        Deprecated.
        Specified by:
        add in interface java.util.List<E>
      • remove

        public E remove​(int index)
        Deprecated.
        Specified by:
        remove in interface java.util.List<E>
      • indexOf

        public int indexOf​(java.lang.Object o)
        Deprecated.
        Specified by:
        indexOf in interface java.util.List<E>
      • lastIndexOf

        public int lastIndexOf​(java.lang.Object o)
        Deprecated.
        Specified by:
        lastIndexOf in interface java.util.List<E>
      • listIterator

        public java.util.ListIterator<E> listIterator()
        Deprecated.
        Specified by:
        listIterator in interface java.util.List<E>
      • listIterator

        public java.util.ListIterator<E> listIterator​(int index)
        Deprecated.
        Specified by:
        listIterator in interface java.util.List<E>
      • subList

        public java.util.List<E> subList​(int fromIndex,
                                         int toIndex)
        Deprecated.
        Specified by:
        subList in interface java.util.List<E>