|
Java™ Platform Standard Ed. 6 |
|||||||||
| PREV CLASS NEXT CLASS | FRAMES NO FRAMES | |||||||||
| SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD | |||||||||
java.lang.Objectjava.util.concurrent.locks.AbstractQueuedSynchronizer.ConditionObject
public class AbstractQueuedSynchronizer.ConditionObject
Condition implementation for a 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 Summary | |
|---|---|
AbstractQueuedSynchronizer.ConditionObject()
Creates a new ConditionObject instance. |
|
| Method Summary | |
|---|---|
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. |
| Methods inherited from class java.lang.Object |
|---|
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait |
| Constructor Detail |
|---|
public AbstractQueuedSynchronizer.ConditionObject()
| Method Detail |
|---|
public final void signal()
signal in interface ConditionIllegalMonitorStateException - if AbstractQueuedSynchronizer.isHeldExclusively()
returns falsepublic final void signalAll()
signalAll in interface ConditionIllegalMonitorStateException - if AbstractQueuedSynchronizer.isHeldExclusively()
returns falsepublic 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 ConditionInterruptedException - 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 ConditionnanosTimeout - the maximum time to wait, in nanoseconds
nanosTimeout 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 Conditiondeadline - the absolute time to wait until
false 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 Conditiontime - the maximum time to waitunit - the time unit of the time argument
false 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(java.util.concurrent.locks.AbstractQueuedSynchronizer.ConditionObject).
true if there are any waiting threads
IllegalMonitorStateException - if AbstractQueuedSynchronizer.isHeldExclusively()
returns falseprotected final int getWaitQueueLength()
AbstractQueuedSynchronizer.getWaitQueueLength(java.util.concurrent.locks.AbstractQueuedSynchronizer.ConditionObject).
IllegalMonitorStateException - if AbstractQueuedSynchronizer.isHeldExclusively()
returns falseprotected final Collection<Thread> getWaitingThreads()
AbstractQueuedSynchronizer.getWaitingThreads(java.util.concurrent.locks.AbstractQueuedSynchronizer.ConditionObject).
IllegalMonitorStateException - if AbstractQueuedSynchronizer.isHeldExclusively()
returns false
|
Java™ Platform Standard Ed. 6 |
|||||||||
| PREV CLASS NEXT CLASS | FRAMES NO FRAMES | |||||||||
| SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD | |||||||||
Copyright 2006 Sun Microsystems, Inc. All rights reserved. Use is subject to license terms. Also see the documentation redistribution policy.