|
|
|
@ -173,7 +173,7 @@ public class ConcurrentBag<T extends AbstractBagEntry>
|
|
|
|
|
|
|
|
|
|
/**
|
|
|
|
|
* Remove a value from the bag. This method should only be called
|
|
|
|
|
* with objects obtained by {@link #borrow(long, TimeUnit)} or {@link #reserve(T)}.
|
|
|
|
|
* with objects obtained by <code>borrow(long, TimeUnit)<code> or <code>reserve(T)</code>
|
|
|
|
|
*
|
|
|
|
|
* @param bagEntry the value to remove
|
|
|
|
|
* @return true if the entry was removed, false otherwise
|
|
|
|
@ -203,7 +203,7 @@ public class ConcurrentBag<T extends AbstractBagEntry>
|
|
|
|
|
/**
|
|
|
|
|
* This method provides a "snaphot" in time of the BagEntry
|
|
|
|
|
* items in the bag in the specified state. It does not "lock"
|
|
|
|
|
* or reserve items in any way. Call {@link #reserve(T)}
|
|
|
|
|
* or reserve items in any way. Call <code>reserve(T)</code>
|
|
|
|
|
* on items in list before performing any action on them.
|
|
|
|
|
*
|
|
|
|
|
* @param state one of STATE_NOT_IN_USE or STATE_IN_USE
|
|
|
|
@ -225,11 +225,11 @@ public class ConcurrentBag<T extends AbstractBagEntry>
|
|
|
|
|
/**
|
|
|
|
|
* The method is used to make an item in the bag "unavailable" for
|
|
|
|
|
* borrowing. It is primarily used when wanting to operate on items
|
|
|
|
|
* returned by the {@link #values(int)} method. Items that are
|
|
|
|
|
* reserved can be removed from the bag via {@link #remove(T)}
|
|
|
|
|
* returned by the <code>values(int)</code> method. Items that are
|
|
|
|
|
* reserved can be removed from the bag via <code>remove(T)</code>
|
|
|
|
|
* without the need to unreserve them. Items that are not removed
|
|
|
|
|
* from the bag can be make available for borrowing again by calling
|
|
|
|
|
* the {@link #unreserve(T)} method.
|
|
|
|
|
* the <code>unreserve(T)</code> method.
|
|
|
|
|
*
|
|
|
|
|
* @param bagEntry the item to reserve
|
|
|
|
|
* @return true if the item was able to be reserved, false otherwise
|
|
|
|
@ -240,7 +240,7 @@ public class ConcurrentBag<T extends AbstractBagEntry>
|
|
|
|
|
}
|
|
|
|
|
|
|
|
|
|
/**
|
|
|
|
|
* This method is used to make an item reserved via {@link #reserve(T)}
|
|
|
|
|
* This method is used to make an item reserved via <code>reserve(T)</code>
|
|
|
|
|
* available again for borrowing.
|
|
|
|
|
*
|
|
|
|
|
* @param bagEntry the item to unreserve
|
|
|
|
|