Class SyncList

java.lang.Object

EDU.oswego.cs.dl.util.concurrent.SyncCollection

EDU.oswego.cs.dl.util.concurrent.SyncList

All Implemented Interfaces:

Iterable, Collection, List, SequencedCollection

public class SyncList
extends SyncCollection
implements List

SyncLists wrap Sync-based control around java.util.Lists. They support the following additional reader operations over SyncCollection: hashCode, equals, get, indexOf, lastIndexOf, subList. They support additional writer operations remove(int), set(int), add(int), addAll(int). The corresponding listIterators and are similarly extended.

[ Introduction to this package. ]

See Also:

• SyncCollection

Nested Class Summary

Nested Classes

Modifier and Type	Class	Description
class	SyncList.SyncCollectionListIterator

Nested classes/interfaces inherited from class SyncCollection

SyncCollection.SyncCollectionIterator

Field Summary

Fields inherited from class SyncCollection

c_, rd_, syncFailures_, wr_

Constructor Summary

Constructors

Constructor	Description
SyncList(List list, ReadWriteLock rwl)	Create a new SyncList protecting the given list, and using the given ReadWriteLock to control reader and writer methods.
SyncList(List list, Sync sync)	Create a new SyncList protecting the given collection, and using the given sync to control both reader and writer methods.
SyncList(List list, Sync readLock, Sync writeLock)	Create a new SyncList protecting the given list, and using the given pair of locks to control reader and writer methods.

Method Summary

Modifier and Type	Method	Description
void	add(int index, Object o)
boolean	addAll(int index, Collection coll)
protected List	baseList()
boolean	equals(Object o)
Object	get(int index)
int	hashCode()
int	indexOf(Object o)
int	lastIndexOf(Object o)
ListIterator	listIterator()
ListIterator	listIterator(int index)
Object	remove(int index)
Object	set(int index, Object o)
List	subList(int fromIndex, int toIndex)
ListIterator	unprotectedListIterator()
ListIterator	unprotectedListIterator(int index)

Methods inherited from class SyncCollection

add, addAll, afterRead, beforeRead, clear, contains, containsAll, isEmpty, iterator, readerSync, remove, removeAll, retainAll, size, syncFailures, toArray, toArray, unprotectedIterator, writerSync

Methods inherited from class Object

clone, finalize, getClass, notify, notifyAll, toString, wait, wait, wait

Methods inherited from interface Collection

parallelStream, removeIf, stream, toArray

Methods inherited from interface Iterable

forEach

Methods inherited from interface List

add, addAll, addFirst, addLast, clear, contains, containsAll, getFirst, getLast, isEmpty, iterator, remove, removeAll, removeFirst, removeLast, replaceAll, retainAll, reversed, size, sort, spliterator, toArray, toArray

Constructor Details

SyncList

public SyncList(List list,
 Sync sync)

Create a new SyncList protecting the given collection, and using the given sync to control both reader and writer methods. Common, reasonable choices for the sync argument include Mutex, ReentrantLock, and Semaphores initialized to 1.

SyncList

public SyncList(List list,
 ReadWriteLock rwl)

Create a new SyncList protecting the given list, and using the given ReadWriteLock to control reader and writer methods.

SyncList

public SyncList(List list,
 Sync readLock,
 Sync writeLock)

Create a new SyncList protecting the given list, and using the given pair of locks to control reader and writer methods.

Method Details

baseList

protected List baseList()

hashCode

public int hashCode()

Specified by:

hashCode in interface Collection

Specified by:

hashCode in interface List

Overrides:

hashCode in class Object

equals

public boolean equals(Object o)

Specified by:

equals in interface Collection

Specified by:

equals in interface List

Overrides:

equals in class Object

get

public Object get(int index)

Specified by:

get in interface List

indexOf

public int indexOf(Object o)

Specified by:

indexOf in interface List

lastIndexOf

public int lastIndexOf(Object o)

Specified by:

lastIndexOf in interface List

subList

public List subList(int fromIndex,
 int toIndex)

Specified by:

subList in interface List

set

public Object set(int index,
 Object o)

Specified by:

set in interface List

remove

public Object remove(int index)

Specified by:

remove in interface List

add

public void add(int index,
 Object o)

Specified by:

add in interface List

addAll

public boolean addAll(int index,
 Collection coll)

Specified by:

addAll in interface List

unprotectedListIterator

public ListIterator unprotectedListIterator()

listIterator

public ListIterator listIterator()

Specified by:

listIterator in interface List

unprotectedListIterator

public ListIterator unprotectedListIterator(int index)

listIterator

public ListIterator listIterator(int index)

Specified by:

listIterator in interface List