Package org.apache.tomcat.util.threads
Class LimitLatch
java.lang.Object
org.apache.tomcat.util.threads.LimitLatch
Shared latch that allows the latch to be acquired a limited number of times
after which all subsequent requests to acquire the latch will be placed in a
FIFO queue until one of the shares is returned.
-
Constructor Summary
ConstructorsConstructorDescriptionLimitLatch(long limit) Instantiates a LimitLatch object with an initial limit. -
Method Summary
Modifier and TypeMethodDescriptionlongReleases a shared latch, making it available for another thread to use.voidAcquires a shared latch if one is available or waits for one if no shared latch is current available.longgetCount()Returns the current count for the latchlonggetLimit()Obtain the current limit.Provide access to the list of threads waiting to acquire this limited shared latch.booleanReturnstrueif there is at least one thread waiting to acquire the shared lock, otherwise returnsfalse.booleanReleases all waiting threads and causes thelimitto be ignored untilreset()is called.voidreset()Resets the latch and initializes the shared acquisition counter to zero.voidsetLimit(long limit) Sets a new limit.
-
Constructor Details
-
LimitLatch
public LimitLatch(long limit) Instantiates a LimitLatch object with an initial limit.- Parameters:
limit- - maximum number of concurrent acquisitions of this latch
-
-
Method Details
-
getCount
public long getCount()Returns the current count for the latch- Returns:
- the current count for latch
-
getLimit
public long getLimit()Obtain the current limit.- Returns:
- the limit
-
setLimit
public void setLimit(long limit) Sets a new limit. If the limit is decreased there may be a period where more shares of the latch are acquired than the limit. In this case no more shares of the latch will be issued until sufficient shares have been returned to reduce the number of acquired shares of the latch to below the new limit. If the limit is increased, threads currently in the queue may not be issued one of the newly available shares until the next request is made for a latch.- Parameters:
limit- The new limit
-
countUpOrAwait
Acquires a shared latch if one is available or waits for one if no shared latch is current available.- Throws:
InterruptedException- If the current thread is interrupted
-
countDown
public long countDown()Releases a shared latch, making it available for another thread to use.- Returns:
- the previous counter value
-
releaseAll
public boolean releaseAll()Releases all waiting threads and causes thelimitto be ignored untilreset()is called.- Returns:
trueif release was done
-
reset
public void reset()Resets the latch and initializes the shared acquisition counter to zero.- See Also:
-
hasQueuedThreads
public boolean hasQueuedThreads()Returnstrueif there is at least one thread waiting to acquire the shared lock, otherwise returnsfalse.- Returns:
trueif threads are waiting
-
getQueuedThreads
Provide access to the list of threads waiting to acquire this limited shared latch.- Returns:
- a collection of threads
-