Package com.helger.commons.collection.impl

Class CommonsCopyOnWriteArrayList<ELEMENTTYPE>

java.lang.Object

java.util.concurrent.CopyOnWriteArrayList<ELEMENTTYPE>

com.helger.commons.collection.impl.CommonsCopyOnWriteArrayList<ELEMENTTYPE>

Type Parameters:

ELEMENTTYPE - List element type

All Implemented Interfaces:

ICommonsCollection<ELEMENTTYPE>, ICommonsIterable<ELEMENTTYPE>, ICommonsList<ELEMENTTYPE>, ICloneable<ICommonsList<ELEMENTTYPE>>, IHasSize, Serializable, Cloneable, Iterable<ELEMENTTYPE>, Collection<ELEMENTTYPE>, List<ELEMENTTYPE>, RandomAccess, SequencedCollection<ELEMENTTYPE>

public class CommonsCopyOnWriteArrayList<ELEMENTTYPE>
extends CopyOnWriteArrayList<ELEMENTTYPE>
implements ICommonsList<ELEMENTTYPE>

A special CommonsCopyOnWriteArrayList implementation based on ICommonsList.

Author:

Philip Helger

See Also:

• Serialized Form

Constructor Summary

Constructors

Constructor	Description
CommonsCopyOnWriteArrayList()	Create a new empty array list.
CommonsCopyOnWriteArrayList(ELEMENTTYPE aValue)	Create a new array list with an initial capacity of 1 and exactly the provided value, even if it is null.
CommonsCopyOnWriteArrayList(ELEMENTTYPE... aValues)	Create a new array list that contains the same elements as the provided array.
CommonsCopyOnWriteArrayList(Iterable<? extends ELEMENTTYPE> aValues)	Create a new array list with all provided elements.
CommonsCopyOnWriteArrayList(Iterable<? extends SRCTYPE> aValues, Function<? super SRCTYPE,? extends ELEMENTTYPE> aMapper)	Create a new array list with all mapped items of the provided iterable.
CommonsCopyOnWriteArrayList(Collection<? extends ELEMENTTYPE> aValues)	Create a new array list that contains the same elements as the provided collection.
CommonsCopyOnWriteArrayList(SRCTYPE[] aValues, Function<? super SRCTYPE,? extends ELEMENTTYPE> aMapper)	Create a new array list that contains mapped elements of the provided array.

Method Summary

Modifier and Type	Method	Description
static <ELEMENTTYPE> CommonsCopyOnWriteArrayList<ELEMENTTYPE>	createFiltered(ELEMENTTYPE[] aValues, Predicate<? super ELEMENTTYPE> aFilter)	Create a new array list that contains a subset of the provided array. Note: this method is a static factory method because the compiler sometimes cannot deduce between Predicate and Function and the mapping case occurs more often.
static <ELEMENTTYPE> CommonsCopyOnWriteArrayList<ELEMENTTYPE>	createFiltered(Iterable<? extends ELEMENTTYPE> aValues, Predicate<? super ELEMENTTYPE> aFilter)	Create a new array list that contains a subset of the provided iterable. Note: this method is a static factory method because the compiler sometimes cannot deduce between Predicate and Function and the mapping case occurs more often.
static <SRCTYPE, ELEMENTTYPE> CommonsCopyOnWriteArrayList<ELEMENTTYPE>	createFiltered(Iterable<? extends SRCTYPE> aValues, Function<? super SRCTYPE,? extends ELEMENTTYPE> aMapper, Predicate<? super ELEMENTTYPE> aFilter)	Create a new array list that contains a subset of the provided iterable.
static <SRCTYPE, ELEMENTTYPE> CommonsCopyOnWriteArrayList<ELEMENTTYPE>	createFiltered(Iterable<? extends SRCTYPE> aValues, Predicate<? super SRCTYPE> aFilter, Function<? super SRCTYPE,? extends ELEMENTTYPE> aMapper)	Create a new array list that contains a subset of the provided iterable.
static <SRCTYPE, ELEMENTTYPE> CommonsCopyOnWriteArrayList<ELEMENTTYPE>	createFiltered(SRCTYPE[] aValues, Function<? super SRCTYPE,? extends ELEMENTTYPE> aMapper, Predicate<? super ELEMENTTYPE> aFilter)	Create a new array list that contains a subset of the provided array.
static <SRCTYPE, ELEMENTTYPE> CommonsCopyOnWriteArrayList<ELEMENTTYPE>	createFiltered(SRCTYPE[] aValues, Predicate<? super SRCTYPE> aFilter, Function<? super SRCTYPE,? extends ELEMENTTYPE> aMapper)	Create a new array list that contains a subset of the provided array.
<T> CommonsCopyOnWriteArrayList<T>	createInstance()	Create a new empty list.
CommonsCopyOnWriteArrayList<ELEMENTTYPE>	getClone()

