java.util.concurrent.locks
클래스 ReentrantReadWriteLock.WriteLock

java.lang.Object 
  java.util.concurrent.locks.ReentrantReadWriteLock.WriteLock

모든 구현된 인터페이스:

Serializable, Lock

포함되어 있는 클래스:

ReentrantReadWriteLock

public static class ReentrantReadWriteLock.WriteLock
extends Object 
implements Lock,
 Serializable 

ReentrantReadWriteLock.writeLock() 메서드에 의해 리턴된 락

관련 항목:

직렬화 된 형식

생성자 개요

protected

ReentrantReadWriteLock.WriteLock (ReentrantReadWriteLock lock) 서브 클래스에 의해 사용되는 생성자 입니다.

메서드 개요

void	lock () 출력 락을 취득합니다.
void	lockInterruptibly () 현재의 thread가 interrupted 가 아닌 한, 출력 락을 취득합니다.
Condition	newCondition () 이 Lock 인스턴스로 사용하는 Condition 인스턴스를 리턴합니다.
String	toString () 이 락을 식별하는 캐릭터 라인 및 락 상태를 리턴합니다.
boolean	tryLock () 호출시에 다른 thread에 의해 보관 유지되어 있지 않은 경우에만, 출력 락을 취득합니다.
boolean	tryLock (long timeout, TimeUnit unit) 지정된 대기 시간내에 다른 thread가 락을 보관 유지하지 않고, 현재의 thread로인터럽트가 발생하고 있지 않는 경우에 출력 락을 취득합니다.
void	unlock () 이 락의 해방을 시도합니다.

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

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

생성자 상세

ReentrantReadWriteLock.WriteLock

protected ReentrantReadWriteLock.WriteLock(ReentrantReadWriteLock  lock)

서브 클래스에 의해 사용되는 생성자 입니다.

파라미터:

lock - 외부의 락 객체

예외:

NullPointerException - 락이 null인 경우

메서드의 상세

lock

public void lock()

출력 락을 취득합니다.

read 락 또는 출력락의 모두 다른 thread에 보관 유지되어 있지 않은 경우, 출력 락을 취득해 즉시 복귀해, 출력 락의 보관 유지 카운트를 1 으로 설정합니다.

현재의 thread가 출력락을 이미 보관 유지하고 있는 경우, 보관 유지 카운트의 값을 1 증분 해, 메서드를 즉시 복귀합니다.

락이 다른 thread에 의해 보관 유지되고 있는 경우, 현재의 thread가 thread 스케줄링에 관해서 무효가 되어, 출력 락이 취득될 때까지 대기합니다. 락이 취득되면, 출력 락 보관 유지 카운트가 1 으로 설정됩니다.

정의:

인터페이스 Lock 내의 lock

lockInterruptibly

public void lockInterruptibly()
                       throws InterruptedException 

현재의 thread가 interrupted 가 아닌 한, 출력 락을 취득합니다.

read 락 또는 출력락의 모두 다른 thread에 보관 유지되어 있지 않은 경우, 출력 락을 취득해 즉시 복귀해, 출력 락의 보관 유지 카운트를 1 으로 설정합니다.

현재의 thread가 락을 이미 보관 유지하고 있는 경우, 보관 유지 카운트의 값을 1 증분 해, 메서드를 즉시 복귀합니다.

락이 다른 thread에 의해 보관 유지되고 있는 경우, 현재의 thread는 thread의 스케줄링에 관해서 무효가 되어, 다음의 2개 중 한쪽이 일어날 때까지 대기합니다.

• 현재의 thread에 의해 출력 락이 취득된다
• 다른 thread가 현재의 thread에인터럽트를 실시한다

출력 락이 현재의 thread에 의해 취득되었을 경우, 락 보관 유지 카운트가 1 으로 설정됩니다.

현재의 thread로

• 이 메서드에의 엔트리상에서 설정된 인터럽트 스테이터스가 보관 유지되는지,
• 출력 락의 취득중에인터럽트가 발생했을 경우,

