IWatchService Schnittstelle

Definition

[Android.Runtime.Register("java/nio/file/WatchService", "", "Java.Nio.FileNio.IWatchServiceInvoker", ApiSince=26)]
public interface IWatchService : IDisposable, Java.Interop.IJavaPeerable, Java.IO.ICloseable

[<Android.Runtime.Register("java/nio/file/WatchService", "", "Java.Nio.FileNio.IWatchServiceInvoker", ApiSince=26)>]
type IWatchService = interface
    interface ICloseable
    interface IJavaObject
    interface IDisposable
    interface IJavaPeerable

Attribute

RegisterAttribute

Implementiert

IJavaObject IJavaPeerable ICloseable IDisposable

Hinweise

Ein Überwachungsdienst, der <>registrierte Objekte für Änderungen und Ereignisse überwacht</em> ansieht. Beispielsweise kann ein Datei-Manager einen Überwachungsdienst verwenden, um ein Verzeichnis auf Änderungen zu überwachen, sodass er die Anzeige der Liste der Dateien aktualisieren kann, wenn Dateien erstellt oder gelöscht werden.

Ein Watchable Objekt wird bei einem Überwachungsdienst registriert, indem er seine Watchable#register register Methode aufruft und eine WatchKey zur Darstellung der Registrierung zurückgibt. Wenn ein Ereignis für ein Objekt erkannt wird, wird <der Schlüssel signalisiert></em> erkannt, und wenn es derzeit nicht signalisiert ist, wird es an den Überwachungsdienst in die Warteschlange gestellt, sodass es von Verbrauchern abgerufen werden kann, die die #poll() poll Schlüssel aufrufen oder #take() take Methoden zum Abrufen von Schlüsseln und Prozessereignissen aufrufen. Sobald die Ereignisse verarbeitet wurden, ruft der Consumer die Methode des Schlüssels WatchKey#reset reset auf, um den Schlüssel zurückzusetzen, wodurch der Schlüssel signalisiert und mit weiteren Ereignissen erneut in die Warteschlange gestellt werden kann.

Die Registrierung bei einem Überwachungsdienst wird durch Aufrufen der Methode des Schlüssels WatchKey#cancel cancel abgebrochen. Ein Schlüssel, der zum Zeitpunkt der Kündigung in die Warteschlange eingereiht wird, verbleibt in der Warteschlange, bis er abgerufen wird. Je nach Objekt wird möglicherweise automatisch ein Schlüssel abgebrochen. Angenommen, ein Verzeichnis wird überwacht, und der Überwachungsdienst erkennt, dass es gelöscht wurde, oder auf das Dateisystem kann nicht mehr zugegriffen werden. Wenn ein Schlüssel auf diese Weise abgebrochen wird, wird er signalisiert und in die Warteschlange eingereiht, wenn er zurzeit nicht signalisiert ist. Um sicherzustellen, dass der Verbraucher über den Rückgabewert der reset Methode benachrichtigt wird, gibt an, ob der Schlüssel gültig ist.

Ein Überwachungsdienst ist für die Verwendung durch mehrere gleichzeitige Verbraucher sicher. Um sicherzustellen, dass immer nur ein Verbraucher die Ereignisse für ein bestimmtes Objekt verarbeitet, muss sichergestellt werden, dass die Methode des Schlüssels reset erst aufgerufen wird, nachdem seine Ereignisse verarbeitet wurden. Die #close close Methode kann jederzeit aufgerufen werden, um den Dienst zu schließen, was dazu führt, dass Threads, die auf das Abrufen von Schlüsseln warten, ausgelöst ClosedWatchServiceExceptionwerden.

Dateisysteme können Ereignisse schneller melden, als sie abgerufen oder verarbeitet werden können, und eine Implementierung kann eine nicht angegebene Grenze für die Anzahl der Ereignisse auferlegen, die sie ansammeln kann. Wenn eine Implementierung <wissentlich></em> Ereignisse verwirft, ordnet sie die Methode des Schlüssels WatchKey#pollEvents pollEvents an, um ein Element mit einem Ereignistyp StandardWatchEventKinds#OVERFLOW OVERFLOWzurückzugeben. Dieses Ereignis kann vom Consumer als Trigger verwendet werden, um den Status des Objekts erneut zu untersuchen.

Wenn ein Ereignis gemeldet wird, um anzugeben, dass eine Datei in einem überwachten Verzeichnis geändert wurde, besteht keine Garantie dafür, dass das Programm (oder die Programme), die die Datei geändert haben, abgeschlossen ist. Achten Sie darauf, den Zugriff mit anderen Programmen zu koordinieren, die die Datei möglicherweise aktualisieren. Die java.nio.channels.FileChannel FileChannel Klasse definiert Methoden zum Sperren von Bereichen einer Datei gegen den Zugriff durch andere Programme.

<h2>Plattformabhängigkeiten</h2>

Die Implementierung, die Ereignisse aus dem Dateisystem beobachtet, soll direkt der systemeigenen Ereignisbenachrichtigungseinrichtung zugeordnet werden, sofern verfügbar, oder einen primitiven Mechanismus verwenden, z. B. Das Abrufen, wenn eine systemeigene Einrichtung nicht verfügbar ist. Daher sind viele der Details dazu, wie Ereignisse erkannt werden, ihre Zeitachsen und ob ihre Reihenfolge erhalten bleibt, sehr implementierungsspezifisch. Wenn beispielsweise eine Datei in einem überwachten Verzeichnis geändert wird, kann dies zu einem einzelnen StandardWatchEventKinds#ENTRY_MODIFY ENTRY_MODIFY Ereignis in einigen Implementierungen, aber mehreren Ereignissen in anderen Implementierungen führen. Kurzlebige Dateien (d. h. Dateien, die nach der Erstellung sehr schnell gelöscht werden) werden möglicherweise nicht von primitiven Implementierungen erkannt, die das Dateisystem regelmäßig abfragen, um Änderungen zu erkennen.

Wenn sich eine überwachte Datei nicht auf einem lokalen Speichergerät befindet, ist sie implementierungsspezifisch, wenn Änderungen an der Datei erkannt werden können. Insbesondere ist es nicht erforderlich, dass Änderungen an Dateien, die auf Remotesystemen durchgeführt werden, erkannt werden.

In 1.7 hinzugefügt.

Java Dokumentation für java.nio.file.WatchService.

Teile dieser Seite sind Änderungen auf der Grundlage von Arbeiten, die von der Android Open Source Project erstellt und gemeinsam verwendet und gemäß den in der 2.5 Attribution License beschriebenen Begriffen verwendet werden.