Methods inherited from class java.util.concurrent.CopyOnWriteArrayList

add, add, addAll, addAll, addAllAbsent, addFirst, addIfAbsent, addLast, clear, clone, contains, containsAll, equals, forEach, get, getFirst, getLast, hashCode, indexOf, indexOf, isEmpty, iterator, lastIndexOf, lastIndexOf, listIterator, listIterator, remove, remove, removeAll, removeFirst, removeIf, removeLast, replaceAll, retainAll, reversed, set, size, sort, spliterator, subList, toArray, toArray, toString

Methods inherited from class java.lang.Object

finalize, getClass, notify, notifyAll, wait, wait, wait

Methods inherited from interface java.util.Collection

parallelStream, removeIf, stream, toArray

Methods inherited from interface com.helger.commons.collection.impl.ICommonsCollection

addAll, addAll, addAll, addAll, addAll, addAll, addAll, addAll, addAllMapped, addAllMapped, addAllMapped, addAllMapped, addAllMapped, addAllMapped, addIf, addIfNotNull, addObject, getAtIndex, getAtIndex, getAtIndex, getAtIndexMapped, getAtIndexMapped, getAtIndexMapped, getAtIndexMapped, getCopyAsList, getCount, getSorted, iterator2, removeAll, removeObject, set, setAll, setAll, setAllMapped, setAllMapped

Methods inherited from interface com.helger.commons.collection.impl.ICommonsIterable

containsAny, containsNone, containsOnly, findAll, findAllInstanceOf, findAllMapped, findAllMapped, findAllMapped, findFirst, findFirst, findFirstIndex, findFirstMapped, findFirstMapped, findLastIndex, forEachBreakable, forEachByIndex, forEachThrowing, getCount

Methods inherited from interface com.helger.commons.collection.impl.ICommonsList

getAll, getAllInstanceOf, getAllMapped, getAllMapped, getAsUnmodifiable, getAtIndex, getFirst, getFirst, getFirstOrNull, getLast, getLast, getLastOrNull, getSortedInline, removeAndReturnElementAtIndex, removeAtIndex, removeFirst, removeFirstOrNull, removeLast, removeLastOrNull, reverse, setFirst, setLast, swapItems

Methods inherited from interface com.helger.commons.lang.IHasSize

isEmpty, isNotEmpty, size

Methods inherited from interface java.lang.Iterable

forEach

Methods inherited from interface java.util.List

add, add, addAll, addAll, addFirst, addLast, clear, contains, containsAll, equals, get, hashCode, indexOf, isEmpty, iterator, lastIndexOf, listIterator, listIterator, remove, remove, removeAll, replaceAll, retainAll, reversed, set, size, sort, spliterator, subList, toArray, toArray

Constructor Details

CommonsCopyOnWriteArrayList

public CommonsCopyOnWriteArrayList()

Create a new empty array list.

CommonsCopyOnWriteArrayList

public CommonsCopyOnWriteArrayList(@Nullable
 Collection<? extends ELEMENTTYPE> aValues)

Create a new array list that contains the same elements as the provided collection.

Parameters:

aValues - The collection to copy the elements from. May be null.

See Also:

• CopyOnWriteArrayList.addAll(Collection)

CommonsCopyOnWriteArrayList

public CommonsCopyOnWriteArrayList(@Nullable
 Iterable<? extends ELEMENTTYPE> aValues)

Create a new array list with all provided elements.

Parameters:

aValues - The iterable from which the elements are copied from. May be null.

See Also:

• ICommonsCollection.addAll(Iterable)

CommonsCopyOnWriteArrayList

