Класс SelectionKey

public abstract class SelectionKey
extends Object

Токен, представляющий регистрацию SelectableChannel с Selector.

Ключ выбора создаётся каждый раз, когда канал регистрируется с селектором. Ключ остаётся действительным до тех пор, пока он не будет отменён вызовом метода cancel, путём закрытия канала или закрытия селектора. Отмена ключа не удаляет его немедленно из селектора; вместо этого он добавляется в множество отменённых ключей селектора для удаления во время следующей операции выбора. Действительность ключа можно проверить, вызвав метод isValid.

Ключ выбора содержит два набора операций, представленных в виде целых значений. Каждый бит набора операций обозначает категорию выбираемых операций, поддерживаемых каналом ключа.

• Набор интересов определяет, какие категории операций будут проверены на готовность при следующем вызове одного из методов выбора селектора. Набор интересов инициализируется значением, заданным при создании ключа; позже он может быть изменён с помощью метода interestOps(int).

• Набор готовности идентифицирует категории операций, для которых канал ключа был обнаружен селектором ключа как готовый. Набор готовности инициализируется нулём при создании ключа; позже он может быть обновлён селектором во время операции выбора, но не может быть обновлён напрямую.

То, что набор готовности ключа выбора указывает на готовность его канала к выполнению какой-либо категории операций, является подсказкой, но не гарантией, что операция в такой категории может быть выполнена потоком без блокировки потока. Набор готовности, скорее всего, будет точным сразу после завершения операции выбора. Скорее всего, он станет неточным из-за внешних событий и операций ввода-вывода, вызываемых на соответствующем канале.

Этот класс определяет все известные биты наборов операций, но точный набор битов, поддерживаемых данным каналом, зависит от типа канала. Каждый подкласс SelectableChannel определяет метод validOps(), который возвращает набор, идентифицирующий только те операции, которые поддерживаются каналом. Попытка установить или проверить бит набора операций, который не поддерживается каналом ключа, приведёт к соответствующему исключению во время выполнения.

Часто необходимо связать некоторые данные, специфичные для приложения, с ключом выбора, например, объект, представляющий состояние протокола более высокого уровня и обрабатывающий уведомления о готовности для реализации этого протокола. Поэтому ключи выбора поддерживают прикрепление одного произвольного объекта к ключу. Объект можно прикрепить с помощью метода attach, а затем позже извлечь с помощью метода attachment.

Ключи выбора безопасны для использования несколькими одновременными потоками. Операция выбора всегда будет использовать значение набора интересов, которое было текущим в момент начала операции.

Поля

OP_READ

public static final int OP_READ

Бит набора операций для операций чтения.

Предположим, что набор интересов ключа выбора содержит OP_READ в начале операции выбора. Если селектор обнаруживает, что соответствующий канал готов к чтению, достиг конца потока, был удалён удалённо для дальнейшего чтения или имеет ожидаемую ошибку, тогда он добавит OP_READ к набору операций готовности ключа.

См. также:

Значения константных полей

OP_WRITE

public static final int OP_WRITE

Бит набора операций для операций записи.

Предположим, что набор интересов ключа выбора содержит OP_WRITE в начале операции выбора. Если селектор обнаруживает, что соответствующий канал готов к записи, был удалён удалённо для дальнейшей записи или имеет ожидаемую ошибку, тогда он добавит OP_WRITE к набору готовности ключа.

См. также:

Значения константных полей

OP_CONNECT

public static final int OP_CONNECT

Бит набора операций для операций подключения сокета.

Предположим, что набор интересов ключа выбора содержит OP_CONNECT в начале операции выбора. Если селектор обнаруживает, что соответствующий канал сокета готов завершить последовательность соединения или имеет ожидаемую ошибку, тогда он добавит OP_CONNECT к набору готовности ключа.

См. также:

Значения константных полей

OP_ACCEPT

public static final int OP_ACCEPT

Бит набора операций для операций принятия сокета.

Предположим, что набор интересов ключа выбора содержит OP_ACCEPT в начале операции выбора. Если селектор обнаруживает, что соответствующий канал серверного сокета готов принять другое соединение или имеет ожидаемую ошибку, тогда он добавит OP_ACCEPT к набору готовности ключа.

См. также:

Значения константных полей

Конструкторы

SelectionKey

protected SelectionKey()

Конструирует экземпляр этого класса.