java.util.concurrent.locks
클래스 AbstractQueuedSynchronizer

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

모든 구현된 인터페이스:

Serializable

public abstract class AbstractQueuedSynchronizer
extends Object 
implements Serializable 

블록 락 및 선입처 방편 (FIFO) 대기 큐에 의존된 관련 동기화 장치 (semaphore, 이벤트등)를 구현하는 체제를 제공합니다. 이 클래스는 상태 표현을 단일의 원자 int 치에 의존된 대부분의 종류의 동기화 장치의 유용한 기반으로서 설계되고 있습니다. 서브 클래스는 이 상태를 변경하는 protected 메서드를 정의할 필요가 있어, 그 메서드는 취득 또는 해방중의 객체를 사용해 상태의 미를 정의합니다. 이것들이 지정되면, 이 클래스내의 다른 메서드는 모든 큐 및 블록 도구를 가동시킵니다. 서브 클래스는 다른 상태 필드를 유지할 수 있습니다만, 동기에 관한 추적을 실시할 수 있는 것은 getState(), setState(int) 및 compareAndSetState(int, int) 메서드를 사용해 조작되어 원자적으로 갱신된 int 치 뿐입니다.

서브 클래스는 public가 아닌 내부 헬퍼 클래스로서 정의해야 합니다. 이것은 그것을 둘러싸는 클래스의 동기 프로퍼티의 구현에 사용됩니다. AbstractQueuedSynchronizer 클래스는 동기 인터페이스를 일절 구현하지 않습니다. 그 대신해, 구상 락 및 관련된 동기화 장치에 의해 적당 호출해 public 메서드를 구현할 수 있는 acquireInterruptibly(int) 등의 메서드를 정의합니다.

이 클래스는 디폴트의 「배타」모드 및 「공유」모드의 언젠가 또는 양쪽 모두를 지원 합니다. 배타 모드로 취득되면, 다른 thread가 취득을 시도해도 성공하지 않습니다. 공유 모드에서는 복수의 thread에 한 취득이 가능합니다 (다만, 반드시 취득이 성공할 필요가 있는 것은 아니다). 이 클래스는 공유 모드의 취득이 성공했을 경우, 대기중의 다음의 thread (존재하는 경우)도 취득 가능한가 어떤가를 판별할 필요가 있다고 하는 도구 적인 미를 제외해, 이러한 차이를 「인식」하지 않습니다. 다른 모드로 대기중의 thread는 같은 FIFO 큐를 공유합니다. 보통, 구현 서브 클래스는 이러한 모드의 1개 만을 지원 합니다만, ReadWriteLock 등에서는 양쪽 모두가 기능하는 것이 가능합니다. 배타 모드 또는 공유 모드만을 지원하는 서브 클래스는 사용하지 않는 모드를 지원하는 메서드를 정의할 필요는 없습니다.

이 클래스는 배타 모드를 지원하는 서브 클래스에 의해 Condition 구현으로서 사용 가능한, 상자로 된 AbstractQueuedSynchronizer.ConditionObject 클래스를 정의합니다. isHeldExclusively() 는 이 클래스에 관계되어, 동기가 현재의 thread에 관해서 배타적으로 보관 유지되는지, 현재의 getState() 치를 사용해 불려 간 release(int) 메서드가 이 객체를 완전하게 해방하는지, 이 보존이 끝난 상태값이 지정되면 acquire(int) 가 최종적으로 이 객체를 이전에 취득된 상태에 복원하는지를 리포트합니다. 그 이외에서는 AbstractQueuedSynchronizer 메서드는 이 상태를 작성하지 않기 때문에 이 제한을 채울 수가 없는 경우는 사용하지 말아 주세요. 당연한 일입니다만, AbstractQueuedSynchronizer.ConditionObject 동작은 동기화 장치 구현의 시멘틱스에 의존합니다.

이 클래스는 내부 큐의 검증, 파악 및 감시용 메서드 및 상태 객체용의 유사 메서드를 제공합니다. 이것들은 필요하게 응해 동기도구 의 AbstractQueuedSynchronizer를 사용해 클래스내에 export 할 수 있습니다.

이 클래스를 직렬화하면, 기본으로 되는 원자 정수의 보수 상태만이 포함되기 때문에 직렬화 복원된 객체는 비어있는 thread 큐를 보관 유지합니다. 직렬화 기능을 필요로 하는 보통 의 서브 클래스는 직렬화 복원시에 이것을 기존의 초기 상태에 복원하는 readObject 메서드를 정의합니다.

사용법

이 클래스를 동기화 장치의 베이스로서 사용하려면, 적용 가능하면 getState(), setState(int), compareAndSetState(int, int)를 사용해 동기 상태의 검증이나 변경을 실시하는 것으로 다음의 메서드를 재정의합니다.

