IWatchKey Interfaz

Definición

[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

Atributos

RegisterAttribute

Implementaciones

IJavaObject IJavaPeerable IDisposable

Comentarios

Token que representa el registro de un Watchable watchable objeto con .WatchService

Se crea una clave de inspección cuando se registra un objeto de inspección con un servicio de inspección. La clave permanece #isValid valid hasta: <ol><li> Se cancela, explícitamente, invocando su #cancel cancel método o</li><> Canceled implícitamente, porque el objeto ya no es accesible o </li<>li> Por WatchService#close closing el servicio de inspección. </li></ol>

Una clave de inspección tiene un estado. Cuando inicialmente se crea la clave se dice que es <em>ready</em>. Cuando se detecta un evento, la clave se <>señala/<em> y se pone en cola para que se pueda recuperar invocando los métodos o WatchService#take() take del WatchService#poll() poll servicio de inspección. Una vez señalizada, una clave permanece en este estado hasta que se invoca su #reset reset método para devolver la clave al estado listo. Los eventos detectados mientras la clave está en estado señalado se ponen en cola, pero no hacen que la clave se vuelva a poner en cola para la recuperación desde el servicio de inspección. Los eventos se recuperan invocando el método de #pollEvents pollEvents la clave. Este método recupera y quita todos los eventos acumulados para el objeto . Cuando se crea inicialmente, una clave de inspección no tiene eventos pendientes. Normalmente, los eventos se recuperan cuando la clave está en estado señalado que conduce a la siguiente expresión:

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

Las claves de inspección son seguras para su uso por varios subprocesos simultáneos. Si hay varios subprocesos que recuperan claves señaladas de un servicio de inspección, se debe tener cuidado para asegurarse de que el reset método solo se invoca después de procesar los eventos del objeto. Esto garantiza que un subproceso está procesando los eventos de un objeto en cualquier momento.

Agregado en la versión 1.7.

Documentación de Java para java.nio.file.WatchKey.

Las partes de esta página son modificaciones basadas en el trabajo creado y compartido por el Android y se usan según los términos descritos en creative Creative Commons 2.5 Attribution License.