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() 現在のスレッドの、この書き込みロックに対する保持数を照会します。
boolean	isHeldByCurrentThread() 現在のスレッドがこの書き込みロックを保持しているかどうかを照会します。
void	lock() 書き込みロックを取得します。
void	lockInterruptibly() 現在のスレッドに割り込みが発生しないかぎり、書き込みロックを取得します。
Condition	newCondition() この Lock インスタンスで使用する Condition インスタンスを返します。
String	toString() このロックおよびその状態を識別する文字列を返します。
boolean	tryLock() 呼び出し時に別のスレッドにより保持されていない場合のみに、書き込みロックを取得します。
boolean	tryLock(long timeout, TimeUnit unit) 指定された待機時間内に別のスレッドがロックを保持せず、現在のスレッドで割り込みが発生していない場合に、書き込みロックを取得します。
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()

書き込みロックを取得します。

読み込みロックまたは書き込みロックのいずれも別のスレッドに保持されていない場合、書き込みロックを取得してただちに復帰し、書き込みロックの保持カウントを 1 に設定します。

現在のスレッドが書き込みロックをすでに保持している場合、保持カウントの値を 1 増分して、メソッドをただちに復帰します。

ロックが別のスレッドにより保持されている場合、現在のスレッドがスレッドスケジューリングに関して無効になり、書き込みロックが取得されるまで待機します。ロックが取得されると、書き込みロック保持カウントが 1 に設定されます。

定義:

lock、インタフェース: Lock

lockInterruptibly

public void lockInterruptibly()
                       throws InterruptedException

現在のスレッドに割り込みが発生しないかぎり、書き込みロックを取得します。

読み込みロックまたは書き込みロックのいずれも別のスレッドに保持されていない場合、書き込みロックを取得してただちに復帰し、書き込みロックの保持カウントを 1 に設定します。

現在のスレッドがロックをすでに保持している場合、保持カウントの値を 1 増分して、メソッドをただちに復帰します。

ロックが別のスレッドにより保持されている場合、現在のスレッドはスレッドのスケジューリングに関して無効になり、次の 2 つのいずれかが起きるまで待機します。

• 現在のスレッドにより書き込みロックが取得される。
• ほかのスレッドが現在のスレッドに割り込みを行う。

書き込みロックが現在のスレッドにより取得された場合、ロック保持カウントが 1 に設定されます。

現在のスレッドで、

• このメソッドへのエントリ上で設定された割り込みステータスが保持されるか、
• 書き込みロックの取得中に割り込みが発生した場合、

InterruptedException がスローされ、現在のスレッドの割り込みステータスがクリアされます。

このメソッドは明示的な割り込みポイントであるため、この実装では、通常または再入可能なロック取得への割り込みへの応答に高い優先度が与えられます。

定義:

lockInterruptibly、インタフェース: Lock

例外:

InterruptedException - 現在のスレッドで割り込みが発生した場合

tryLock

public boolean tryLock()

呼び出し時に別のスレッドにより保持されていない場合のみに、書き込みロックを取得します。

別のスレッドが書き込みロックと読み込みロックのいずれも保持していない場合に書き込みロックを取得し、値 true でただちに復帰して、ロック保持カウントを 1 に設定します。このロックが公平順序付けポリシーを使用するように設定されている場合でも、ロックが使用可能であれば、ほかのスレッドが現在書き込みロックを待機しているかどうかには関係なく、tryLock() の呼び出しによってそのロックがただちに取得されます。この「バージ」(barging) 動作により公平性が失われるとは言え、これは特定の状況下で有用です。このロックの公平性設定を尊重する場合は、ほぼ等価な tryLock(0, TimeUnit.SECONDS) を使用します (これも割り込みを検出する)。

現在のスレッドがロックをすでに保持している場合、保持カウントの値を 1 増分して、メソッドは true を返します。

ロックが別のスレッドにより保持されている場合、このメソッドは、値 false でただちに復帰します。

定義:

tryLock、インタフェース: Lock

戻り値:

ロックされていない状態で、現在のスレッドによりロックが取得されたか、または書き込みロックがすでに現在のスレッドによって保持されていた場合は true。それ以外の場合は false。

tryLock

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

指定された待機時間内に別のスレッドがロックを保持せず、現在のスレッドで割り込みが発生していない場合に、書き込みロックを取得します。

別のスレッドが書き込みロックと読み込みロックのいずれも保持していない場合に書き込みロックを取得し、値 true でただちに復帰して、ロック保持カウントを 1 に設定します。このロックが公平順序付けポリシーを使用するように設定されていても、ほかのスレッドが書き込みロックを待機している場合は、使用可能なロックは取得されません。これは、tryLock() メソッドとは対照的です。公平ロックに対するバージを許可しない、時間設定された tryLock を使用する場合は、時間設定と非時間設定の両形式を組み合わせて使用します。

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