• tryAcquire(int)
• tryRelease(int)
• tryAcquireShared(int)
• tryReleaseShared(int)
• isHeldExclusively()

이러한 각 메서드는 디폴트로 UnsupportedOperationException를 Throw 합니다. 이러한 메서드의 구현은 내부가 thread 세이프가 아니면 안되어, 또, 일반적으로 짧고 한편 블로킹없이 없으면 안됩니다. 이러한 메서드의 정의는 이 클래스의 지원 되는 유일한 사용 방법입니다. 다른 메서드는 모두, 개별적으로 변경할 수 없기 때문에 final 라고 선언됩니다.

이 클래스는 내부의 FIFO 큐에 근거한다고는 해도, 자동적으로 FIFO 취득 정책가 적용되는 것은 아닙니다. 배타적인 동기의 코어는 다음의 형식이 됩니다.

Acquire:
while (! tryAcquire(arg)) {
enqueue thread if it is not already queued;
possibly block current thread;
}

Release:
if (tryRelease(arg))
unblock the first queued thread;

(공유 모드도 비슷하지만, cascade 신호가 관계된인 경우가 있다)

취득의 체크는 큐에 넣어지기 전에 불려가 므로 새롭게 취득되는 thread는 블록 및 큐에 넣어지는 다른 thread보다 먼저 「화물 운반선 한다」일이 가능합니다. 다만, 필요하면, tryAcquire 이나 tryAcquireShared를 정의해, 1개 이상의 검증 메서드를 내부에서 호출하는 것으로 화물 운반선을 무효로 할 수 있습니다. 특히, 엄밀한 FIFO 락은 tryAcquire를 정의해, getFirstQueuedThread() 가 현재의 thread를 돌려주지 않는 경우에 즉시 false를 돌려주는 것이 가능합니다. 보통 바람직한 비엄밀해 편향이 없는 버전은, hasQueuedThreads() 가 true를 돌려주고, getFirstQueuedThread가 현재의 thread가 아닌 (즉 getFirstQueuedThread가 null 에서도 현재의 thread도 아니다) 경우에게만, 즉시 false를 돌려줄 수가 있습니다. 새로운 바리에이션이 가능합니다.

보통, throughput와 스케이라비리티는 디폴트의 화물 운반선 ( 「탐욕」, 「방폐」, 「호송 회피」라고도 불린다) 스트래터지의 최상정도에 위치합니다. 이것이 편향이 없고, 고갈하지 않는 것은 보증됩니다만, 먼저 큐에 넣어진 thread는 나중에 큐에 넣어지는 thread보다 전에 재경합이 허가되어 각 재경합은 착신하는 thread에 대해서 성공하는 공평한 기회를 보관 유지합니다. 또, 취득은 보통 적인 미에서는 「스핀」하지 않습니다만, 블로킹전에 다른 계산에 삽입된 tryAcquire 복수의 호출을 실행 가능합니다. 이것에 의해 배타적인 동기가 단기적으로 보관 유지될 뿐의 경우, 스핀의 혜택의 대부분을 향수할 수 있습니다. 게다가 배타적인 동기가 보관 유지되지 않는 경우에는 거의 부담없이, 그 혜택을 향수할 수 있습니다. 필요하게 응해 「지름길」체크를 가지는 메서드를 얻는 호출을 앞두고 배치하는 것으로 이 값을 늘릴 수가 있습니다. 이것은 동기화 장값이 경합 할 가능성이 적은 경우, hasContended() 나 hasQueuedThreads()를 사전에 체크하는 등 방법으로 실행할 수 있습니다.

이 클래스는 사용 범위를 int 상태, 파라미터의 취득과 해방 및 내부 FIFO 대기 큐에 존 가능한 동기화 장치로 한정하는 것으로 효율적으로 확장성의 높은 동기 기반의 일부를 제공합니다. 이것이라도 충분하지 않는 경우, atomic 클래스, 독자적인 커스텀 Queue 클래스 및 LockSupport 블록 지원를 사용해, 동기화 장치를 저레벨로부터 구축할 수 있습니다.

사용예

이하에 값제로를 사용해 락 해제 상태 및 락 상태를 나타내는 재입 불가능한 상호 배타 락 클래스를 나타냅니다. 이것은 상태의 지원 및 몇개의 파악 메서드의 공개도 실시합니다.