InterruptedException이 Throw 되어 현재의 thread의 인터럽트 스테이터스가 클리어 됩니다.

이 메서드는 명시적인 끼어들어 포인트이기 때문에 이 구현에서는 보통 또는 재입 가능한 락 취득에의 인터럽트에의 응답에 높은 우선도가 주어집니다.

정의:

인터페이스 Lock 내의 lockInterruptibly

예외:

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

관련 항목:

Thread.interrupt()

tryLock

public boolean tryLock()

호출시에 다른 thread에 의해 보관 유지되어 있지 않은 경우에만, 출력 락을 취득합니다.

다른 thread에 의해 출력 락과 읽기 락의 모두 보관 유지되어 있지 않은 경우에 출력락을 취득해, 값 true로 즉시 복귀해 락의 보관 유지 카운트를 1 으로 설정합니다. 이 락이 균등 순서부 정책를 사용하도록 설정되어 있는 경우에서도, 락이 사용 가능하면, 다른 thread가 현재 출력 락을 대기하고 있을지 어떨지에 관계없이, tryLock() 호출로 곧바로 락이 취득됩니다. 이 「화물 운반선」동작에 의해 균등성이 없어진다고는 말할 수 있어 이것은 특정의 상황하로 유용합니다. 이 락의 균등 설정을 존중하는 경우는 거의 등가인 tryLock(0, TimeUnit.SECONDS)를 사용합니다 (이것도 인터럽트를 검출한다).

현재의 thread가 락을 이미 보관 유지하고 있는 경우, 보관 유지 카운트의 값이 1 증분 되어 메서드는 true를 리턴합니다.

락이 다른 thread에 의해 보관 유지되고 있는 경우, 이 메서드는 값 false로 즉시 복귀합니다.

정의:

인터페이스 Lock 내의 tryLock

반환값:

락이 프리로 현재의 thread에 의해 취득되었는지, 출력 락이 현재의 thread에 의해 취득이 끝난 상태인 경우는 true, 그렇지 않은 경우는 false

tryLock

public boolean tryLock(long timeout,
                       TimeUnit  unit)
                throws InterruptedException 

지정된 대기 시간내에 다른 thread가 락을 보관 유지하지 않고, 현재의 thread로인터럽트가 발생하고 있지 않는 경우에 출력 락을 취득합니다.

다른 thread가 출력락과 읽기 락의 모두 보관 유지하고 있지 않는 경우에 출력락을 취득해, 값 true로 즉시 복귀해, 락 보관 유지 카운트를 1 으로 설정합니다. 이 락이 균등 순서부 정책를 사용하도록 설정되어 있어도, 다른 thread가 출력락을 대기하고 있는 경우는 사용 가능한 락은 취득되지 않습니다. 이것은, tryLock() 메서드와는 대조적입니다. 균등 락에 대한 화물 운반선을 허가하지 않는 시간 설정된 tryLock를 사용하는 경우는 시간 설정과 비시간 설정의 양형식을 조합해 사용합니다.

if (lock.tryLock() || lock.tryLock(timeout, unit) ) { ... }
 

현재의 thread가 락을 이미 보관 유지하고 있는 경우, 보관 유지 카운트의 값이 1 증분 되어 메서드는 true를 리턴합니다.

락이 다른 thread에 의해 보관 유지되고 있는 경우, 현재의 thread는 thread의 스케줄링에 관해서 무효가 되어, 다음의 3 개중 한쪽이 일어날 때까지 대기합니다.

• 현재의 thread에 의해 출력 락이 취득된다
• 다른 thread가 현재의 thread에인터럽트를 실시한다
• 지정된 대기 시간이 경과한다

출력 락이 취득되었을 경우, 값 true가 돌려주고져 락 보관 유지 카운트가 1 으로 설정됩니다.

현재의 thread로

