org.ws4d.java.structures
Class LockedList

java.lang.Object
  org.ws4d.java.structures.DataStructure
      org.ws4d.java.structures.List
          org.ws4d.java.structures.LockedList

All Implemented Interfaces:

Lockable

public class LockedList
extends List
implements Lockable

Synchronized List Class, uses lockSupport for synchronization.

Constructor Summary

LockedList()
Constructor.

LockedList(List list)
Constructor.

LockedList(List list, Lockable lock)
Constructor.

Method Summary

void	add(int index, java.lang.Object obj)
boolean	add(java.lang.Object obj) Adds a new object to this data structure.
boolean	addAll(DataStructure data) Adds all objects contained within data to this instance.
boolean	addAll(int index, DataStructure data)
void	clear() Clears this data structure by removing all content from it.
boolean	contains(java.lang.Object obj) Checks whether obj (or another instance equal to obj in terms of java.lang.Object.equals(Object) ) is already present within this data structure instance and returns true only if this is the case.
boolean	containsAll(DataStructure data) Checks whether all items within data are present within this data structure instance and returns true only if this is the case.
boolean	equals(java.lang.Object o)
void	exclusiveLock() Acquires an exclusive lock.
java.lang.Object	get(int index)
int	hashCode()
int	indexOf(java.lang.Object obj)
boolean	isEmpty() Checks whether this instance is empty or not.
Iterator	iterator() Manual synchronization of iterator necessary.
int	lastIndexOf(java.lang.Object obj)
ListIterator	listIterator()
ListIterator	listIterator(int index)
boolean	releaseExclusiveLock() Releases an exclusive lock of the current thread.
void	releaseSharedLock() Releases a shared lock of the current thread.
java.lang.Object	remove(int index)
boolean	remove(java.lang.Object obj) Removes obj from this data structure.
java.lang.Object	set(int index, java.lang.Object obj)
void	sharedLock() Acquires a shared lock.
int	size() Returns the current size of the data structure.
List	subList(int fromIndex, int toIndex)
java.lang.Object[]	toArray() Returns an array containing all items stored within this data structure.
java.lang.Object[]	toArray(java.lang.Object[] object) Stores all contained items into the passed-in array objects.
java.lang.String	toString()
boolean	tryExclusiveLock() Try to get an exclusive lock immediately.
boolean	trySharedLock() Tries to get a shared lock immediately.

Methods inherited from class org.ws4d.java.structures.List

getClassShortName

Methods inherited from class java.lang.Object

getClass, notify, notifyAll, wait, wait, wait

Constructor Detail

LockedList

public LockedList()

Constructor. A new ArrayList will be created and synchronized.

LockedList

public LockedList(List list)

Constructor.

Parameters:

list - List, which should be synchronized

LockedList

public LockedList(List list,
                  Lockable lock)

Constructor.

Parameters:

list - List, which should be synchronized

lock - Lock for access synchronization.

Method Detail

sharedLock

public void sharedLock()

Description copied from interface: Lockable

Acquires a shared lock. If the lock cannot be allocated immediately, the thread is blocked until allocation is possible.

Specified by:

sharedLock in interface Lockable

exclusiveLock

public void exclusiveLock()

Description copied from interface: Lockable

Acquires an exclusive lock. If the lock cannot be allocated immediately, the thread is blocked until allocation is possible.

Specified by:

exclusiveLock in interface Lockable

releaseSharedLock

public void releaseSharedLock()

Description copied from interface: Lockable

Releases a shared lock of the current thread.

Specified by:

releaseSharedLock in interface Lockable

releaseExclusiveLock

public boolean releaseExclusiveLock()

Description copied from interface: Lockable

Releases an exclusive lock of the current thread.

Specified by:

releaseExclusiveLock in interface Lockable

Returns:

true = if last exclusive lock of this thread is released.

tryExclusiveLock

public boolean tryExclusiveLock()

Description copied from interface: Lockable

Try to get an exclusive lock immediately.

Specified by:

tryExclusiveLock in interface Lockable

Returns:

true if the lock has been allocated, false otherwise

trySharedLock

public boolean trySharedLock()

Description copied from interface: Lockable

Tries to get a shared lock immediately.

Specified by:

trySharedLock in interface Lockable

Returns:

true if the lock has been allocated, false otherwise

add

public void add(int index,
                java.lang.Object obj)