class Mutex implements Lock, java.io.Serializable {

// Our internal helper class
private static class Sync extends AbstractQueuedSynchronizer {
// Report whether in locked state
    protected boolean isHeldExclusively() { 
return getState() == 1; 
}

// Acquire the lock if state is zero
public boolean tryAcquire(int acquires) {
assert acquires == 1; // Otherwise unused
return compareAndSetState(0, 1);
}

// Release the lock by setting state to zero
protected boolean tryRelease(int releases) {
assert releases == 1; // Otherwise unused
if (getState() == 0) throw new IllegalMonitorStateException();
setState(0);
return true;
}

// Provide a Condition
Condition newCondition() { return new ConditionObject(); }

// Deserialize properly
private void readObject(ObjectInputStream s) throws IOException, ClassNotFoundException {
s.defaultReadObject();
setState(0); // reset to unlocked state
}
}

// The sync object does all the hard work.  We just forward to it.
private final Sync sync = new Sync();

public void lock()                { sync.acquire(1); }
public boolean tryLock()          { return sync.tryAcquire(1); }
public void unlock()              { sync.release(1); }
public Condition newCondition()   { return sync.newCondition(); }
public boolean isLocked()         { return sync.isHeldExclusively(); }
public boolean hasQueuedThreads() { return sync.hasQueuedThreads(); }
public void lockInterruptibly() throws InterruptedException { 
sync.acquireInterruptibly(1);
}
public boolean tryLock(long timeout, TimeUnit unit) throws InterruptedException {
return sync.tryAcquireNanos(1, unit.toNanos(timeout));
}
}

이하에 시작에 단일의 signal를 필요로 하는 것을 제외해, CountDownLatch 클래스에 유사한 빗장 클래스를 나타냅니다. 빗장은 비배타적이기 때문에 shared 취득 및 해방 메서드를 사용합니다.

class BooleanLatch {

private static class Sync extends AbstractQueuedSynchronizer {
boolean isSignalled() { return getState() ! = 0; }

protected int tryAcquireShared(int ignore) {
return isSignalled()?  1 : -1;
}

protected boolean tryReleaseShared(int ignore) {
setState(1);
return true;
}
}

private final Sync sync = new Sync();
public boolean isSignalled() { return sync.isSignalled(); }
public void signal()         { sync.releaseShared(1); }
public void await() throws InterruptedException {
sync.acquireSharedInterruptibly(1);
}
}

도입된 버전 :

1.5

관련 항목:

직렬화 된 형식

중첩(Nested) 클래스 개요

class

AbstractQueuedSynchronizer.ConditionObject Lock 구현의 기반으로서 기능하는 AbstractQueuedSynchronizer 상태 구현 이 클래스의 메서드 문서에는 Lock 및 Condition 사용자 로부터 본 동작 사양은 아니고, 내부 도구가 기재되어 있습니다.

생성자 개요

protected

AbstractQueuedSynchronizer () 제로의 초기 동기 상태를 사용해, 새로운 AbstractQueuedSynchronizer 인스턴스를 작성합니다.

메서드 개요

void	acquire (int arg) 인터럽트를 무시해, 배타 모드로 취득합니다.
void	acquireInterruptibly (int arg) 배타 모드로 취득합니다.
void	acquireShared (int arg) 인터럽트를 무시해, 공유 모드로 취득합니다.
void	acquireSharedInterruptibly (int arg) 공유 모드로 취득합니다.
protected boolean	compareAndSetState (int expect, int update) 현재 상태값이 예상되는 값에 동일한 경우, 동기 상태가 지정된 갱신치에 원자적으로 설정합니다.
Collection <Thread >	getExclusiveQueuedThreads () 배타 모드로 취득하기 위해서 대기중의 thread를 포함한 컬렉션을 리턴합니다.
Thread	getFirstQueuedThread () 큐내의 최초의 (대기 시간의 가장 길다) thread를 리턴합니다.
Collection <Thread >	getQueuedThreads () 취득을 대기하고 있는 thread를 포함한 컬렉션을 리턴합니다.
int	getQueueLength () 취득을 대기하고 있는 thread의 추정수를 리턴합니다.
Collection <Thread >	getSharedQueuedThreads () 공유 모드로 취득하기 위해서 대기중의 thread를 포함한 컬렉션을 리턴합니다.
protected int	getState () 동기 상태의 현재 상태를 리턴합니다.
Collection <Thread >	getWaitingThreads (AbstractQueuedSynchronizer.ConditionObject condition) 이 동기화 장치에 관련된 지정 상태로 대기중의 thread를 포함한 컬렉션을 리턴합니다.
int	getWaitQueueLength (AbstractQueuedSynchronizer.ConditionObject condition) 이 동기화 장치에 관련된 지정 상태로 대기하고 있는 thread의 추정수를 리턴합니다.
boolean	hasContended () 이 동기화 장치의 취득으로 경합 하고 있는 thread가 존재할지 어떨지 (즉, acquire 메서드가 블록 되었는지 어떠했는지)를 조회합니다.
boolean	hasQueuedThreads () 취득을 대기중의 thread가 존재할지 어떨지를 조회합니다.
boolean	hasWaiters (AbstractQueuedSynchronizer.ConditionObject condition) 이 동기화 장치에 관련된 지정 상태로 대기하고 있는 thread가 존재할지 어떨지를 조회합니다.
protected boolean	isHeldExclusively () 현재의 (호출측의) thread에 관해서, 동기가 배타적으로 행해지는 경우는 true를 리턴합니다.
boolean	isQueued (Thread thread) 지정된 thread가 현재, 큐에 넣어지고 있는 경우는 true를 리턴합니다.
boolean	owns (AbstractQueuedSynchronizer.ConditionObject condition) 지정된 ConditionObject가 이 동기화 장치를 락으로서 사용할지 어떨지를 조회합니다.
boolean	release (int arg) 배타 모드로 해방합니다.
boolean	releaseShared (int arg) 공유 모드로 해방합니다.
protected void	setState (int newState) 동기 상태의 값을 설정합니다.
String	toString () 동기화 장치 및 그 상태를 식별하는 캐릭터 라인을 리턴합니다.
protected boolean	tryAcquire (int arg) 배타 모드에서의 취득을 시도합니다.
boolean	tryAcquireNanos (int arg, long nanosTimeout) 배타 모드로 취득을 시도합니다.
protected int	tryAcquireShared (int arg) 공유 모드에서의 취득을 시도합니다.
boolean	tryAcquireSharedNanos (int arg, long nanosTimeout) 공유 모드로 취득을 시도합니다.
protected boolean	tryRelease (int arg) 배타 모드에서의 해방을 반영하도록, 상태의 설정을 시도합니다.
protected boolean	tryReleaseShared (int arg) 공유 모드에서의 해방을 반영하도록, 상태의 설정을 시도합니다.

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

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

