java.util.concurrent.locks
클래스 AbstractQueuedSynchronizer.ConditionObject

java.lang.Object 
  java.util.concurrent.locks.AbstractQueuedSynchronizer.ConditionObject

모든 구현된 인터페이스:

Serializable, Condition

포함되어 있는 클래스:

AbstractQueuedSynchronizer

public class AbstractQueuedSynchronizer.ConditionObject
extends Object 
implements Condition,
 Serializable 

Lock 구현의 기반으로서 기능하는 AbstractQueuedSynchronizer 상태 구현

이 클래스의 메서드 문서에는 Lock 및 Condition 사용자 로부터 본 동작 사양은 아니고, 내부 도구가 기재되어 있습니다. 보통, 이 클래스의 export 된 버전에 는 관련된 AbstractQueuedSynchronizer 상태 시멘틱스를 기술한 문서를 첨부할 필요가 있습니다.

이 클래스는 Serializable 입니다만, 모든 필드는 일시 필드이기 때문에 직렬화 복원된 상태에서는 대기자는 존재하지 않습니다.

관련 항목:

직렬화 된 형식

생성자 개요

AbstractQueuedSynchronizer.ConditionObject ()
새로운 ConditionObject 인스턴스를 생성합니다.

메서드 개요

void	await () 끼어들어 가능한 상태 대기를 구현합니다.
boolean	await (long time, TimeUnit unit) 시간의 지정된 상태 대기를 구현합니다.
long	awaitNanos (long nanosTimeout) 시간의 지정된 상태 대기를 구현합니다.
void	awaitUninterruptibly () 끼어들어 불가능한 상태 대기를 구현합니다.
boolean	awaitUntil (Date deadline) 절대 시간의 지정된 상태 대기를 구현합니다.
protected Collection <Thread >	getWaitingThreads () 이 Condition 로 대기하고 있을 가능성이 있는 thread를 포함한 컬렉션을 리턴합니다.
protected int	getWaitQueueLength () 이 상태로 대기중의 thread의 추정수를 리턴합니다.
protected boolean	hasWaiters () 이 상태로 대기중의 thread가 존재할지 어떨지를 조회합니다.
void	signal () 가장 길게 대기하고 있는 thread가 존재하는 경우, 그것을 이 상태의 대기 큐로부터 소유하는 락의 대기 큐로 이동합니다.
void	signalAll () 모든 thread를, 이 상태의 대기 큐로부터 소유하는 락의 대기 큐로 이동합니다.

클래스 java.lang. Object 로부터 상속된 메서드

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

생성자 상세

AbstractQueuedSynchronizer.ConditionObject

public AbstractQueuedSynchronizer.ConditionObject()

새로운 ConditionObject 인스턴스를 생성합니다.

메서드의 상세

signal

public final void signal()

무엇보다 길게 대기하고 있는 thread가 존재하는 경우, 그것을 이 상태의 대기 큐로부터 소유하는 락의 대기 큐로 이동합니다.

정의:

인터페이스 Condition 내의 signal

예외:

IllegalMonitorStateException - AbstractQueuedSynchronizer.isHeldExclusively() 가 false를 돌려주는 경우

signalAll

public final void signalAll()

모든 thread를, 이 상태의 대기 큐로부터 소유하는 락의 대기 큐로 이동합니다.

정의:

인터페이스 Condition 내의 signalAll

예외:

IllegalMonitorStateException - AbstractQueuedSynchronizer.isHeldExclusively() 가 false를 돌려주는 경우

awaitUninterruptibly

public final void awaitUninterruptibly()

끼어들어 불가능한 상태 대기를 구현합니다.

1. AbstractQueuedSynchronizer.getState() 에 의해 리턴된 락 상태를 보존한다.
2. 보존 끝난 상태를 인수로서 AbstractQueuedSynchronizer.release(int)를 호출한다. 실패했을 경우는 IllegalMonitorStateException을 Throw 한다.
3. 신호가 보내질 때까지 블록 한다.
4. 보존 끝난 상태를 인수로서 특수한 버전의 AbstractQueuedSynchronizer.acquire(int)를 호출하는 것으로 취득을 재실행한다.

정의:

인터페이스 Condition 내의 awaitUninterruptibly

await

public final void await()
                 throws InterruptedException 

끼어들어 가능한 상태 대기를 구현합니다.

1. 현재의 thread로 인터럽트를 했을 경우는 InterruptedException을 Throw 한다.
2. AbstractQueuedSynchronizer.getState() 에 의해 리턴된 락 상태를 보존한다.
3. 보존 끝난 상태를 인수로서 AbstractQueuedSynchronizer.release(int)를 호출한다. 실패했을 경우는 IllegalMonitorStateException을 Throw 한다.
4. 신호가 송신되는지, 인터럽트가 발생할 때까지 블록 한다.
5. 보존 끝난 상태를 인수로서 특수한 버전의 AbstractQueuedSynchronizer.acquire(int)를 호출하는 것으로 취득을 재실행한다.
6. 스텝 4 블록중에 인터럽트가 발생했을 경우는 예외를 Throw 한다.

정의:

인터페이스 Condition 내의 await

예외:

InterruptedException - 현재의 thread로 인터럽트가 발생하는 ( 및 thread 중단의 인터럽트가 지원 된다) 경우

awaitNanos

public final long awaitNanos(long nanosTimeout)
                      throws InterruptedException 

시간의 지정된 상태 대기를 구현합니다.