現在のスレッドがロックをすでに保持している場合、保持カウントの値を 1 増分して、メソッドは true を返します。

ロックが別のスレッドにより保持されている場合、現在のスレッドはスレッドのスケジューリングに関して無効になり、次の 3 つのいずれかが起きるまで待機します。

• 現在のスレッドにより書き込みロックが取得される。
• ほかのスレッドが現在のスレッドに割り込みを行う。または
• 指定された待機時間が経過する。

書き込みロックが取得された場合は値 true が返され、書き込みロック保持カウントが 1 に設定されます。

現在のスレッドで、

• このメソッドへのエントリ上で設定された割り込みステータスが保持されるか、
• 書き込みロックの取得中に割り込みが発生した場合、

InterruptedException がスローされ、現在のスレッドの割り込みステータスがクリアされます。

指定された待機時間が経過すると、値 false が返されます。時間がゼロまたはそれより小さい場合、メソッドは待機しません。

このメソッドは明示的な割り込みポイントであるため、この実装では、通常または再入可能なロック取得、および待機時間経過レポートへの割り込みに対する応答に高い優先度が与えられます。

定義:

tryLock、インタフェース: Lock

パラメータ:

timeout - 書き込みロックを待機する時間

unit - timeout 引数の時間単位

戻り値:

ロックされていない状態で、現在のスレッドによりロックが取得されたか、または書き込みロックがすでに現在のスレッドによって保持されていた場合は true。ロックを取得する前に待機時間が経過した場合は false。

例外:

InterruptedException - 現在のスレッドで割り込みが発生した場合

NullPointerException - 時間単位が null の場合

unlock

public void unlock()

このロックの解放を試みます。

現在のスレッドがこのロックのホルダーである場合、保持カウントの値が減らされます。保持カウントがゼロになると、ロックが解放されます。現在のスレッドがこのロックのホルダーではない場合、IllegalMonitorStateException がスローされます。

定義:

unlock、インタフェース: Lock

例外:

IllegalMonitorStateException - 現在のスレッドがこのロックを保持していない場合。

newCondition

public Condition newCondition()

この Lock インスタンスで使用する Condition インスタンスを返します。

返される Condition インスタンスは、Object 監視メソッド (wait、notify、および notifyAll) を組み込み監視ロックで使用する場合と同じ使用方法をサポートします。

• Condition メソッドのいずれかが呼び出されたときにこの書き込みロックが保持されていない場合は、IllegalMonitorStateException がスローされます。(読み込みロックは書き込みロックとは独立して保持されるため、チェックされたり影響を受けることはありません。ただし、現在のスレッドが読み込みロックも取得している場合に状態待機メソッドを呼び出すことは、それをブロック解除可能なほかのスレッドで書き込みロックが取得できなくなってしまうため、常に根本的な誤りです)。
• 状態待機メソッドが呼び出されると、書き込みロックが解放されます。その後、書き込みロックが再取得され、ロック保持カウントがメソッドの呼び出し時の状態に復元されてから、メソッドが復帰します。
• 待機中にスレッドで割り込みが発生すると、待機は終了し、InterruptedException がスローされ、スレッドの割り込みステータスがクリアされます。
• 待機中のスレッドは、FIFO の順序で信号が送信される。
• 待機中のメソッドから復帰するスレッドがロックを再取得する順序は、スレッドがロックを最初に取得したときの順序と同じになります。これは、デフォルトでは指定されていないが、公平ロックではもっとも長く待機していたスレッドが優先されます。

定義:

newCondition、インタフェース: Lock

戻り値:

Condition オブジェクト

toString

public String toString()

このロックおよびその状態を識別する文字列を返します。状態は括弧で囲まれ、文字列 "Unlocked" または文字列 "Locked by" に続いて、所有しているスレッドの名前が含まれます。

オーバーライド:

toString、クラス: Object

戻り値:

このロックおよびその状態を識別する文字列

isHeldByCurrentThread

public boolean isHeldByCurrentThread()

現在のスレッドがこの書き込みロックを保持しているかどうかを照会します。実質的に ReentrantReadWriteLock.isWriteLockedByCurrentThread() と同じです。

戻り値:

現在のスレッドがこのロックを保持している場合は true。それ以外の場合は false

導入されたバージョン:

1.6

getHoldCount

public int getHoldCount()

現在のスレッドの、この書き込みロックに対する保持数を照会します。スレッドには、ロック解除アクションと一致しないロックアクションごとに、ロック保持が存在します。実質的に ReentrantReadWriteLock.getWriteHoldCount() と同じです。

戻り値:

現在のスレッドの、このロックに対する保持数。現在のスレッドがこのロックを保持していない場合はゼロ

導入されたバージョン:

1.6