|
||||||||||
| PREV CLASS NEXT CLASS | FRAMES NO FRAMES | |||||||||
| SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD | |||||||||
java.lang.Objectorg.apache.commons.collections15.collection.SynchronizedCollection<E>
org.apache.commons.collections15.bag.SynchronizedBag<E>
public class SynchronizedBag<E>
Decorates another Bag to synchronize its behaviour
for a multi-threaded environment.
| Field Summary |
|---|
| Fields inherited from class org.apache.commons.collections15.collection.SynchronizedCollection |
|---|
collection, lock |
| Constructor Summary | |
|---|---|
protected |
SynchronizedBag(Bag<E> bag)
Constructor that wraps (not copies). |
protected |
SynchronizedBag(Bag<E> bag,
Object lock)
Constructor that wraps (not copies). |
| Method Summary | ||
|---|---|---|
boolean |
add(E object,
int count)
Adds nCopies copies of the specified object to the Bag. |
|
static
|
decorate(Bag<E> bag)
Factory method to create a synchronized bag. |
|
protected Bag<E> |
getBag()
Gets the bag being decorated. |
|
int |
getCount(E object)
Returns the number of occurrences (cardinality) of the given object currently in the bag. |
|
boolean |
remove(E object,
int count)
Removes nCopies copies of the specified object from the Bag. |
|
Set<E> |
uniqueSet()
Returns a Set of unique elements in the Bag. |
|
| Methods inherited from class org.apache.commons.collections15.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 |
|---|
clone, finalize, getClass, notify, notifyAll, wait, wait, wait |
| Methods inherited from interface org.apache.commons.collections15.Bag |
|---|
add, containsAll, iterator, remove, removeAll, retainAll, size |
| Methods inherited from interface java.util.Collection |
|---|
addAll, clear, contains, equals, hashCode, isEmpty, toArray, toArray |
| Constructor Detail |
|---|
protected SynchronizedBag(Bag<E> bag)
bag - the bag to decorate, must not be null
IllegalArgumentException - if bag is null
protected SynchronizedBag(Bag<E> bag,
Object lock)
bag - the bag to decorate, must not be nulllock - the lock to use, must not be null
IllegalArgumentException - if bag is null| Method Detail |
|---|
public static <E> Bag<E> decorate(Bag<E> bag)
bag - the bag to decorate, must not be null
IllegalArgumentException - if bag is nullprotected Bag<E> getBag()
public boolean add(E object,
int count)
BagnCopies copies of the specified object to the Bag.
If the object is already in the Bag.uniqueSet() then increment its
count as reported by Bag.getCount(Object). Otherwise add it to the
Bag.uniqueSet() and report its count as nCopies.
add in interface Bag<E>object - the object to addcount - the number of copies to add
true if the object was not already in the uniqueSet
public boolean remove(E object,
int count)
BagnCopies copies of the specified object from the Bag.
If the number of copies to remove is greater than the actual number of
copies in the Bag, no error is thrown.
remove in interface Bag<E>object - the object to removecount - the number of copies to remove
true if this call changed the collectionpublic Set<E> uniqueSet()
BagSet of unique elements in the Bag.
Uniqueness constraints are the same as those in Set.
uniqueSet in interface Bag<E>public int getCount(E object)
Bag
getCount in interface Bag<E>object - the object to search for
|
||||||||||
| PREV CLASS NEXT CLASS | FRAMES NO FRAMES | |||||||||
| SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD | |||||||||