SelectionKey (Платформа Java SE 7)

java.lang. Объект
- java.nio.channels. SelectionKey

Прямые Известные Подклассы:

AbstractSelectionKey
```
public abstract class SelectionKey
extends Object
```
Маркер, представляющий регистрацию a SelectableChannel с a Selector.
Ключ выбора создается каждый раз, когда канал регистрируется в селекторе. Ключ остается допустимым, пока он не отменяется, вызывая cancel метод, закрывая его канал, или закрывая его селектор. Отмена ключа сразу не удаляет это из своего селектора; это вместо этого добавляется к отмененному набору ключей селектора для удаления во время следующей работы выбора. Законность ключа может быть протестирована, вызывая isValid метод.
Ключ выбора содержит два набора работы, представленные как целочисленные значения. Каждый бит набора работы обозначает категорию выбираемых операций, которые поддерживаются каналом ключа.
- Набор интереса определяет, какие категории работы будут протестированы на готовность в следующий раз, когда один из методов выбора селектора вызывается. Набор интереса инициализируется со значением, данным, когда ключ создается; это может позже быть изменено через interestOps(int) метод.
- Готовый набор идентифицирует категории работы, к которым канал ключа был обнаружен, чтобы быть готов селектором ключа. Готовый набор инициализируется, чтобы обнулить, когда ключ создается; это может позже быть обновлено селектором во время работы выбора, но это не может быть обновлено непосредственно.
То, что готовый набор ключа выбора указывает, что его канал готов к некоторой категории работы, является подсказкой, но не гарантией, что работа в такой категории может быть выполнена потоком, не заставляя поток блокировать. Готовый набор, наиболее вероятно, сразу будет точен после завершения работы выбора. Это, вероятно, будет сделано неточным внешними событиями и операциями ввода-вывода, которые вызываются на соответствующий канал.
Этот класс определяет все известные установленные в работу биты, но точно какие биты поддерживаются данным каналом, зависит от типа канала. Каждый подкласс SelectableChannel определяет validOps() метод, который возвращает набор, идентифицирующий только те операции, которые поддерживаются каналом. Попытка установить или протестировать установленный в работу бит, который не поддерживается каналом ключа, приведет к соответствующему исключению на этапе выполнения.
Часто необходимо связать некоторые специализированные данные с ключом выбора, например объект, который представляет состояние высокоуровневого протокола и обрабатывает уведомления о готовности, чтобы реализовать тот протокол. Ключи выбора поэтому поддерживают присоединение единственного произвольного объекта к ключу. Объект может быть присоединен через attach метод и затем позже полученный через attachment метод.
Ключи выбора безопасны для использования многократными параллельными потоками. Операции чтения и записи набора интереса будут, вообще, синхронизироваться с определенными операциями селектора. Точно то, как эта синхронизация выполняется, является зависящим от реализации: В наивной реализации, читая или пишущий набор интереса может блокировать неопределенно, если работа выбора уже происходит; в высокоэффективной реализации, читая или пишущий набор интереса может блокировать кратко, если вообще. В любом случае работа выбора будет всегда использовать установленное в интерес значение, которое было текущим в настоящее время, который начала работа.
С тех пор:

1.4

См. Также:
SelectableChannel, Selector

Полевая Сводка

Поля
Модификатор и Тип	Поле и Описание
`static int`	`OP_ACCEPT` Установленный в работу бит для сокета - принимает операции.
`static int`	`OP_CONNECT` Установленный в работу бит для операций подключения сокета.
`static int`	`OP_READ` Установленный в работу бит для операций чтения.
`static int`	`OP_WRITE` Установленный в работу бит для операций записи.

Сводка конструктора

Конструкторы
Модификатор Конструктор и Описание

protected SelectionKey()
Создает экземпляр этого класса.

Конструкторы
Модификатор	Конструктор и Описание
`protected`	`SelectionKey()` Создает экземпляр этого класса.

Сводка метода

