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) 서브 클래스에 의해 사용되는 생성자 입니다.

메소드의 개요

int	getHoldCount () 현재의 thread의, 이 기입 락에 대한 보관 유지수를 조회합니다.
boolean	isHeldByCurrentThread () 현재의 thread가 이 기입 락을 보관 유지하고 있을지 어떨지를 조회합니다.
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 - lock 가 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로 인터럽트가 발생했을 경우

tryLock

public boolean tryLock()

호출시에 다른 thread에 의해 보관 유지되어 있지 않은 경우에만, 기입 락을 가져옵니다.

다른 thread가 기입해 락과 읽어들여 락의 모두 보관 유지하고 있지 않는 경우에 기입해 락을 취득해, 값 true 로 즉시 복귀해, 락 보관 유지 카운트를 1 으로 설정합니다. 이 락이 공평 순서부 정책를 사용하도록(듯이) 설정되어 있는 경우에서도, 락이 사용 가능하면, 다른 thread가 현재 기입 락을 대기하고 있을지 어떨지에 관계없이,tryLock() 의 호출로 곧바로 락이 취득됩니다. 이 「인터럽트」(barging) 동작에 의해 공평성이 없어진다고는 말할 수 있어 이것은 특정의 상황하로 유용합니다. 이 락의 공평성 설정을 존중하는 경우는, 거의 등가인 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 의 경우

unlock

public void unlock()

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

현재의 thread가 이 락의 홀더인 경우, 보관 유지 카운트의 값이 줄여집니다. 보관 유지 카운트가 제로가 되면(자), 락이 해제됩니다. 현재의 thread가 이 락의 홀더가 아닌 경우,IllegalMonitorStateException 가 throw 됩니다.

정의:

인터페이스 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의이름이 포함됩니다.

오버라이드(override):

클래스 Object 내의 toString

반환값:

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

isHeldByCurrentThread

public boolean isHeldByCurrentThread()

현재의 thread가 이 기입 락을 보관 유지하고 있을지 어떨지를 조회합니다. 실질적으로 ReentrantReadWriteLock.isWriteLockedByCurrentThread() 와 같습니다.

반환값:

현재의 thread가 락을 보관 유지하는 경우는 true, 그렇지 않은 경우는 false

도입된 버젼:

1.6

getHoldCount

public int getHoldCount()

현재의 thread의, 이 기입 락에 대한 보관 유지수를 조회합니다. thread에는, 락 해제 액션과 일치하지 않는 락 액션 마다, 락 보관 유지가 존재합니다. 실질적으로 ReentrantReadWriteLock.getWriteHoldCount() 와 같습니다.

반환값:

현재의 thread의, 이 락에 대한 보관 유지수. 현재의 thread가 이 락을 보관 유지하고 있지 않는 경우는 제로

도입된 버젼:

1.6