Package ch.qos.logback.core.util

Class COWArrayList<E>

java.lang.Object

ch.qos.logback.core.util.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

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>