Методы
Модификатор и Тип	Метод и Описание
`Объект`	`attach(Object ob)` Присоединяет данный объект к этому ключу.
`Объект`	`attachment()` Получает текущее присоединение.
`abstract void`	`cancel()` Запросы, что регистрация канала этого ключа с его селектором быть отмененным.
`abstract SelectableChannel`	`channel()` Возвращает канал, для которого создавался этот ключ.
`abstract int`	`interestOps()` Получает набор интереса этого ключа.
`abstract SelectionKey`	`interestOps(int ops)` Наборы набор интереса этого ключа к данному значению.
`boolean`	`isAcceptable()` Тесты, готов ли канал этого ключа принять новое сокетное соединение.
`boolean`	`isConnectable()` Тесты, закончился ли канал этого ключа или, или был не в состоянии закончиться, его работа сокетного соединения.
`boolean`	`isReadable()` Тесты, готов ли канал этого ключа к чтению.
`abstract boolean`	`isValid()` Говорит, допустим ли этот ключ.
`boolean`	`isWritable()` Тесты, готов ли канал этого ключа к записи.
`abstract int`	`readyOps()` Получает набор готовой работы этого ключа.
`abstract Selector`	`selector()` Возвращает селектор, для которого создавался этот ключ.

Методы java.lang унаследованный от класса. Объект
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

- Полевая Деталь
  - 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()