1. 현재의 thread로 인터럽트를 했을 경우는 InterruptedException을 Throw 한다.
2. AbstractQueuedSynchronizer.getState() 에 의해 리턴된 락 상태를 보존한다.
3. 보존 끝난 상태를 인수로서 AbstractQueuedSynchronizer.release(int)를 호출한다. 실패했을 경우는 IllegalMonitorStateException을 Throw 한다.
4. 신호가 송신되는지, 인터럽트가 발생하는지, 타임 아웃 할 때까지 블록 한다.
5. 보존 끝난 상태를 인수로서 특수한 버전의 AbstractQueuedSynchronizer.acquire(int)를 호출하는 것으로 취득을 재실행한다.
6. 스텝 4 블록중에 인터럽트가 발생했을 경우는 InterruptedException을 Throw 한다.

정의:

인터페이스 Condition 내의 awaitNanos

파라미터:

nanosTimeout - 나노초단위의 대기 시간

반환값:

대기가 타임 아웃 했을 경우는 제로 아래의 값. 그렇지 않은 경우는 이 메서드의 복귀시의 추정 남은 시간 (nanosTimeout 인수보다 항상 작은 값이 된다)

예외:

InterruptedException - 현재의 thread로 인터럽트가 발생하는 ( 및 thread 중단의 인터럽트가 지원 된다) 경우

awaitUntil

public final boolean awaitUntil(Date  deadline)
                         throws InterruptedException 

절대 시간의 지정된 상태 대기를 구현합니다.

1. 현재의 thread로 인터럽트를 했을 경우는 InterruptedException을 Throw 한다.
2. AbstractQueuedSynchronizer.getState() 에 의해 리턴된 락 상태를 보존한다.
3. 보존 끝난 상태를 인수로서 AbstractQueuedSynchronizer.release(int)를 호출한다. 실패했을 경우는 IllegalMonitorStateException을 Throw 한다.
4. 신호가 송신되는지, 인터럽트가 발생하는지, 타임 아웃 할 때까지 블록 한다.
5. 보존 끝난 상태를 인수로서 특수한 버전의 AbstractQueuedSynchronizer.acquire(int)를 호출하는 것으로 취득을 재실행한다.
6. 스텝 4 블록중에 인터럽트가 발생했을 경우는 InterruptedException을 Throw 한다.
7. 스텝 4 블록중에 타임 아웃 했을 경우는 false를 돌려주고, 그렇지 않은 경우는 true를 돌려준다.

정의:

인터페이스 Condition 내의 awaitUntil

파라미터:

deadline - 대기하는 절대 시간

반환값:

복귀시에 기한이 경과하고 있는 경우는 false, 그렇지 않은 경우는 true

예외:

InterruptedException - 현재의 thread로 인터럽트가 발생하는 ( 및 thread 중단의 인터럽트가 지원 된다) 경우

await

public final boolean await(long time,
                           TimeUnit  unit)
                    throws InterruptedException 

시간의 지정된 상태 대기를 구현합니다.

1. 현재의 thread로 인터럽트를 했을 경우는 InterruptedException을 Throw 한다.
2. AbstractQueuedSynchronizer.getState() 에 의해 리턴된 락 상태를 보존한다.
3. 보존 끝난 상태를 인수로서 AbstractQueuedSynchronizer.release(int) 을 호출한다. 실패했을 경우는 IllegalMonitorStateException을 Throw 한다.
4. 신호가 송신되는지, 인터럽트가 발생하는지, 타임 아웃 할 때까지 블록 한다.
5. 보존 끝난 상태를 인수로서 특수한 버전의 AbstractQueuedSynchronizer.acquire(int)를 호출하는 것으로 취득을 재실행한다.
6. 스텝 4 블록중에 인터럽트가 발생했을 경우는 InterruptedException을 Throw 한다.
7. 스텝 4 블록중에 타임 아웃 했을 경우는 false를 돌려주고, 그렇지 않은 경우는 true를 돌려준다.

정의:

인터페이스 Condition 내의 await

파라미터:

time - 대기하는 최장 시간

unit - time 인수의 시간 단위

반환값:

메서드로부터의 복귀전에 대기 시간이 경과했던 것이 검출되었을 경우는 false, 그렇지 않은 경우는 true

예외:

InterruptedException - 현재의 thread로 인터럽트가 발생하는 ( 및 thread 중단의 인터럽트가 지원 된다) 경우

hasWaiters

protected final boolean hasWaiters()

이 상태로 대기중의 thread가 존재할지 어떨지를 조회합니다. AbstractQueuedSynchronizer.hasWaiters(java.util.concurrent.locks.AbstractQueuedSynchronizer.ConditionObject)를 구현합니다.

반환값:

대기중의 thread가 존재하는 경우는 true

예외:

IllegalMonitorStateException - AbstractQueuedSynchronizer.isHeldExclusively() 가 false를 돌려주는 경우

getWaitQueueLength

protected final int getWaitQueueLength()

이 상태로 대기중의 thread의 추정수를 리턴합니다. AbstractQueuedSynchronizer.getWaitQueueLength(java.util.concurrent.locks.AbstractQueuedSynchronizer.ConditionObject)를 구현합니다.

반환값:

대기중의 thread의 추정수

예외:

IllegalMonitorStateException - AbstractQueuedSynchronizer.isHeldExclusively() 가 false를 돌려주는 경우

getWaitingThreads

protected final Collection <Thread > getWaitingThreads()

이 Condition 로 대기하고 있을 가능성이 있는 thread를 포함한 컬렉션을 리턴합니다. AbstractQueuedSynchronizer.getWaitingThreads(java.util.concurrent.locks.AbstractQueuedSynchronizer.ConditionObject)를 구현합니다.

반환값:

thread의 컬렉션

예외:

IllegalMonitorStateException - AbstractQueuedSynchronizer.isHeldExclusively() 가 false를 돌려주는 경우