Serializable
, Condition
public class AbstractQueuedSynchronizer.ConditionObject extends Object implements Condition, Serializable
AbstractQueuedSynchronizer
serving as the basis of a Lock
implementation.
Method documentation for this class describes mechanics,
not behavioral specifications from the point of view of Lock
and Condition users. Exported versions of this class will in
general need to be accompanied by documentation describing
condition semantics that rely on those of the associated
AbstractQueuedSynchronizer
.
This class is Serializable, but all fields are transient, so deserialized conditions have no waiters.
Constructor | Description |
---|---|
ConditionObject() |
Creates a new
ConditionObject instance. |
Modifier and Type | Method | Description |
---|---|---|
void |
await() |
Implements interruptible condition wait.
|
boolean |
await(long time,
TimeUnit unit) |
Implements timed condition wait.
|
long |
awaitNanos(long nanosTimeout) |
Implements timed condition wait.
|
void |
awaitUninterruptibly() |
Implements uninterruptible condition wait.
|
boolean |
awaitUntil(Date deadline) |
Implements absolute timed condition wait.
|
protected Collection<Thread> |
getWaitingThreads() |
Returns a collection containing those threads that may be
waiting on this Condition.
|
protected int |
getWaitQueueLength() |
Returns an estimate of the number of threads waiting on
this condition.
|
protected boolean |
hasWaiters() |
Queries whether any threads are waiting on this condition.
|
void |
signal() |
Moves the longest-waiting thread, if one exists, from the
wait queue for this condition to the wait queue for the
owning lock.
|
void |
signalAll() |
Moves all threads from the wait queue for this condition to
the wait queue for the owning lock.
|
public final void signal()
signal
in interface Condition
IllegalMonitorStateException
- if AbstractQueuedSynchronizer.isHeldExclusively()
returns false
public final void signalAll()
signalAll
in interface Condition
IllegalMonitorStateException
- if AbstractQueuedSynchronizer.isHeldExclusively()
returns false
public final void awaitUninterruptibly()
AbstractQueuedSynchronizer.getState()
.
AbstractQueuedSynchronizer.release(int)
with saved state as argument,
throwing IllegalMonitorStateException if it fails.
AbstractQueuedSynchronizer.acquire(int)
with saved state as argument.
awaitUninterruptibly
in interface Condition
public final void await() throws InterruptedException
AbstractQueuedSynchronizer.getState()
.
AbstractQueuedSynchronizer.release(int)
with saved state as argument,
throwing IllegalMonitorStateException if it fails.
AbstractQueuedSynchronizer.acquire(int)
with saved state as argument.
await
in interface Condition
InterruptedException
- if the current thread is interrupted
(and interruption of thread suspension is supported)public final long awaitNanos(long nanosTimeout) throws InterruptedException
AbstractQueuedSynchronizer.getState()
.
AbstractQueuedSynchronizer.release(int)
with saved state as argument,
throwing IllegalMonitorStateException if it fails.
AbstractQueuedSynchronizer.acquire(int)
with saved state as argument.
awaitNanos
in interface Condition
nanosTimeout
- the maximum time to wait, in nanosecondsnanosTimeout
value minus
the time spent waiting upon return from this method.
A positive value may be used as the argument to a
subsequent call to this method to finish waiting out
the desired time. A value less than or equal to zero
indicates that no time remains.InterruptedException
- if the current thread is interrupted
(and interruption of thread suspension is supported)public final boolean awaitUntil(Date deadline) throws InterruptedException
AbstractQueuedSynchronizer.getState()
.
AbstractQueuedSynchronizer.release(int)
with saved state as argument,
throwing IllegalMonitorStateException if it fails.
AbstractQueuedSynchronizer.acquire(int)
with saved state as argument.
awaitUntil
in interface Condition
deadline
- the absolute time to wait untilfalse
if the deadline has elapsed upon return, else
true
InterruptedException
- if the current thread is interrupted
(and interruption of thread suspension is supported)public final boolean await(long time, TimeUnit unit) throws InterruptedException
AbstractQueuedSynchronizer.getState()
.
AbstractQueuedSynchronizer.release(int)
with saved state as argument,
throwing IllegalMonitorStateException if it fails.
AbstractQueuedSynchronizer.acquire(int)
with saved state as argument.
await
in interface Condition
time
- the maximum time to waitunit
- the time unit of the time
argumentfalse
if the waiting time detectably elapsed
before return from the method, else true
InterruptedException
- if the current thread is interrupted
(and interruption of thread suspension is supported)protected final boolean hasWaiters()
AbstractQueuedSynchronizer.hasWaiters(ConditionObject)
.true
if there are any waiting threadsIllegalMonitorStateException
- if AbstractQueuedSynchronizer.isHeldExclusively()
returns false
protected final int getWaitQueueLength()
AbstractQueuedSynchronizer.getWaitQueueLength(ConditionObject)
.IllegalMonitorStateException
- if AbstractQueuedSynchronizer.isHeldExclusively()
returns false
protected final Collection<Thread> getWaitingThreads()
AbstractQueuedSynchronizer.getWaitingThreads(ConditionObject)
.IllegalMonitorStateException
- if AbstractQueuedSynchronizer.isHeldExclusively()
returns false
Submit a bug or feature
For further API reference and developer documentation, see Java SE Documentation. That documentation contains more detailed, developer-targeted descriptions, with conceptual overviews, definitions of terms, workarounds, and working code examples.
Copyright © 1993, 2017, Oracle and/or its affiliates. 500 Oracle Parkway
Redwood Shores, CA 94065 USA. All rights reserved.
DRAFT 9-internal+0-adhoc.mlchung.jdk9-jdeps