```
    Создает экземпляр этого класса.
- Деталь метода
  - канал
```
public abstract SelectableChannel channel()
```
    Возвращает канал, для которого создавался этот ключ. Этот метод будет продолжать возвращать канал даже после того, как ключ будет отменен.
    
    Возвраты:
    Канал этого ключа
  - селектор
```
public abstract Selector selector()
```
    Возвращает селектор, для которого создавался этот ключ. Этот метод будет продолжать возвращать селектор даже после того, как ключ будет отменен.
    
    Возвраты:
    Селектор этого ключа
  - isValid
```
public abstract boolean isValid()
```
    Говорит, допустим ли этот ключ.
    Ключ допустим после создания и остается так, пока это не отменяется, его канал закрывается, или его селектор закрывается.
    
    Возвраты:
    true, если, и только если, этот ключ допустим
  - отмена
```
public abstract void cancel()
```
    Запросы, что регистрация канала этого ключа с его селектором быть отмененным. По возврату ключ будет недопустим и будет добавлен к отмененному набору ключей его селектора. Ключ будет удален изо всех наборов ключей селектора во время следующей работы выбора.
    Если этот ключ был уже отменен, затем вызывая этот метод, не имеет никакого эффекта. После того, как отмененный, ключ остается навсегда недопустимым.
    
    В любое время может быть вызван этот метод. Это синхронизируется на отмененном наборе ключей селектора, и поэтому может блокировать кратко если вызвано одновременно с отменой или работой выбора, включающей тот же самый селектор.
  - interestOps
```
public abstract int interestOps()
```
    Получает набор интереса этого ключа.
    Гарантируется, что возвращенный набор будет только содержать биты работы, которые допустимы для канала этого ключа.
    В любое время может быть вызван этот метод. Блокирует ли это, и как долго, является зависящим от реализации.
    
    Возвраты:
    Интерес этого ключа устанавливается
    
    Броски:
    
    CancelledKeyException - Если этот ключ был отменен
  - interestOps
```
public abstract SelectionKey interestOps(int ops)
```
    Наборы набор интереса этого ключа к данному значению.
    В любое время может быть вызван этот метод. Блокирует ли это, и как долго, является зависящим от реализации.
    
    Параметры:
    ops - Новый интерес устанавливается
    
    Возвраты:
    Этот ключ выбора
    
    Броски:
    
    IllegalArgumentException - Если немного в наборе не соответствует работе, которая поддерживается каналом этого ключа, то есть, если (ops & ~channel().validOps()) != 0
    
    CancelledKeyException - Если этот ключ был отменен
  - readyOps
```
public abstract int readyOps()
```
    Получает набор готовой работы этого ключа.
    Гарантируется, что возвращенный набор будет только содержать биты работы, которые допустимы для канала этого ключа.
    
    Возвраты:
    Готовая работа этого ключа устанавливается
    
    Броски:
    
    CancelledKeyException - Если этот ключ был отменен
  - isReadable
```
public final boolean isReadable()
```
    Тесты, готов ли канал этого ключа к чтению.
    Вызов этого метода формы k.isReadable() ведет себя точно таким же образом как выражение
    k.readyOps() & OP_READ != 0
    Если канал этого ключа не поддерживает операции чтения тогда, этот метод всегда возвращает false.
    Возвраты:
    true, если, и только если, readyOps() & OP_READ является ненулевым
    
    Броски:
    
    CancelledKeyException - Если этот ключ был отменен
  - isWritable
```
public final boolean isWritable()
```
    Тесты, готов ли канал этого ключа к записи.
    Вызов этого метода формы k.isWritable() ведет себя точно таким же образом как выражение
    k.readyOps() & OP_WRITE != 0
    Если канал этого ключа не поддерживает операции записи тогда, этот метод всегда возвращает false.
    Возвраты:
    true, если, и только если, readyOps() & OP_WRITE является ненулевым
    
    Броски:
    
    CancelledKeyException - Если этот ключ был отменен
  - isConnectable
```
public final boolean isConnectable()
```
    Тесты, закончился ли канал этого ключа или, или был не в состоянии закончиться, его работа сокетного соединения.
    Вызов этого метода формы k.isConnectable() ведет себя точно таким же образом как выражение
    k.readyOps() & OP_CONNECT != 0
    Если канал этого ключа не поддерживает операции подключения сокета тогда, этот метод всегда возвращает false.
    Возвраты:
    true, если, и только если, readyOps() & OP_CONNECT является ненулевым
    
    Броски:
    
    CancelledKeyException - Если этот ключ был отменен
  - isAcceptable
```
public final boolean isAcceptable()
```
    Тесты, готов ли канал этого ключа принять новое сокетное соединение.
    Вызов этого метода формы k.isAcceptable() ведет себя точно таким же образом как выражение
    k.readyOps() & OP_ACCEPT != 0
    Если канал этого ключа не поддерживает сокет - принимают операции тогда, этот метод всегда возвращает false.
    Возвраты:
    true, если, и только если, readyOps() & OP_ACCEPT является ненулевым
    
    Броски:
    
    CancelledKeyException - Если этот ключ был отменен
  - присоединение
```
public final Object attach(Object ob)
```
    Присоединяет данный объект к этому ключу.
    Присоединенный объект может позже быть получен через attachment метод. Только один объект может быть присоединен за один раз; вызов этого метода заставляет любое предыдущее присоединение быть отброшенным. Текущее присоединение может быть отброшено, присоединяя null.
    
    Параметры:
    ob - Объект, который будет присоединен; может быть null
    
    Возвраты:
    Ранее присоединенный объект, если таковые вообще имеются, иначе null
  - присоединение
```
public final Object attachment()
```
    Получает текущее присоединение.
    
    Возвраты:
    Объект, в настоящий момент присоединенный к этому ключу, или null, если нет никакого присоединения

Представьте ошибку или функцию
Для дальнейшей ссылки API и документации разработчика, см. Java Документация SE. Та документация содержит более подробные, предназначенные разработчиком описания, с концептуальными краткими обзорами, определениями сроков, обходных решений, и рабочих примеров кода.
Авторское право © 1993, 2011, Oracle и/или его филиалы. Все права защищены.

Класс SelectionKey

Полевая Сводка

Сводка конструктора

Сводка метода

Методы java.lang унаследованный от класса. Объект

Полевая Деталь

OP_READ

OP_WRITE

OP_CONNECT

OP_ACCEPT

Деталь конструктора

SelectionKey

Деталь метода

канал

селектор

isValid

отмена

interestOps

interestOps

readyOps

isReadable

isWritable

isConnectable

isAcceptable

присоединение

присоединение