public CommonsCopyOnWriteArrayList(@Nullable
 Iterable<? extends SRCTYPE> aValues,
 @Nonnull
 Function<? super SRCTYPE,? extends ELEMENTTYPE> aMapper)

Create a new array list with all mapped items of the provided iterable.

Type Parameters:

SRCTYPE - source data type

Parameters:

aValues - The iterable from which the elements are copied from. May be null.

aMapper - The mapping function to be executed for all provided elements. May not be null.

See Also:

• ICommonsCollection.addAllMapped(Iterable, Function)

CommonsCopyOnWriteArrayList

public CommonsCopyOnWriteArrayList(@Nullable
 ELEMENTTYPE aValue)

Create a new array list with an initial capacity of 1 and exactly the provided value, even if it is null.

Parameters:

aValue - The value to be added. May be null.

CommonsCopyOnWriteArrayList

@SafeVarargs
public CommonsCopyOnWriteArrayList(@Nullable
 ELEMENTTYPE... aValues)

Create a new array list that contains the same elements as the provided array.

Parameters:

aValues - The array to copy the elements from. May be null.

See Also:

• ICommonsCollection.addAll(Object...)

CommonsCopyOnWriteArrayList

public CommonsCopyOnWriteArrayList(@Nullable
 SRCTYPE[] aValues,
 @Nonnull
 Function<? super SRCTYPE,? extends ELEMENTTYPE> aMapper)

Create a new array list that contains mapped elements of the provided array.

Type Parameters:

SRCTYPE - source data type

Parameters:

aValues - The array to copy the elements from. May be null.

aMapper - The mapping function to be executed for all provided elements. May not be null.

See Also:

• ICommonsCollection.addAllMapped(Object[], Function)

Method Details

createInstance

@Nonnull
@ReturnsMutableCopy
public <T> CommonsCopyOnWriteArrayList<T> createInstance()

Description copied from interface: ICommonsList

Create a new empty list. Overwrite this if you don't want to use CommonsArrayList.

Specified by:

createInstance in interface ICommonsList<ELEMENTTYPE>

Type Parameters:

T - List element type

Returns:

A new empty list. Never null.

getClone

@Nonnull
@ReturnsMutableCopy
public CommonsCopyOnWriteArrayList<ELEMENTTYPE> getClone()

Specified by:

getClone in interface ICloneable<ELEMENTTYPE>

Returns:

A 100% deep-copy of the implementing class.

createFiltered

@Nonnull
@ReturnsMutableCopy
public static <ELEMENTTYPE>
CommonsCopyOnWriteArrayList<ELEMENTTYPE> createFiltered(@Nullable
 Iterable<? extends ELEMENTTYPE> aValues,
 @Nullable
 Predicate<? super ELEMENTTYPE> aFilter)

Create a new array list that contains a subset of the provided iterable.
Note: this method is a static factory method because the compiler sometimes cannot deduce between Predicate and Function and the mapping case occurs more often.

Type Parameters:

ELEMENTTYPE - data type of the list

Parameters:

aValues - The iterable from which the elements are copied from. May be null.

aFilter - The filter to be applied to check if the element should be added or not.

Returns:

The created array list. Never null.

Since:

9.1.3

See Also:

• ICommonsCollection.addAll(Iterable, Predicate)

createFiltered

@Nonnull
@ReturnsMutableCopy
public static <SRCTYPE,
ELEMENTTYPE>
CommonsCopyOnWriteArrayList<ELEMENTTYPE> createFiltered(@Nullable
 Iterable<? extends SRCTYPE> aValues,
 @Nullable
 Predicate<? super SRCTYPE> aFilter,
 @Nonnull
 Function<? super SRCTYPE,? extends ELEMENTTYPE> aMapper)

Create a new array list that contains a subset of the provided iterable. This method filters the elements before they are mapped.
Note: this method is a static factory method because the compiler sometimes cannot deduce between Predicate and Function and the mapping case occurs more often.

Type Parameters:

SRCTYPE - source data type

ELEMENTTYPE - final data type of the list

Parameters:

aValues - The iterable from which the elements are copied from. May be null.

aFilter - The filter to be applied to check if the element should be added or not.

aMapper - The mapping function to be executed for all provided elements. May not be null.

Returns:

The created array list. Never null.

Since:

9.1.3

