java.util.concurrent.locks.ReentrantReadWriteLock
|
JavaTM 2 Platform Standard Ed. 5.0 |
|||||||||
| 이전 클래스 다음 클래스 | 프레임으로 프레임 없이 | |||||||||
| 개요: 상자 | 필드 | constructor | 메서드 | 상세: 필드 | 생성자 | 메서드 | |||||||||
java.lang.Object
public class ReentrantReadWriteLock
ReentrantLock 와
유사한 시멘틱스를 지원하는 ReadWriteLock
구현.
이 클래스에는 다음의 프로퍼티가 있습니다.
이 클래스는 락 액세스에 대한 리더 또는 라이터의 우선 순서를 규정하지 않습니다. 다만, 이것은 옵션의 「균등」정책를 지원 합니다. 균등으로서 구축되었을 경우, thread는 근사의 도착순서 정책를 사용해 엔트리로 경합 합니다. 출력 락이 해방되면, 대기 시간의 가장 긴 단일의 Writer에 출력락을 할당할 수 있는지, 어느 라이터보다 길게 대기하고 있는 리더가 존재하는 경우는 리더세트에 읽기 락을 할당할 수 있습니다. 불균등으로서 구축되었을 경우는 엔트리를 잠그는 순서를 도착순서로 할 필요는 없습니다. 어느 경우에도, 리더가 액티브해, 라이터가 락에 들어가는 경우, 그 라이터가 출력락을 취득해 해방할 때까지, 후속의 리더에게는 읽기 락은 허가되지 않습니다.
이 락은 리더와 라이터의 양쪽 모두가ReentrantLock
스타일로 읽기
또는 출력락을 재얻는 것을 허용합니다. 출력하는 thread의 보관 유지하는 출력 락이 모두 해방될 때까지, 리더는 허가되지 않습니다.
또, 라이터는 읽기 락을 취득할 수 있습니다만, 리더가 출력락을 취득할 수 없습니다. 다른 어플리케이션의 사이에서는 read 락하에서 read를 실행하는 메서드에의 호출해 또는 콜백중에 출력락이 보관 유지되는 경우, 재입가능성은 유용합니다. 리더가 출력락을 취득하려고 해도, 성공하지 않습니다.
재입가능성을 이용하면, 출력 락을 취득하고 나서 read 락을 취득해, 그 후 출력락을 해방한다고 하는 방법으로 출력 락으로부터 읽기 락에의 격하가 가능하게 됩니다. 다만, read 락으로부터 출력락에의 승격은 할 수 없습니다.
read 락과 출력락의 양쪽 모두가 락 취득중의 인터럽트를 지원 합니다.
Condition
지원
출력 락의 제공하는 Condition 구현은 출력 락에 관계되어, ReentrantLock.newCondition()
제공하는 Condition 구현이 ReentrantLock에 대해서 실행하는 것과 같이 동작합니다. 당연합니다만, 이 Condition 는 출력락에서만 사용할 수 있습니다.
read 락은 Condition를
지원
하지 않고, readLock(). newCondition()가 UnsupportedOperationException을 Throw 합니다.
이 클래스는 락이 보관 유지되는지 경합 하는지를 판별하는 메서드를 지원 합니다. 이러한 메서드는 동기의 제어용으로서가 아니고, 시스템 상태의 감시용으로서 설계되고 있습니다.
이 클래스의 직렬화는 빌트인 락과 같게 동작합니다. 직렬화 해제된 락은 직렬화시 상태에 관계없이, 락 해제 상태가 됩니다.
사용례： 차의 코드예에서는 재입가능성을 활용해, 캐쉬의 갱신 후에 락의 격하를 실행하는 방법을 나타냅니다 (간략화하기 위해서 예외 처리는 생략 되고 있다).
class CachedData {
Object data;
volatile boolean cacheValid;
ReentrantReadWriteLock rwl = new ReentrantReadWriteLock();
void processCachedData() {
rwl.readLock(). lock();
if (! cacheValid) {
// upgrade lock manually
rwl.readLock(). unlock(); // must unlock first to obtain writelock
rwl.writeLock(). lock();
if (! cacheValid) { // recheck
data = ...
cacheValid = true;
}
// downgrade lock
rwl.readLock(). lock(); // reacquire read without giving up write lock
rwl.writeLock(). unlock(); // unlock write, still hold read
}
use(data);
rwl.readLock(). unlock();
}
}
ReentrantReadWriteLocks를 사용해, 어떤 종류의 Collections
사용으로 병행성을 개선할 수 있습니다. 보통, 이것이 가값이 있는 것은 컬렉션이 대규모로 되는 것이 예상되어 라이터 thread보다 다수의 리더 thread에 의해 액세스 되어 동기에
한 오버헤드를 웃도는 오버헤드를 가지는 조작이 포함되는 경우입니다. 예로서 대규모여, 동시 액세스가 예상되는 TreeMap를 사용하는 클래스를 이하에 나타냅니다.
class RWDictionary {
private final Map<String, Data> m = new TreeMap<String, Data>();
private final ReentrantReadWriteLock rwl = new ReentrantReadWriteLock();
private final Lock r = rwl.readLock();
private final Lock w = rwl.writeLock();
public Data get(String key) {
r.lock(); try { return m.get(key); } finally { r.unlock(); }
}
public String[] allKeys() {
r.lock(); try { return m.keySet(). toArray(); } finally { r.unlock(); }
}
public Data put(String key, Data value) {
w.lock(); try { return m.put(key, value); } finally { w.unlock(); }
}
public void clear() {
w.lock(); try { m.clear(); } finally { w.unlock(); }
}
}
재입 가능한 출력 락은 소유자를 본래 정의해서, 락을 해방할 수 있는 것은 취득한 thread만입니다. 대조적으로 이 구현에서는 read 락에 소유권이라고 하는 개념은 존재하지 않기 때문에 read 락을 해방하는 thread가 그것을 얻는 thread와 같지 않으면 안 된다고 하는 것은 없습니다. 다만, 이 프로퍼티는 이 클래스의 장래의 구현으로 보관 유지되는 것은 보증되지 않습니다.
이 락은 최대 65536
재귀적 출력 락 및 65536
read 락을 지원
합니다. 이러한 제한을 넘으려고 하면, 잠그는 메서드로부터 Error 가 발생 됩니다.
| 중첩(Nested) 클래스 개요 | |
|---|---|
static class |
ReentrantReadWriteLock.ReadLock
readLock() 메서드에 의해 리턴된
락 |
static class |
ReentrantReadWriteLock.WriteLock
writeLock() 메서드에 의해 리턴된
락 |
| 생성자 개요 | |
|---|---|
ReentrantReadWriteLock ()
디폴트의 순서 프로퍼티로 새로운 ReentrantReadWriteLock를 작성합니다. |
|
ReentrantReadWriteLock (boolean fair)
지정된 균등성 정책를 사용해, 새로운 ReentrantReadWriteLock를 작성합니다. |
|
| 메서드 개요 | |
|---|---|
protected Thread |
getOwner ()
현재 출력 락을 소유하고 있는 thread를 리턴합니다. |
protected Collection <Thread > |
getQueuedReaderThreads ()
read 락의 취득을 대기중의 thread를 포함한 컬렉션을 리턴합니다. |
protected Collection <Thread > |
getQueuedThreads ()
read 락 또는 출력락의 몇개의 취득을 대기중의 thread를 포함한 컬렉션을 리턴합니다. |
protected Collection <Thread > |
getQueuedWriterThreads ()
출력 락의 취득을 대기중의 thread를 포함한 컬렉션을 리턴합니다. |
int |
getQueueLength ()
read 락 또는 출력락의 취득을 대기중의 thread의 추정수를 리턴합니다. |
int |
getReadLockCount ()
이 락용으로 보관 유지되고 있는 read 락의 수를 조회합니다. |
protected Collection <Thread > |
getWaitingThreads (Condition condition)
출력 락에 관련된 지정 상태를 대기중의 thread를 포함한 컬렉션을 리턴합니다. |
int |
getWaitQueueLength (Condition condition)
출력 락에 관련된 지정 상태로 대기중의 thread의 추정수를 리턴합니다. |
int |
getWriteHoldCount ()
현재의 thread에 한, 이 락상의 재입 가능한 출력 보관 유지수를 조회합니다. |
boolean |
hasQueuedThread (Thread thread)
read 락 또는 출력락의 취득을 대기중의 지정의 thread가 존재할지 어떨지를 조회합니다. |
boolean |
hasQueuedThreads ()
read 락 또는 출력락의 취득을 대기중의 thread가 존재할지 어떨지를 조회합니다. |
boolean |
hasWaiters (Condition condition)
이 출력 락에 관련된 지정 상태로 대기하고 있는 thread가 존재할지 어떨지를 조회합니다. |
boolean |
isFair ()
이 락으로 균등성이 true 로 설정되어 있는 경우는 true를 리턴합니다. |
boolean |
isWriteLocked ()
출력 락이 thread에 보관 유지되고 있는지를 조회합니다. |
boolean |
isWriteLockedByCurrentThread ()
현재의 thread가 이 출력 락을 보관 유지하고 있는 제발을 조회합니다. |
ReentrantReadWriteLock.ReadLock |
readLock ()
읽기에 사용하는 락을 리턴합니다. |
String |
toString ()
이 락 및 그 상태를 식별하는 캐릭터 라인을 리턴합니다. |
ReentrantReadWriteLock.WriteLock |
writeLock ()
출력을 사용하는 락을 리턴합니다. |
| 클래스 java.lang. Object 로부터 상속된 메서드 |
|---|
clone,
equals,
finalize,
getClass,
hashCode,
notify,
notifyAll,
wait,
wait,
wait |
| 생성자 상세 |
|---|
public ReentrantReadWriteLock()
public ReentrantReadWriteLock(boolean fair)
fair - 이 락이 균등 순서부 정책를 사용하는 경우는 true| 메서드의 상세 |
|---|
public ReentrantReadWriteLock.WriteLock writeLock()
ReadWriteLock
기술:
ReadWriteLock 내의 writeLock public ReentrantReadWriteLock.ReadLock readLock()
ReadWriteLock
기술:
ReadWriteLock 내의 readLock public final boolean isFair()
protected Thread getOwner()
public int getReadLockCount()
public boolean isWriteLocked()
public boolean isWriteLockedByCurrentThread()
public int getWriteHoldCount()
protected Collection <Thread > getQueuedWriterThreads()
protected Collection <Thread > getQueuedReaderThreads()
public final boolean hasQueuedThreads()
public final boolean hasQueuedThread(Thread thread)
thread - thread
NullPointerException - thread가 null인 경우public final int getQueueLength()
protected Collection <Thread > getQueuedThreads()
public boolean hasWaiters(Condition condition)
condition - 상태
IllegalMonitorStateException - 이 락을 보관 유지하고 있지 않는 경우
IllegalArgumentException - 지정된 상태가 이 락과 관련지을 수 있지 않은 경우
NullPointerException - 상태가 null인 경우public int getWaitQueueLength(Condition condition)
condition - 상태
IllegalMonitorStateException - 이 락을 보관 유지하고 있지 않는 경우
IllegalArgumentException - 지정된 상태가 이 락과 관련지을 수 있지 않은 경우
NullPointerException - 상태가 null인 경우protected Collection <Thread > getWaitingThreads(Condition condition)
condition - 상태
IllegalMonitorStateException - 이 락을 보관 유지하고 있지 않는 경우
IllegalArgumentException - 지정된 상태가 이 락과 관련지을 수 있지 않은 경우
NullPointerException - 상태가 null인 경우public String toString()
Object 내의 toString
|
JavaTM 2 Platform Standard Ed. 5.0 |
|||||||||
| 이전 클래스 다음 클래스 | 프레임으로 프레임 없이 | |||||||||
| 개요: 상자 | 필드 | constructor | 메서드 | 상세: 필드 | 생성자 | 메서드 | |||||||||
Copyright 2004 Sun Microsystems, Inc. All rights reserved. Use is subject to license terms . Documentation Redistribution Policy 도 참조하십시오.