생성자 상세

AbstractQueuedSynchronizer

protected AbstractQueuedSynchronizer()

제로의 초기 동기 상태를 사용해, 새로운 AbstractQueuedSynchronizer 인스턴스를 작성합니다.

메서드의 상세

getState

protected final int getState()

동기 상태의 현재상태 를 리턴합니다. 이 조작은, volatile 읽을 memory semantics를 보관 유지합니다.

반환값:

현재 상태치

setState

protected final void setState(int newState)

동기 상태의 값을 설정합니다. 이 조작은, volatile 출력의 memory semantics를 보관 유지합니다.

파라미터:

newState - 새로운 상태치

compareAndSetState

protected final boolean compareAndSetState(int expect,
                                           int update)

현재 상태값이 예상되는 값에 동일한 경우, 동기 상태가 지정된 갱신치에 원자적으로 설정합니다. 이 조작은, volatile read 및 출력의 memory semantics를 보관 유지합니다.

파라미터:

expect - 예상되는 값

update - 새로운 값

반환값:

성공하는 경우는 true. false는 실제의 값이 예상되는 값과 등가가 아닌 것을 나타낸다

tryAcquire

protected boolean tryAcquire(int arg)

배타 모드에서의 취득을 시도합니다. 이 메서드는 객체가 배타 모드에서의 취득을 허가하는 상태에 있을지 어떨지를 조회해, 허가하는 상태에 있으면 취득합니다.

이 메서드는 항상 취득을 실행하는 thread에 의해 호출합니다. 이 메서드가 실패를 리포트해, 한편 thread가 큐에 넣어지지 않은 경우, 취득 메서드는 다른 thread로부터의 해방에 의해 신호가 송신될 때까지 그 thread를 큐에 넣을 수가 있습니다. 이것은, Lock.tryLock() 메서드의 구현에 사용할 수 있습니다.

디폴트 구현은, UnsupportedOperationException를 Throw 합니다.

파라미터:

arg - acquire 인수. 이 값은 항상 acquire 메서드에게 건네지는 값, 또는 상태 대기에의 엔트리로 보존되는 값이 된다. 그 외의 경우, 이 값은 미해석이 되어, 임의의 값을 나타낼 수가 있다

반환값:

성공하는 경우는 true. 성공시에는 이 객체는 취득이 끝난 상태이다

예외:

IllegalMonitorStateException - 취득에의해 이 동기화 장값이 부정한 상태에 놓여지는 경우. 동기가 올바르게 기능하기 위해서는 이 예외를 일관한 방식에서 Throw 할 필요가 있다

UnsupportedOperationException - 배타 모드가 지원 되어 있지 않은 경우

tryRelease

protected boolean tryRelease(int arg)

배타 모드에서의 해방을 반영하도록, 상태의 설정을 시도합니다.

이 메서드는 해방을 실행하는 thread에 의해 항상 호출합니다.

