IWatchKey Interface

Définition

[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

Attributs

RegisterAttribute

Implémente

IJavaObject IJavaPeerable IDisposable

Remarques

Jeton représentant l’inscription d’un Watchable watchable objet avec un WatchService.

Une clé espion est créée lorsqu’un objet espion est inscrit auprès d’un service espion. La clé reste #isValid valid jusqu’à ce que : <ol><li> Il est annulé, explicitement, en appelant sa #cancel cancel méthode, ou</li><cancelled> implicitement, car l’objet n’est plus accessible, ou </li li><> Par WatchService#close closing le service espion. </li></ol>

Une clé espion a un état. Lors de la création initiale de la clé, la clé est considérée comme <em>ready</em>. Lorsqu’un événement est détecté, la clé est <>signalée</em> et mise en file d’attente afin qu’elle puisse être récupérée en appelant les méthodes ou WatchService#poll() poll les méthodes du WatchService#take() take service espion. Une fois signalée, une clé reste dans cet état jusqu’à ce que sa #reset reset méthode soit appelée pour renvoyer la clé à l’état prêt. Les événements détectés pendant que la clé est dans l’état signalé sont mis en file d’attente, mais ne provoquent pas la nouvelle mise en file d’attente de la clé pour la récupération à partir du service espion. Les événements sont récupérés en appelant la méthode de #pollEvents pollEvents la clé. Cette méthode récupère et supprime tous les événements accumulés pour l’objet. Lors de la création initiale, une clé espion n’a pas d’événements en attente. En règle générale, les événements sont récupérés lorsque la clé est dans l’état signalé menant à l’idiome suivant :

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

Les clés de surveillance sont sécurisées pour être utilisées par plusieurs threads simultanés. Lorsqu’il existe plusieurs threads récupérant des clés signalées à partir d’un service espion, vous devez veiller à ce que la reset méthode soit appelée uniquement après le traitement des événements de l’objet. Cela garantit qu’un thread traite les événements d’un objet à tout moment.

Ajouté dans la version 1.7.

Documentation Java pour java.nio.file.WatchKey.

Les parties de cette page sont des modifications basées sur le travail créé et partagé par le projet Android Open Source et utilisés en fonction des termes décrits dans la licence d’attribution Creative Commons 2.5.