IWatchKey インターフェイス

定義

[Android.Runtime.Register("java/nio/file/WatchKey", "", "Java.Nio.FileNio.IWatchKeyInvoker", ApiSince=26)]
public interface IWatchKey : Android.Runtime.IJavaObject, IDisposable, Java.Interop.IJavaPeerable

[<Android.Runtime.Register("java/nio/file/WatchKey", "", "Java.Nio.FileNio.IWatchKeyInvoker", ApiSince=26)>]
type IWatchKey = interface
    interface IJavaObject
    interface IDisposable
    interface IJavaPeerable

属性

RegisterAttribute

実装

IJavaObject IJavaPeerable IDisposable

注釈

Watchable watchableを持つWatchService オブジェクトの登録を表すトークン。

ウォッチ 可能なオブジェクトがウォッチ サービスに登録されると、ウォッチ キーが作成されます。 キーは、#isValid validol<>li<> メソッドを呼び出すことによって明示的に取り消されるか、オブジェクトにアクセスできなくなったために暗黙的に取り消されるか#cancel cancel/li<>li< Cancelled になるまで、または>/li<>li< ウォッチ サービスを>するまでWatchService#close closing。 </li></ol>

ウォッチ キーには状態があります。 最初に作成されたとき、キーは <em>ready</em> と言われます。 イベントが検出されると、キーは <em>signalled</em> キューに入れ、ウォッチ サービスの WatchService#poll() poll または WatchService#take() take メソッドを呼び出して取得できるようにします。 シグナル通知が行われると、 #reset reset メソッドが呼び出されてキーが準備完了状態に戻るまで、キーはこの状態のままになります。 キーがシグナル状態の間に検出されたイベントはキューに入れられますが、ウォッチ サービスから取得するためにキーが再キューに入れられます。 イベントは、キーの #pollEvents pollEvents メソッドを呼び出すことによって取得されます。 このメソッドは、オブジェクトに対して蓄積されたすべてのイベントを取得および削除します。 最初に作成されたとき、ウォッチ キーには保留中のイベントはありません。 通常、イベントは、キーがシグナル状態の場合に取得され、次のイディオムが発生します。

for (;;) {
                    // retrieve key
                    WatchKey key = watcher.take();

                    // process events
                    for (WatchEvent<?> event: key.pollEvents()) {
                        :
                    }

                    // reset the key
                    boolean valid = key.reset();
                    if (!valid) {
                        // object no longer registered
                    }
                }

ウォッチ キーは、複数の同時実行スレッドで安全に使用できます。 監視サービスからシグナル化されたキーを取得するスレッドが複数ある場合は、オブジェクトのイベントが処理された後にのみ reset メソッドが呼び出されるように注意する必要があります。 これにより、1 つのスレッドがオブジェクトのイベントをいつでも処理できるようになります。

1.7 で追加されました。

Javaドキュメント。

このページの一部は、によって作成および共有され、に記載されている条件に従って使用される作業に基づく変更です。