IWatchKey Schnittstelle

Definition

[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

Attribute

RegisterAttribute

Implementiert

IJavaObject IJavaPeerable IDisposable

Hinweise

Ein Token, das die Registrierung eines Watchable watchable Objekts mit einem WatchServicedarstellt.

Ein Überwachungsschlüssel wird erstellt, wenn ein überwachungsfähiges Objekt bei einem Überwachungsdienst registriert wird. Der Schlüssel bleibt bis: ol>li Es wird explizit abgebrochen, indem er seine #cancel cancel Methode aufruft oder</li li><> implizit abgebrochen wird, da das Objekt nicht mehr zugänglich ist oder </li li>>< vom WatchService#close closing Watch-Dienst.><<#isValid valid </li></ol>

Ein Überwachungsschlüssel weist einen Zustand auf. Beim ersten Erstellen des Schlüssels wird als em>ready</em> bezeichnet<. Wenn ein Ereignis erkannt wird, wird <der Schlüssel signalisiert<>/em> und in die Warteschlange eingereiht, sodass es abgerufen werden kann, indem er die Methoden oder WatchService#take() take Methoden des Überwachungsdiensts WatchService#poll() poll aufruft. Nach dem Signal verbleibt ein Schlüssel in diesem Zustand, bis seine #reset reset Methode aufgerufen wird, um den Schlüssel in den Zustand "Bereit" zurückzugeben. Ereignisse, die erkannt wurden, während sich der Schlüssel im signalgesteuerten Zustand befindet, werden in die Warteschlange eingereiht, aber nicht dazu führen, dass der Schlüssel für den Abruf vom Überwachungsdienst erneut in die Warteschlange gestellt wird. Ereignisse werden abgerufen, indem die Methode des Schlüssels #pollEvents pollEvents aufgerufen wird. Mit dieser Methode werden alle ereignisse abgerufen und entfernt, die für das Objekt gesammelt wurden. Bei der ersten Erstellung weist ein Überwachungsschlüssel keine ausstehenden Ereignisse auf. In der Regel werden Ereignisse abgerufen, wenn sich der Schlüssel im signalisierten Zustand befindet, der zu folgendem Idiom führt:

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
                    }
                }

Überwachungstasten sind sicher für die Verwendung durch mehrere gleichzeitige Threads. Wenn es mehrere Threads gibt, die signalisierte Schlüssel von einem Überwachungsdienst abrufen, sollten Sie sicherstellen, dass die reset Methode nur aufgerufen wird, nachdem die Ereignisse für das Objekt verarbeitet wurden. Dadurch wird sichergestellt, dass ein Thread die Ereignisse für ein Objekt jederzeit verarbeitet.

In 1.7 hinzugefügt.

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

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.