Overrides:

add in class List

addAll

public boolean addAll(int index,
                      DataStructure data)

Overrides:

addAll in class List

get

public java.lang.Object get(int index)

Specified by:

get in class List

indexOf

public int indexOf(java.lang.Object obj)

Overrides:

indexOf in class List

lastIndexOf

public int lastIndexOf(java.lang.Object obj)

Overrides:

lastIndexOf in class List

listIterator

public ListIterator listIterator()

Overrides:

listIterator in class List

listIterator

public ListIterator listIterator(int index)

Overrides:

listIterator in class List

remove

public java.lang.Object remove(int index)

Overrides:

remove in class List

set

public java.lang.Object set(int index,
                            java.lang.Object obj)

Overrides:

set in class List

subList

public List subList(int fromIndex,
                    int toIndex)

Overrides:

subList in class List

iterator

public Iterator iterator()

Manual synchronization of iterator necessary.

Overrides:

iterator in class List

Returns:

an iterator over all stored objects

size

public int size()

Description copied from class: DataStructure

Returns the current size of the data structure.

Overrides:

size in class List

Returns:

the size of this data structure

contains

public boolean contains(java.lang.Object obj)

Description copied from class: DataStructure

Checks whether obj (or another instance equal to obj in terms of java.lang.Object.equals(Object) ) is already present within this data structure instance and returns true only if this is the case.

Overrides:

contains in class DataStructure

Parameters:

obj - the object to check the presence of

Returns:

true if obj is contained by this instance, false if not

remove

public boolean remove(java.lang.Object obj)

Description copied from class: DataStructure

Removes obj from this data structure. Returns true if obj was actually present and thus it was really removed (i.e. this instance was modified by the method call).

Overrides:

remove in class DataStructure

Parameters:

obj - the object to remove

Returns:

true only if obj was actually removed

clear

public void clear()

Description copied from class: DataStructure

Clears this data structure by removing all content from it.

Overrides:

clear in class DataStructure

add

public boolean add(java.lang.Object obj)

Description copied from class: DataStructure

Adds a new object to this data structure.

Overrides:

add in class List

Parameters:

obj - the object to add

Returns:

true if the object was actually added, false in any other case (e.g. adding an object to a set which already contains the same object in terms of java.lang.Object.equals(Object))

addAll

public boolean addAll(DataStructure data)

Description copied from class: DataStructure

Adds all objects contained within data to this instance.

Overrides:

addAll in class List

Parameters:

data - the objects to add

Returns:

true if at least one object from data was actually added, i.e. a modification was made to this instance, false in any other case (e.g. adding objects to a set which already contains them in terms of java.lang.Object.equals(Object))

containsAll

public boolean containsAll(DataStructure data)

Description copied from class: DataStructure

Checks whether all items within data are present within this data structure instance and returns true only if this is the case.

Overrides:

containsAll in class DataStructure

Parameters:

data - the items to check the presence of

Returns:

true if all objects within data are contained by this instance, false if at least one of them is not

isEmpty

public boolean isEmpty()

Description copied from class: DataStructure

Checks whether this instance is empty or not.

Overrides:

isEmpty in class DataStructure

Returns:

true if this data structure is empty, false otherwise

toArray

public java.lang.Object[] toArray()

Description copied from class: DataStructure

Returns an array containing all items stored within this data structure. The array will be of length DataStructure.size(), i.e. for an empty data structure an array of length zero is returned (rather than null).

Overrides:

toArray in class DataStructure

Returns:

an array of all objects contained within this data structure instance; this method never returns null

toArray

public java.lang.Object[] toArray(java.lang.Object[] object)

Description copied from class: DataStructure

Stores all contained items into the passed-in array objects. Returns the same array.

The array is expected not to be null and to be of exactly DataStructure.size() length. Otherwise, either a java.lang.NullPointerException or an java.lang.IllegalArgumentException will be thrown.

Overrides:

toArray in class DataStructure

Parameters:

object - the array to store this data structure's content to

Returns:

the same array as the one passed in (objects), however after having been filled with all objects contained within this data structure instance

hashCode

public int hashCode()

Overrides:

hashCode in class DataStructure

equals

public boolean equals(java.lang.Object o)

Overrides:

equals in class List

toString

public java.lang.String toString()

Overrides:

toString in class DataStructure