Langue

IWatchService Interface

Définition

Service de surveillance qui surveille les objets inscrits pour les modifications et les événements.

[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
Attributs
Implémente

Remarques

Service de surveillance qui surveille les objets inscrits pour les modifications et les événements. Par exemple, un gestionnaire de fichiers peut utiliser un service espion pour surveiller un répertoire afin qu’il puisse mettre à jour son affichage de la liste des fichiers lorsque des fichiers sont créés ou supprimés.

Un Watchable objet est inscrit auprès d’un service espion en appelant sa Watchable#register register méthode, en retournant un WatchKey pour représenter l’inscription. Lorsqu’un événement pour un objet est détecté, la clé est signalée et, si ce n’est pas le cas, elle est mise en file d’attente vers le service espion afin qu’elle puisse être récupérée par les consommateurs qui appellent les #poll() poll clés ou #take() take méthodes pour récupérer les clés et traiter les événements. Une fois que les événements ont été traités, le consommateur appelle la méthode de WatchKey#reset reset la clé pour réinitialiser la clé, ce qui permet à la clé d’être signalée et réinitialisée avec d’autres événements.

L’inscription auprès d’un service espion est annulée en appelant la méthode de WatchKey#cancel cancel la clé. Une clé mise en file d’attente au moment où elle est annulée reste dans la file d’attente jusqu’à ce qu’elle soit récupérée. Selon l’objet, une clé peut être annulée automatiquement. Par exemple, supposons qu’un répertoire soit surveillé et que le service espion détecte qu’il a été supprimé ou que son système de fichiers n’est plus accessible. Lorsqu’une clé est annulée de cette façon, elle est signalée et mise en file d’attente, si elle n’est pas actuellement signalée. Pour vous assurer que le consommateur est averti de la valeur de retour de la reset méthode indique si la clé est valide.

Un service espion est sûr pour une utilisation par plusieurs consommateurs simultanés. Pour vous assurer qu’un seul consommateur traite les événements d’un objet particulier à tout moment, veillez à ce que la méthode de reset la clé soit appelée uniquement une fois ses événements traités. La #close close méthode peut être appelée à tout moment pour fermer le service à l’origine de tous les threads en attente de récupération des clés, pour lever ClosedWatchServiceException.

Les systèmes de fichiers peuvent signaler des événements plus rapidement qu’ils peuvent être récupérés ou traités et une implémentation peut imposer une limite non spécifiée au nombre d’événements qu’il peut accumuler. Lorsqu’une implémentation ignore en connaissance de cause les événements, elle organise la méthode de WatchKey#pollEvents pollEvents la clé pour retourner un élément avec un type d’événement de StandardWatchEventKinds#OVERFLOW OVERFLOW. Cet événement peut être utilisé par le consommateur comme déclencheur pour examiner à nouveau l’état de l’objet.

Lorsqu’un événement est signalé pour indiquer qu’un fichier dans un répertoire surveillé a été modifié, il n’existe aucune garantie que le programme (ou les programmes) qui ont modifié le fichier a été terminé. Veillez à coordonner l’accès avec d’autres programmes susceptibles de mettre à jour le fichier. La java.nio.channels.FileChannel FileChannel classe définit des méthodes pour verrouiller les régions d’un fichier par rapport à l’accès par d’autres programmes.

<Dépendances< de plateforme h2>/h2>

L’implémentation qui observe les événements du système de fichiers est destinée à être mappée directement à l’installation de notification des événements de fichier natif, le cas échéant, ou à utiliser un mécanisme primitif, tel que l’interrogation, lorsqu’une installation native n’est pas disponible. Par conséquent, la plupart des détails sur la façon dont les événements sont détectés, leurs chronologies et si leur classement est conservé sont très spécifiques à l’implémentation. Par exemple, lorsqu’un fichier dans un répertoire surveillé est modifié, il peut entraîner un événement unique StandardWatchEventKinds#ENTRY_MODIFY ENTRY_MODIFY dans certaines implémentations, mais plusieurs événements dans d’autres implémentations. Les fichiers de courte durée (ce qui signifie que les fichiers supprimés très rapidement après leur création) peuvent ne pas être détectés par des implémentations primitives qui interrogent régulièrement le système de fichiers pour détecter les modifications.

Si un fichier surveillé n’est pas situé sur un appareil de stockage local, il est spécifique à l’implémentation si les modifications apportées au fichier peuvent être détectées. En particulier, il n’est pas nécessaire que les modifications apportées aux fichiers effectués sur les systèmes distants soient détectées.

Ajouté dans la version 1.7.

Java documentation pour java.nio.file.WatchService.

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

Propriétés

Nom Description
Handle

Obtient la valeur JNI de l’objet Android sous-jacent.

(Hérité de IJavaObject)
JniIdentityHashCode

Retourne la valeur de java.lang.System.identityHashCode() l’instance encapsulée.

(Hérité de IJavaPeerable)
JniManagedPeerState

État de l’homologue managé.

(Hérité de IJavaPeerable)
JniObjectReferenceControlBlock

Obtient un pointeur de bloc de contrôle de référence JNI spécifique à l’implémentation.

(Hérité de IJavaPeerable)
JniPeerMembers

Prise en charge de l’accès aux membres et de l’appel.

(Hérité de IJavaPeerable)
PeerReference

Retourne une JniObjectReference instance d’objet Java encapsulée.

(Hérité de IJavaPeerable)

Méthodes

Nom Description
Close()

Ferme ce service espion.

Disposed()

Appelé lorsque l’instance a été supprimée.

(Hérité de IJavaPeerable)
DisposeUnlessReferenced()

S’il n’existe aucune référence en suspens à cette instance, les appels Dispose(); sinon, ne fait rien.

(Hérité de IJavaPeerable)
Finalized()

Appelé lorsque l’instance a été finalisée.

(Hérité de IJavaPeerable)
Poll()

Récupère et supprime la clé de surveillance suivante, ou null si aucune n’est présente.

Poll(Int64, TimeUnit)

Récupère et supprime la clé de surveillance suivante, en attendant si nécessaire jusqu’au temps d’attente spécifié si aucun n’est encore présent.

SetJniIdentityHashCode(Int32)

Définissez la valeur retournée par JniIdentityHashCode.

(Hérité de IJavaPeerable)
SetJniManagedPeerState(JniManagedPeerStates)

Définit les indicateurs d’état retournés par JniManagedPeerState.

(Hérité de IJavaPeerable)
SetPeerReference(JniObjectReference)

Définissez la valeur retournée par PeerReference.

(Hérité de IJavaPeerable)
Take()

Récupère et supprime la clé de surveillance suivante, en attendant qu’aucune n’est encore présente.

UnregisterFromRuntime()

Annulez l’inscription de cette instance afin que le runtime ne le retourne pas à partir d’appels futurs Java.Interop.JniRuntime+JniValueManager.PeekValue .

(Hérité de IJavaPeerable)

Méthodes d’extension

Nom Description
GetJniTypeName(IJavaPeerable)

Obtient le nom JNI du type de l’instance self.

JavaAs<TResult>(IJavaPeerable)

Essayez de forcer self le typeTResult, en vérifiant que le forçage est valide côté Java.

JavaCast<TResult>(IJavaObject)

Effectue une conversion de type vérifiée par le runtime Android.

JavaCast<TResult>(IJavaObject)

Réutilise un homologue managé compatible ou obtient un wrapper du type demandé.

TryJavaCast<TResult>(IJavaPeerable, TResult)

Essayez de forcer self le typeTResult, en vérifiant que le forçage est valide côté Java.

S’applique à