Интерфейс WatchKey

Ключ наблюдения создаётся при регистрации объекта наблюдения в службе наблюдения. Ключ остаётся valid до тех пор, пока:

1. Он не будет отменён явным вызовом метода cancel, или
2. Не будет отменён неявно, поскольку объект станет недоступен, или
3. Пока служба наблюдения не будет closing.

Ключ наблюдения имеет состояние. При создании ключ считается готовым. При обнаружении события ключ получает сигнал и помещается в очередь, чтобы его можно было извлечь, вызвав методы службы наблюдения poll или take. После получения сигнала ключ остаётся в этом состоянии, пока не будет вызван его метод reset, возвращающий ключ в готовое состояние. События, обнаруженные, пока ключ находится в состоянии сигнала, помещаются в очередь, но не приводят к повторному помещению ключа в очередь для извлечения из службы наблюдения. События извлекаются вызовом метода ключа pollEvents. Этот метод извлекает и удаляет все накопившиеся события для объекта. При создании у ключа наблюдения нет ожидающих событий. Обычно события извлекаются, когда ключ находится в состоянии сигнала, что приводит к следующему шаблону:

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

Ключи наблюдения безопасно использовать из нескольких параллельных потоков. Если несколько потоков извлекают ключи, получившие сигнал, из службы наблюдения, необходимо следить за тем, чтобы метод reset вызывался только после обработки событий для объекта. Это гарантирует, что в каждый момент времени события для объекта обрабатывает только один поток.