• 이 메서드에의 엔트리상에서 설정된 인터럽트 스테이터스가 보관 유지되는지,
• 출력 락의 취득중에인터럽트가 발생했을 경우,

InterruptedException이 Throw 되어 현재의 thread의 인터럽트 스테이터스가 클리어 됩니다.

지정된 대기 시간이 경과하면, 값 false가 리턴됩니다 . 시간이 제로 또는 그것보다 작은 경우, 메서드는 대기하지 않습니다.

이 메서드는 명시적인 끼어들어 포인트이기 때문에 이 구현에서는 보통 또는 재입 가능한 락 취득 및 대기 시간 경과 리포트에의 인터럽트에 대한 응답에 높은 우선도가 주어집니다.

정의:

인터페이스 Lock 내의 tryLock

파라미터:

timeout - 출력 락을 대기하는 시간

unit - timeout 인수의 시간 단위

반환값:

락이 프리로 현재의 thread에 의해 소득되었는지, 출력 락이 현재의 thread에 의해 취득이 끝난 상태인 경우는 true, 락을 취득하기 전에 대기 시간이 경과했을 경우는 false

예외:

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

NullPointerException - 단위가 null인 경우

관련 항목:

Thread.interrupt()

unlock

public void unlock()

이 락의 해방을 시도합니다.

현재의 thread가 이 락의 홀더인 경우, 보관 유지 카운트의 값이 줄여집니다. 보관 유지 카운트가 제로가 되면, 락이 해방됩니다. 현재의 thread가 이 락의 홀더가 아닌 경우, IllegalMonitorStateException을 발생시킵니다.

정의:

인터페이스 Lock 내의 unlock

예외:

IllegalMonitorStateException - 현재의 thread가 이 락을 보관 유지하지 않는 경우

newCondition

public Condition  newCondition()

이 Lock 인스턴스로 사용하는 Condition 인스턴스를 리턴합니다.

리턴된 Condition 인스턴스는 Object 감시 메서드 (wait, notify 및 notifyAll )를 빌트인 감시 락으로 사용하는 경우와 같은 사용 방법을 지원 합니다.

• Condition 메서드의 호출시에 이 출력 락을 보관 유지하고 있지 않는 경우, IllegalMonitorStateException이 Throw 된다 (read 락은 출력락과는 독립해 보관 유지되기 때문에 체크되거나 영향을 받을 것은 없다. 다만, 현재의 thread가 읽기 락도 취득하고 있는 경우에 상태 대기 메서드를 호출하는 것은 그것을 블록 해제 가능한 다른 thread로 출력락을 취득할 수 없게 되어 버리기 때문에 항상 근본적인 잘못이다).
• 상태대기 메서드가 불려가 면, 출력 락이 해방된다. 그 후, 출력 락이 재취득되어 락 보관 유지 카운트가 메서드의 호출시 상태에 복원되고 나서, 메서드가 복귀한다.
• 대기중에 thread로인터럽트가 발생하면, 대기는 종료해, InterruptedException이 Throw 되어 thread의 인터럽트 상태가 클리어 된다.
• 대기중의 thread는 FIFO 순서로 신호가 송신된다.
• 대기중의 메서드로부터 복귀하는 thread가 락을 재얻는 순서는 thread가 락을 최초로 취득했을 때의 순서와 같게 된다. 이것은 디폴트에서는 지정되어 있지 않지만, 「균등」락에서는 가장 길게 대기하고 있던 thread가 우선된다.

정의:

인터페이스 Lock 내의 newCondition

반환값:

Condition 객체

toString

public String  toString()

이 락을 식별하는 캐릭터 라인 및 락 상태를 리턴합니다. 상태는 괄호로 둘러싸여 캐릭터 라인 「Unlocked」또는 캐릭터 라인 「Locked by」에 이어, 소유하는 thread의 Thread.getName() 가 포함됩니다.

오버라이드(override):

클래스 Object 내의 toString

반환값:

이 락 및 그 상태를 식별하는 캐릭터 라인