디폴트 구현은, UnsupportedOperationException를 Throw 합니다.

파라미터:

arg - release 인수. 이 값은 항상 release 메서드에게 건네지는 값, 또는 상태 대기에의 엔트리에서의 현재 상태값이 된다. 그 외의 경우, 이 값은 미해석이 되어, 임의의 값을 나타낼 수가 있다

반환값:

대기중의 임의의 thread가 취득을 시도할 수가 있도록, 이 객체가 완전하게 해방된 상태에 있는 경우는 true, 그렇지 않은 경우는 false

예외:

IllegalMonitorStateException - 해방에의해 이 동기화 장값이 부정한 상태에 놓여지는 경우. 동기가 올바르게 기능하기 위해서는 이 예외를 일관한 방식에서 Throw 할 필요가 있다

UnsupportedOperationException - 배타 모드가 지원 되어 있지 않은 경우

tryAcquireShared

protected int tryAcquireShared(int arg)

공유 모드에서의 취득을 시도합니다. 이 메서드는 객체가 공유 모드에서의 취득을 허가하는 상태에 있을지 어떨지를 조회해, 허가하는 상태에 있으면 취득합니다.

이 메서드는 항상 취득을 실행하는 thread에 의해 호출합니다. 이 메서드가 실패를 리포트해, 한편 thread가 큐에 넣어지지 않은 경우, 취득 메서드는 다른 thread로부터의 해방에 의해 신호가 송신될 때까지 그 thread를 큐에 넣을 수가 있습니다.

디폴트 구현은, UnsupportedOperationException를 Throw 합니다.

파라미터:

arg - acquire 인수. 이 값은 항상 acquire 메서드에게 건네지는 값, 또는 상태 대기에의 엔트리로 보존되는 값이 된다. 그 외의 경우, 이 값은 미해석이 되어, 임의의 값을 나타낼 수가 있다

반환값:

실패했을 경우는 잘못된 값, 배타적으로 성공했을 경우는 제로 비배타적으로 성공했을 경우는 정의 값. 어느 경우에서도, 후속의 대기 thread는 가용성을 체크할 필요가 있다 (3 개이 다른 반환값의 지원에 의해 취득만이 때때로 배타적으로 동작하는 컨텍스트 내에서 이 메서드를 사용하는 것이 가능하게 된다). 성공시에는 이 객체는 취득이 끝난 상태이다

예외:

IllegalMonitorStateException - 취득에의해 이 동기화 장값이 부정한 상태에 놓여지는 경우. 동기가 올바르게 기능하기 위해서는 이 예외를 일관한 방식에서 Throw 할 필요가 있다

UnsupportedOperationException - 공유 모드가 지원 되어 있지 않은 경우

tryReleaseShared

protected boolean tryReleaseShared(int arg)

공유 모드에서의 해방을 반영하도록, 상태의 설정을 시도합니다.

이 메서드는 해방을 실행하는 thread에 의해 항상 호출합니다.

디폴트 구현은, UnsupportedOperationException를 Throw 합니다.

파라미터:

arg - release 인수. 이 값은 항상 release 메서드에게 건네지는 값, 또는 상태 대기에의 엔트리에서의 현재 상태값이 된다. 그 외의 경우, 이 값은 미해석이 되어, 임의의 값을 나타낼 수가 있다

반환값:

대기중의 임의의 thread가 취득을 시도할 수가 있도록, 이 객체가 완전하게 해방된 상태에 있는 경우는 true, 그렇지 않은 경우는 false

예외:

IllegalMonitorStateException - 해방에의해 이 동기화 장값이 부정한 상태에 놓여지는 경우. 동기가 올바르게 기능하기 위해서는 이 예외를 일관한 방식에서 Throw 할 필요가 있다

UnsupportedOperationException - 공유 모드가 지원 되어 있지 않은 경우

isHeldExclusively

protected boolean isHeldExclusively()

현재의 (호출측의) thread에 관해서, 동기가 배타적으로 행해지는 경우는 true를 리턴합니다. 비대기 상태 AbstractQueuedSynchronizer.ConditionObject 메서드가 불려 갈 때 마다, 이 메서드가 호출됩니다 (대기 상태의 메서드에서는 release(int) 가 불려 간다).

디폴트 구현은, UnsupportedOperationException를 Throw 합니다. 이 메서드는 AbstractQueuedSynchronizer.ConditionObject 메서드로 내부적에게만 불려가기 때문에 상태가 사용되지 않는 경우는 정의할 필요가 없습니다.

반환값:

동기가 배타적으로 행해지는 경우는 true, 그렇지 않은 경우는 false

예외:

UnsupportedOperationException - 상태가 지원 되지 않는 경우

