Package org.apache.commons.collections.list

Class SynchronizedList

java.lang.Object

org.apache.commons.collections.collection.SynchronizedCollection

org.apache.commons.collections.list.SynchronizedList

All Implemented Interfaces:

Serializable, Iterable, Collection, List

@Deprecated(since="2021-04-30")
public class SynchronizedList
extends SynchronizedCollection
implements List

Deprecated.

Commons Collections 3 is in maintenance mode. Commons Collections 4 should be used instead.

Decorates another List to synchronize its behaviour for a multi-threaded environment.

Methods are synchronized, then forwarded to the decorated list.

This class is Serializable from Commons Collections 3.1.

Since:

Commons Collections 3.0

See Also:

Serialized Form

Method Summary

Modifier and Type	Method	Description
void	add(int index, Object object)	Deprecated.
boolean	addAll(int index, Collection coll)	Deprecated.
static List	decorate(List list)	Deprecated. Factory method to create a synchronized list.
Object	get(int index)	Deprecated.
int	indexOf(Object object)	Deprecated.
int	lastIndexOf(Object object)	Deprecated.
ListIterator	listIterator()	Deprecated. Iterators must be manually synchronized.
ListIterator	listIterator(int index)	Deprecated. Iterators must be manually synchronized.
Object	remove(int index)	Deprecated.
Object	set(int index, Object object)	Deprecated.
List	subList(int fromIndex, int toIndex)	Deprecated.

Methods inherited from class org.apache.commons.collections.collection.SynchronizedCollection

add, addAll, clear, contains, containsAll, decorate, equals, hashCode, isEmpty, iterator, remove, removeAll, retainAll, size, toArray, toArray, toString

Methods inherited from class java.lang.Object

getClass, notify, notifyAll, 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

add, addAll, clear, contains, containsAll, equals, hashCode, isEmpty, iterator, remove, removeAll, replaceAll, retainAll, size, sort, spliterator, toArray, toArray

Method Detail

decorate

public static List decorate(List list)

Deprecated.

Factory method to create a synchronized list.

Parameters:

list - the list to decorate, must not be null

Throws:

IllegalArgumentException - if list is null

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

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

listIterator

public ListIterator listIterator()

Deprecated.

Iterators must be manually synchronized.

 synchronized (coll) {
   ListIterator it = coll.listIterator();
   // do stuff with iterator
 }

Specified by:

listIterator in interface List

Returns:

an iterator that must be manually synchronized on the collection

listIterator

public ListIterator listIterator(int index)

Deprecated.

Iterators must be manually synchronized.

 synchronized (coll) {
   ListIterator it = coll.listIterator(3);
   // do stuff with iterator
 }

Specified by:

listIterator in interface List

Returns:

an iterator that must be manually synchronized on the collection

remove

public Object remove(int index)

Deprecated.

Specified by:

remove 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