See Also:

• ICommonsCollection.addAllMapped(Iterable, Predicate, Function)

createFiltered

@Nonnull
@ReturnsMutableCopy
public static <SRCTYPE,
ELEMENTTYPE>
CommonsCopyOnWriteArrayList<ELEMENTTYPE> createFiltered(@Nullable
 Iterable<? extends SRCTYPE> aValues,
 @Nonnull
 Function<? super SRCTYPE,? extends ELEMENTTYPE> aMapper,
 @Nullable
 Predicate<? super ELEMENTTYPE> aFilter)

Create a new array list that contains a subset of the provided iterable. This method maps the elements before they are filtered.
Note: this method is a static factory method because the compiler sometimes cannot deduce between Predicate and Function and the mapping case occurs more often.

Type Parameters:

SRCTYPE - source data type

ELEMENTTYPE - final data type of the list

Parameters:

aValues - The iterable from which the elements are copied from. May be null.

aMapper - The mapping function to be executed for all provided elements. May not be null.

aFilter - The filter to be applied on the mapped element to check if the element should be added or not.

Returns:

The created array list. Never null.

Since:

9.1.3

See Also:

• ICommonsCollection.addAllMapped(Iterable, Function, Predicate)

createFiltered

@Nonnull
@ReturnsMutableCopy
public static <ELEMENTTYPE>
CommonsCopyOnWriteArrayList<ELEMENTTYPE> createFiltered(@Nullable
 ELEMENTTYPE[] aValues,
 @Nullable
 Predicate<? super ELEMENTTYPE> aFilter)

Create a new array list that contains a subset of the provided array.
Note: this method is a static factory method because the compiler sometimes cannot deduce between Predicate and Function and the mapping case occurs more often.

Type Parameters:

ELEMENTTYPE - data type of the list

Parameters:

aValues - The array from which the elements are copied from. May be null.

aFilter - The filter to be applied to check if the element should be added or not.

Returns:

The created array list. Never null.

Since:

9.1.3

See Also:

• ICommonsCollection.addAll(Object[], Predicate)

createFiltered

@Nonnull
@ReturnsMutableCopy
public static <SRCTYPE,
ELEMENTTYPE>
CommonsCopyOnWriteArrayList<ELEMENTTYPE> createFiltered(@Nullable
 SRCTYPE[] aValues,
 @Nullable
 Predicate<? super SRCTYPE> aFilter,
 @Nonnull
 Function<? super SRCTYPE,? extends ELEMENTTYPE> aMapper)

Create a new array list that contains a subset of the provided array. This method filters the elements before they are mapped.
Note: this method is a static factory method because the compiler sometimes cannot deduce between Predicate and Function and the mapping case occurs more often.

Type Parameters:

SRCTYPE - source data type

ELEMENTTYPE - final data type of the list

Parameters:

aValues - The array from which the elements are copied from. May be null.

aFilter - The filter to be applied to check if the element should be added or not.

aMapper - The mapping function to be executed for all provided elements. May not be null.

Returns:

The created array list. Never null.

Since:

9.1.3

See Also:

• ICommonsCollection.addAllMapped(Object[], Predicate, Function)

createFiltered

@Nonnull
@ReturnsMutableCopy
public static <SRCTYPE,
ELEMENTTYPE>
CommonsCopyOnWriteArrayList<ELEMENTTYPE> createFiltered(@Nullable
 SRCTYPE[] aValues,
 @Nonnull
 Function<? super SRCTYPE,? extends ELEMENTTYPE> aMapper,
 @Nullable
 Predicate<? super ELEMENTTYPE> aFilter)

Create a new array list that contains a subset of the provided array. This method maps the elements before they are filtered.
Note: this method is a static factory method because the compiler sometimes cannot deduce between Predicate and Function and the mapping case occurs more often.

Type Parameters:

SRCTYPE - source data type

ELEMENTTYPE - final data type of the list

Parameters:

aValues - The array from which the elements are copied from. May be null.

aMapper - The mapping function to be executed for all provided elements. May not be null.

aFilter - The filter to be applied on the mapped element to check if the element should be added or not.

Returns:

The created array list. Never null.

Since:

9.1.3

See Also:

• ICommonsCollection.addAllMapped(Iterable, Function, Predicate)