acquire

public final void acquire(int arg)

인터럽트를 무시해, 배타 모드로 취득합니다. 한 번 이상 tryAcquire(int)를 호출하는 것으로 구현되어 성공시에 복귀합니다. 그 외의 경우, thread는 큐에 넣어져 대체로의 경우 블록 및 블록 해제를 몇번이나 반복해, 성공할 때까지 tryAcquire(int)를 호출합니다. 이 메서드는 Lock.lock() 메서드의 구현에 사용할 수 있습니다.

파라미터:

arg - acquire 인수. 이 값은 tryAcquire(int)에 송신되지만, 그 외의 경우는 미해석이 되어, 임의의 값을 나타낼 수가 있다

acquireInterruptibly

public final void acquireInterruptibly(int arg)
                                throws InterruptedException 

배타 모드로 취득합니다. 인터럽트가 발생했을 경우는 중지합니다. 최초로 끼어들어 상태를 체크하고 나서 한 번 이상 tryAcquire(int)를 호출하는 것으로 구현되어 성공시에 복귀합니다. 그 외의 경우, thread는 큐에 넣어져 대체로의 경우 블록 및 블록 해제를 몇번이나 반복해, 성공할까 thread로 인터럽트가 발생할 때까지 tryAcquire(int)를 호출합니다. 이 메서드는 Lock.lockInterruptibly() 메서드의 구현에 사용할 수 있습니다.

파라미터:

arg - acquire 인수. 이 값은 tryAcquire(int)에 송신되지만, 그 외의 경우는 미해석이 되어, 임의의 값을 나타낼 수가 있다

예외:

InterruptedException - 현재의 thread로 인터럽트가 발생했을 경우

tryAcquireNanos

public final boolean tryAcquireNanos(int arg,
                                     long nanosTimeout)
                              throws InterruptedException 

배타 모드로 취득을 시도합니다. 인터럽트가 발생했을 경우는 중지해, 지정된 타임 아웃 시간이 경과했을 경우는 실패합니다. 최초로 끼어들어 상태를 체크하고 나서 한 번 이상 tryAcquire(int)를 호출하는 것으로 구현되어 성공시에 복귀합니다. 그 외의 경우, thread는 큐에 넣어져 대체로의 경우 블록 및 블록 해제를 몇번이나 반복해, 성공할까 thread로 인터럽트가 발생하는지, 타임 아웃 시간이 경과할 때까지 tryAcquire(int)를 호출합니다. 이 메서드는 Lock.tryLock(long, TimeUnit) 메서드의 구현에 사용할 수 있습니다.

파라미터:

arg - acquire 인수. 이 값은 tryAcquire(int)에 송신되지만, 그 외의 경우는 미해석이 되어, 임의의 값을 나타낼 수 있는

nanosTimeout - 대기하는 최대 나노초수

반환값:

취득했을 경우는 true, 타임 아웃 했을 경우는 false

예외:

InterruptedException - 현재의 thread로 인터럽트가 발생했을 경우

release

public final boolean release(int arg)

배타 모드로 해방합니다. tryRelease(int) 가 true를 돌려주는 경우, 1개 이상의 thread를 블록 해제하는 것으로 구현됩니다. 이 메서드는 Lock.unlock() 메서드의 구현으로 사용할 수 있습니다.

파라미터:

arg - release 인수. 이 값은 tryRelease(int)에 송신되지만, 그 외의 경우는 미해석이 되어, 임의의 값을 나타낼 수가 있다

반환값:

tryRelease(int) 로부터 리턴된 값

acquireShared

public final void acquireShared(int arg)

인터럽트를 무시해, 공유 모드로 취득합니다. 최초로 한 번 이상 tryAcquireShared(int)를 호출하는 것으로 구현되어 성공시에 복귀합니다. 그 외의 경우, thread는 큐에 넣어져 대체로의 경우 블록 및 블록 해제를 몇번이나 반복해, 성공할 때까지 tryAcquireShared(int)를 호출합니다.

파라미터:

arg - acquire 인수. 이 값은 tryAcquireShared(int)에 송신되지만, 그 외의 경우는 미해석이 되어, 임의의 값을 나타낼 수가 있다

acquireSharedInterruptibly

public final void acquireSharedInterruptibly(int arg)
                                      throws InterruptedException 

공유 모드로 취득합니다. 인터럽트가 발생했을 경우에는 중지합니다. 최초로 끼어들어 상태를 체크하고 나서, 한 번 이상 tryAcquireShared(int)를 호출하는 것으로 구현되어 성공시에 복귀합니다. 그 외의 경우, thread는 큐에 넣어져 대체로의 경우 블록 및 블록 해제를 몇번이나 반복해, 성공할까 thread로 인터럽트가 발생할 때까지 tryAcquireShared(int)를 호출합니다.

