public interface WatchService extends Closeable
register
メソッドを呼び出してWatchable
オブジェクトを監視サービスに登録すると、その登録を表すWatchKey
が返されます。 オブジェクトのイベントが検出されると、そのキーはsignalledになり、現在signalledになっていない場合は、poll
またはtake
メソッドを呼び出してキーの取得やイベントの処理を行うコンシューマが取得できるように、監視サービスのキューに入れられます。 イベントの処理が完了すると、コンシューマはそのキーのreset
メソッドを呼び出してキーをリセットします。これにより、さらにイベントがあれば、そのキーはsignalledになり、再度キューに入れられるようになります。
監視サービスへの登録は、キーのcancel
メソッドを呼び出すことにより取り消されます。 取り消される時点でキューに入っているキーは、それが取得されるまでキューの中に残ります。 オブジェクトによっては、キーが自動的に取り消されることもあります。 たとえば、ディレクトリが監視されていて、監視サービスによって、それが削除されてしまったか、そのファイル・システムにアクセスできなくなったことが検出されたとします。 こうしてキーが取り消されると、それが現在signalledになっていなければ、signalledになってキューに入れられます。 コンシューマが通知を受けられるように、reset
メソッドからの戻り値によって、そのキーが有効かどうかが示されます。
監視サービスは、複数の並行コンシューマで安全に使用できます。 常に特定のオブジェクトのイベントを処理するコンシューマが1つのみになるように、そのキーのreset
メソッドがそのイベントの処理の完了後にのみ呼び出されるように注意してください。 close
メソッドは、サービスを閉じるためにいつでも呼び出すことができ、それによってキーの取得を待機しているスレッドからClosedWatchServiceException
がスローされます。
ファイル・システムはイベントをその取得または処理能力を超える速さで報告する可能性があるため、実装では蓄積できるイベントの数に不特定の制限を課す場合があります。 実装では、イベントを故意に破棄する場合、キーのpollEvents
メソッドがOVERFLOW
というイベント・タイプで要素を返すように調整します。 このイベントは、コンシューマがオブジェクトの状態を見直すためにトリガーとして使用できます。
監視対象のディレクトリ内のファイルが変更されたことを知らせるイベントが報告された場合、そのファイルを変更したプログラムが完了しているという保証はありません。 そのファイルを更新している可能性のある他のプログラムとのアクセスの調整に注意が必要です。 FileChannel
クラスには、ファイルの領域を他のプログラムからアクセスできないようにするメソッドが定義されています。
ファイル・システムからイベントを監視する実装は、ネイティブ・ファイル・イベント通知機能(使用可能な場合)に直接マップしたり、ネイティブ機能が使用できない場合はポーリングなどの基本メカニズムを使用したりするよう意図されています。 その結果、イベントの検出方法、その適用のタイミング、およびその順序が維持されるかどうかに関する詳細の多くは、実装によって大きく異なります。 たとえば、監視対象のディレクトリ内のファイルが変更されると、一部の実装では単一のENTRY_MODIFY
イベントが発生することがありますが、他の実装では複数のイベントが発生することがあります。 有効期間の短いファイル(作成後すぐに削除されるファイルのこと)は、定期的にファイル・システムをポーリングして変更を検出するプリミティブな実装では検出されないことがあります。
監視されたファイルがローカル・ストレージ・デバイス上にない場合、そのファイルへの変更を検出できるかどうかは、実装に固有です。 特に、リモート・システム上で行われたファイルへの変更は検出される必要はありません。
FileSystem.newWatchService()
void close() throws IOException
キーがキューに入れられるのを待機しているtake
またはpoll
メソッドでスレッドが現在ブロックされている場合、それはすぐにClosedWatchServiceException
を受け取ります。 この監視サービスに関連付けられている有効なキーはinvalidated
です。
監視サービスが閉じたあとで、それに対してさらに操作を呼び出そうとすると、ClosedWatchServiceException
がスローされます。 この監視サービスがすでに閉じている場合は、このメソッドを呼び出しても何の効果もありません。
close
、インタフェースAutoCloseable
close
、インタフェースCloseable
IOException
- 入出力エラーが発生した場合WatchKey poll()
null
を返します。null
ClosedWatchServiceException
- この監視サービスが閉じている場合WatchKey poll(long timeout, TimeUnit unit) throws InterruptedException
timeout
- 処理を中止するまでの待機時間。単位はunitunit
- timeoutパラメータの解釈方法を決定するTimeUnit
null
ClosedWatchServiceException
- この監視サービスが閉じられた場合、または次のキーの待機中に閉じられた場合InterruptedException
- 待機中に割込みが発生した場合WatchKey take() throws InterruptedException
ClosedWatchServiceException
- この監視サービスが閉じられた場合、または次のキーの待機中に閉じられた場合InterruptedException
- 待機中に割込みが発生した場合 バグまたは機能を送信
詳細なAPIリファレンスおよび開発者ドキュメントについては、Java SEのドキュメントを参照してください。 そのドキュメントには、概念的な概要、用語の定義、回避方法、有効なコード例などの、開発者を対象にしたより詳細な説明が含まれています。
Copyright © 1993, 2025, Oracle and/or its affiliates. All rights reserved. Use is subject to license terms. Documentation Redistribution Policyも参照してください。