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