파라미터:

arg - acquire 인수. 이 값은 tryAcquireShared(int)에 송신되지만, 그 외의 경우는 미해석이 되어, 임의의 값을 나타낼 수가 있다

예외:

InterruptedException - 현재의 thread로 인터럽트가 발생했을 경우

tryAcquireSharedNanos

public final boolean tryAcquireSharedNanos(int arg,
                                           long nanosTimeout)
                                    throws InterruptedException 

공유 모드로 취득을 시도합니다. 인터럽트가 발생했을 경우는 중지해, 지정된 타임 아웃 시간이 경과했을 경우는 실패합니다. 최초로 끼어들어 상태를 체크하고 나서, 한 번 이상 tryAcquireShared(int)를 호출하는 것으로 구현되어 성공시에 복귀합니다. 그 외의 경우, thread는 큐에 넣어져 대체로의 경우 블록 및 블록 해제를 몇번이나 반복해, 성공하는지, thread로 인터럽트가 발생하는지, 타임 아웃 시간이 경과할 때까지 tryAcquireShared(int)를 호출합니다.

파라미터:

arg - acquire 인수. 이 값은 tryAcquireShared(int)에 송신되지만, 그 외의 경우는 미해석이 되어, 임의의 값을 나타낼 수 있는

nanosTimeout - 대기하는 최대 나노초수

반환값:

취득했을 경우는 true, 타임 아웃 했을 경우는 false

예외:

InterruptedException - 현재의 thread로 인터럽트가 발생했을 경우

releaseShared

public final boolean releaseShared(int arg)

공유 모드로 해방합니다. tryReleaseShared(int) 가 true를 돌려주는 경우, 1개 이상의 thread를 블록 해제하는 것으로 구현됩니다.

파라미터:

arg - release 인수. 이 값은 tryReleaseShared(int)에 송신되지만, 그 외의 경우는 미해석이 되어, 임의의 값을 나타낼 수가 있다

반환값:

tryReleaseShared(int) 로부터 리턴된 값

hasQueuedThreads

public final boolean hasQueuedThreads()

취득을 대기중의 thread가 존재할지 어떨지를 조회합니다. 언젠가는 끼어들어 및 타임 아웃에 한 취소가 발생했을 경우, true가 돌려주고져도 다른 thread가 취득을 실행하는 것은 보증되지 않습니다.

이 구현에서는 이 조작은 일정한 시간에 복귀합니다.

반환값:

락의 취득을 대기중의 다른 thread가 존재할 가능성이 있는 경우는 true

hasContended

public final boolean hasContended()

이 동기화 장치의 취득으로 경합 하고 있는 thread가 존재할지 어떨지 (즉, acquire 메서드가 블록 되었는지 어떠했는지)를 조회합니다.

이 구현에서는 이 조작은 일정한 시간에 복귀합니다.

반환값:

경합이 존재하는 경우는 true

getFirstQueuedThread

public final Thread  getFirstQueuedThread()

큐내의 최초의 (대기 시간의 가장 길다) thread를 리턴합니다. 현재 큐에 넣어지고 있는 thread가 존재하지 않는 경우는 null을 리턴합니다.

보통, 이 구현에서는 이 조작은 일정시간으로 복귀합니다. 다만, 다른 thread가 큐의 변경을 동시에 실행하고 있는 경우는 경합에 의해 처리를 반복하는 경우가 있습니다.

반환값:

큐내의 최초의 (대기 시간의 가장 길다) thread. 현재 큐에 넣어지고 있는 thread가 존재하지 않는 경우는 null

isQueued

public final boolean isQueued(Thread  thread)

지정된 thread가 현재, 큐에 넣어지고 있는 경우는 true를 리턴합니다.

이 구현은 큐를 traversal의해 지정된 thread의 존재를 판별합니다.

파라미터:

thread - thread

반환값:

지정된 thread가 큐에 존재하는 경우는 true

예외:

NullPointerException - thread가 null인 경우

getQueueLength

public final int getQueueLength()

취득을 대기하고 있는 thread의 추정수를 리턴합니다. 이 메서드가 내부의 데이터 구조를 traversal 하고 있는 동안에도, thread수가 동적으로 변화하는 경우가 있기 때문에 이 값은 추정에 지나지 않습니다. 이 메서드는 동기의 제어용은 아니고, 시스템 상태를 감시하기 위한 것입니다.

반환값:

이 락을 대기하고 있는 thread의 추정수

getQueuedThreads

public final Collection <Thread > getQueuedThreads()

