|
Préférences
Moteurs de recherche
|
|||||||||||||||||||||
JavaTM 2 Platform Std. Ed. v1.5.0
java.util.concurrent
|
Constructor Summary | |
---|---|
CyclicBarrier(int parties)
Creates a new CyclicBarrier that will trip when the given number of parties (threads) are waiting upon it, and does not perform a predefined action upon each barrier. |
|
CyclicBarrier(int parties,
Runnable barrierAction)
Creates a new CyclicBarrier that will trip when the given number of parties (threads) are waiting upon it, and which will execute the given barrier action when the barrier is tripped, performed by the last thread entering the barrier. |
Method Summary | |
---|---|
int |
await()
Waits until all parties have invoked await
on this barrier. |
int |
await(long timeout,
TimeUnit unit)
Waits until all parties have invoked await
on this barrier. |
int |
getNumberWaiting()
Returns the number of parties currently waiting at the barrier. |
int |
getParties()
Returns the number of parties required to trip this barrier. |
boolean |
isBroken()
Queries if this barrier is in a broken state. |
void |
reset()
Resets the barrier to its initial state. |
Methods inherited from class java.lang.Object |
---|
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait |
Constructor Detail |
---|
public CyclicBarrier(int parties, Runnable barrierAction)
parties
- the number of threads that must invoke await()
before the barrier is tripped.barrierAction
- the command to execute when the barrier is
tripped, or null if there is no action.
IllegalArgumentException
- if parties is less than 1.public CyclicBarrier(int parties)
parties
- the number of threads that must invoke await()
before the barrier is tripped.
IllegalArgumentException
- if parties is less than 1.Method Detail |
---|
public int getParties()
public int await() throws InterruptedException, BrokenBarrierException
parties
have invoked await
on this barrier.
If the current thread is not the last to arrive then it is disabled for thread scheduling purposes and lies dormant until one of following things happens:
interrupts
the current
thread; or
interrupts
one of the
other waiting threads; or
reset()
on this barrier.
If the current thread:
interrupted
while waiting
InterruptedException
is thrown and the current thread's
interrupted status is cleared.
If the barrier is reset()
while any thread is waiting, or if
the barrier is broken
when await is invoked,
or while any thread is waiting,
then BrokenBarrierException
is thrown.
If any thread is interrupted
while waiting,
then all other waiting threads will throw
BrokenBarrierException
and the barrier is placed in the broken
state.
If the current thread is the last thread to arrive, and a non-null barrier action was supplied in the constructor, then the current thread runs the action before allowing the other threads to continue. If an exception occurs during the barrier action then that exception will be propagated in the current thread and the barrier is placed in the broken state.
getParties()
- 1 indicates the first to arrive and
zero indicates the last to arrive.
InterruptedException
- if the current thread was interrupted
while waiting
BrokenBarrierException
- if another thread was
interrupted while the current thread was waiting, or the barrier was
reset, or the barrier was broken when await was called,
or the barrier action (if present) failed due an exception.public int await(long timeout, TimeUnit unit) throws InterruptedException, BrokenBarrierException, TimeoutException
parties
have invoked await
on this barrier.
If the current thread is not the last to arrive then it is disabled for thread scheduling purposes and lies dormant until one of the following things happens:
interrupts
the current
thread; or
interrupts
one of the
other waiting threads; or
reset()
on this barrier.
If the current thread:
interrupted
while waiting
InterruptedException
is thrown and the current thread's
interrupted status is cleared.
If the specified waiting time elapses then TimeoutException
is thrown. If the time is less than or equal to zero, the
method will not wait at all.
If the barrier is reset()
while any thread is waiting, or if
the barrier is broken
when await is invoked,
or while any thread is waiting,
then BrokenBarrierException
is thrown.
If any thread is interrupted
while waiting,
then all other waiting threads will throw
BrokenBarrierException
and the barrier is placed in the broken
state.
If the current thread is the last thread to arrive, and a non-null barrier action was supplied in the constructor, then the current thread runs the action before allowing the other threads to continue. If an exception occurs during the barrier action then that exception will be propagated in the current thread and the barrier is placed in the broken state.
timeout
- the time to wait for the barrierunit
- the time unit of the timeout parameter
getParties()
- 1 indicates the first to arrive and
zero indicates the last to arrive.
InterruptedException
- if the current thread was interrupted
while waiting
TimeoutException
- if the specified timeout elapses.
BrokenBarrierException
- if another thread was
interrupted while the current thread was waiting, or the barrier was
reset, or the barrier was broken when await was called,
or the barrier action (if present) failed due an exception.public boolean isBroken()
public void reset()
BrokenBarrierException
. Note that resets after
a breakage has occurred for other reasons can be complicated to
carry out; threads need to re-synchronize in some other way,
and choose one to perform the reset. It may be preferable to
instead create a new barrier for subsequent use.
public int getNumberWaiting()
await()