Интерфейс WatchKey

Ключ наблюдения создается при регистрации объекта watchable в службе наблюдения. Ключ остается 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 вызывался только после обработки событий для объекта. Это гарантирует, что в любой момент времени один поток обрабатывает события для объекта.