취득을 대기하고 있는 thread를 포함한 컬렉션을 리턴합니다. 실제의 thread 세트는 결과의 구축중에도 동적으로 변화할 가능성이 있기 때문에 리턴된 컬렉션은 최선이 노력한 다음의 추정에 지나지 않습니다. 리턴된 컬렉션의 요소에는 특정의 순서는 존재하지 않습니다. 이 메서드는 보다 포괄적인 감시 기능을 제공하는 서브 클래스의 구축을 용이하게 하는 목적으로 설계되고 있습니다.

반환값:

thread의 컬렉션

getExclusiveQueuedThreads

public final Collection <Thread > getExclusiveQueuedThreads()

배타 모드로 취득하기 위해서 대기중의 thread를 포함한 컬렉션을 리턴합니다. 이것은 배타적 취득을 위해서 대기중의 thread만을 돌려주는 것을 제외해서는 getQueuedThreads() 와 같은 프로퍼티를 보관 유지합니다.

반환값:

thread의 컬렉션

getSharedQueuedThreads

public final Collection <Thread > getSharedQueuedThreads()

공유 모드로 취득하기 위해서 대기중의 thread를 포함한 컬렉션을 리턴합니다. 이것은 공유적 취득을 위해서 대기중의 thread만을 돌려주는 것을 제외해, getQueuedThreads() 와 같은 프로퍼티를 보관 유지합니다.

반환값:

thread의 컬렉션

toString

public String  toString()

동기화 장치 및 그 상태를 식별하는 캐릭터 라인을 리턴합니다. 상태는 괄호로 둘러싸여 캐릭터 라인 「State =」에 이어 getState() 현재 상태 및 큐가 비어있는지에 대해 「nonempty」또는 「empty」가 포함됩니다.

오버라이드(override):

클래스 Object 내의 toString

반환값:

이 동기화 장치 및 그 상태를 식별하는 캐릭터 라인

owns

public final boolean owns(AbstractQueuedSynchronizer.ConditionObject  condition)

지정된 ConditionObject가 이 동기화 장치를 락으로서 사용할지 어떨지를 조회합니다.

파라미터:

condition - 상태

반환값:

소유되는 경우는 true

예외:

NullPointerException - 상태가 null인 경우

hasWaiters

public final boolean hasWaiters(AbstractQueuedSynchronizer.ConditionObject  condition)

이 동기화 장치에 관련된 지정 상태로 대기하고 있는 thread가 존재할지 어떨지를 조회합니다. 타임 아웃 및 인터럽트의 발생할 가능성은 언제라도 존재하기 위해, true는 장래의 signal가 thread를 시작시키는 것을 보증하지 않습니다. 이 메서드는 주로 시스템 상태의 감시에 사용하기 위한 것입니다.

파라미터:

condition - 상태

반환값:

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

예외:

IllegalMonitorStateException - 배타적 동기가 보관 유지되지 않는 경우

IllegalArgumentException - 지정된 상태가 이 동기화 장치와 관련지을 수 있지 않은 경우

NullPointerException - 상태가 null인 경우

getWaitQueueLength

public final int getWaitQueueLength(AbstractQueuedSynchronizer.ConditionObject  condition)

이 동기화 장치에 관련된 지정 상태로 대기하고 있는 thread의 추정수를 리턴합니다. 타임 아웃 및 인터럽트의 발생할 가능성은 언제라도 존재하기 위해, 추정수는 실제의 대기자수에 관한 상한을 나타내는에 지나지 않습니다. 이 메서드는 동기의 제어용으로서가 아니고, 시스템 상태의 감시용으로서 설계되고 있습니다.

파라미터:

condition - 상태

반환값:

대기중의 thread의 추정수

예외:

IllegalMonitorStateException - 배타적 동기가 보관 유지되지 않는 경우

IllegalArgumentException - 지정된 상태가 이 동기화 장치와 관련지을 수 있지 않은 경우

NullPointerException - 상태가 null인 경우

getWaitingThreads

public final Collection <Thread > getWaitingThreads(AbstractQueuedSynchronizer.ConditionObject  condition)

이 동기화 장치에 관련된 지정 상태로 대기중의 thread를 포함한 컬렉션을 리턴합니다. 실제의 thread 세트는 결과의 구축중에 동적으로 변화할 가능성이 있기 때문에 리턴된 컬렉션은 최선이 노력한 다음의 추정에 지나지 않습니다. 리턴된 컬렉션의 요소에는 특정의 순서는 존재하지 않습니다.

파라미터:

condition - 상태

반환값:

thread의 컬렉션

예외:

IllegalMonitorStateException - 배타적 동기가 보관 유지되지 않는 경우

IllegalArgumentException - 지정된 상태가 이 동기화 장치와 관련지을 수 있지 않은 경우

NullPointerException - 상태가 null인 경우