|
|||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | ||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |
java.lang.Object org.ws4d.java.structures.DataStructure org.ws4d.java.structures.Set org.ws4d.java.structures.LockedSet
public class LockedSet
Class encapsulates set, method invocations are synchronized by a Lockable object.
Constructor Summary | |
---|---|
LockedSet()
Constructor. |
|
LockedSet(Set set)
Constructor. |
|
LockedSet(Set set,
Lockable lock)
Constructor. |
Method Summary | |
---|---|
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. |
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()
|
int |
hashCode()
|
boolean |
isEmpty()
Checks whether this instance is empty or not. |
Iterator |
iterator()
Manual synchronization of iterator necessary. |
boolean |
releaseExclusiveLock()
|
void |
releaseSharedLock()
|
boolean |
remove(java.lang.Object obj)
Removes obj from this data structure. |
void |
sharedLock()
|
int |
size()
Returns the current size of the data structure. |
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()
|
boolean |
trySharedLock()
|
Methods inherited from class org.ws4d.java.structures.Set |
---|
getClassShortName |
Methods inherited from class java.lang.Object |
---|
getClass, notify, notifyAll, wait, wait, wait |
Constructor Detail |
---|
public LockedSet()
public LockedSet(Set set)
set
- Set which this will encapsulate.public LockedSet(Set set, Lockable lock)
set
- Set which this will encapsulate.lock
- Lock for access synchronization.Method Detail |
---|
public void sharedLock()
public void exclusiveLock()
public void releaseSharedLock()
public boolean releaseExclusiveLock()
public boolean tryExclusiveLock()
public boolean trySharedLock()
public boolean add(java.lang.Object obj)
DataStructure
add
in class DataStructure
obj
- the object to add
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)
)public boolean addAll(DataStructure data)
DataStructure
data
to this instance.
addAll
in class DataStructure
data
- the objects to add
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)
)public void clear()
DataStructure
clear
in class DataStructure
public boolean contains(java.lang.Object obj)
DataStructure
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.
contains
in class DataStructure
obj
- the object to check the presence of
true
if obj
is contained by this
instance, false
if notpublic boolean containsAll(DataStructure data)
DataStructure
data
are present within this
data structure instance and returns true
only if this is the
case.
containsAll
in class Set
data
- the items to check the presence of
true
if all objects within data
are
contained by this instance, false
if at least one of
them is notpublic boolean isEmpty()
DataStructure
isEmpty
in class DataStructure
true
if this data structure is empty,
false
otherwisepublic Iterator iterator()
iterator
in class DataStructure
public boolean remove(java.lang.Object obj)
DataStructure
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).
remove
in class DataStructure
obj
- the object to remove
true
only if obj
was actually removedpublic int size()
DataStructure
size
in class DataStructure
public java.lang.Object[] toArray()
DataStructure
DataStructure.size()
, i.e. for an empty data
structure an array of length zero is returned (rather than
null
).
toArray
in class DataStructure
null
public java.lang.Object[] toArray(java.lang.Object[] object)
DataStructure
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.
toArray
in class DataStructure
object
- the array to store this data structure's content to
objects
),
however after having been filled with all objects contained
within this data structure instancepublic int hashCode()
hashCode
in class Set
public boolean equals(java.lang.Object o)
equals
in class Set
public java.lang.String toString()
toString
in class DataStructure
|
|||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | ||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |