IWatchKey Interfaccia

Definizione

[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

Attributi

RegisterAttribute

Implementazioni

IJavaObject IJavaPeerable IDisposable

Commenti

Token che rappresenta la registrazione di un Watchable watchable oggetto con un oggetto WatchService.

Una chiave di controllo viene creata quando un oggetto watchable viene registrato con un servizio espressioni di controllo. La chiave rimane #isValid valid fino a: <ol<>li> Viene annullata, in modo esplicito, richiamando il metodo #cancel cancel o</li li><> Cancelled in modo implicito, perché l'oggetto non è più accessibile o </li<>Li> Dal WatchService#close closing servizio espressioni di controllo. </li></ol>

Una chiave di controllo ha uno stato. Quando la chiave è stata creata inizialmente, si dice che sia <em>ready</em>. Quando viene rilevato un evento, la chiave viene <segnalata></em> e accodata in modo che possa essere recuperata richiamando i metodi o WatchService#take() take del WatchService#poll() poll servizio espressioni di controllo. Una volta segnalato, una chiave rimane in questo stato fino a quando non #reset reset viene richiamato il relativo metodo per restituire la chiave allo stato pronto. Gli eventi rilevati mentre la chiave si trova nello stato segnalato vengono accodati, ma non causano la ripetizione della coda della chiave per il recupero dal servizio espressioni di controllo. Gli eventi vengono recuperati richiamando il metodo della #pollEvents pollEvents chiave. Questo metodo recupera e rimuove tutti gli eventi accumulati per l'oggetto . Al momento della creazione iniziale, una chiave di controllo non ha eventi in sospeso. In genere, gli eventi vengono recuperati quando la chiave si trova nello stato segnalato che porta al linguaggio seguente:

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

Le chiavi di controllo sono sicure per l'uso da parte di più thread simultanei. Se sono presenti diversi thread che recuperano chiavi segnalate da un servizio espressioni di controllo, è necessario prestare attenzione a assicurarsi che il reset metodo venga richiamato solo dopo l'elaborazione degli eventi per l'oggetto. In questo modo si garantisce che un thread stia elaborando gli eventi per un oggetto in qualsiasi momento.

Aggiunta nella versione 1.7.

per java.nio.file.WatchKey.

Le parti di questa pagina sono modifiche basate sul lavoro creato e condiviso dalla e usati in base ai termini descritti in Creative License 2.5 Attribution License.