Selector Класс

Определение

[Android.Runtime.Register("java/nio/channels/Selector", DoNotGenerateAcw=true)]
public abstract class Selector : Java.Lang.Object, IDisposable, Java.Interop.IJavaPeerable, Java.IO.ICloseable

[<Android.Runtime.Register("java/nio/channels/Selector", DoNotGenerateAcw=true)>]
type Selector = class
    inherit Object
    interface ICloseable
    interface IJavaObject
    interface IDisposable
    interface IJavaPeerable

Наследование

Object

Object

Selector

Производный

Java.Nio.Channels.Spi.AbstractSelector

Атрибуты

RegisterAttribute

Реализации

IJavaObject IJavaPeerable ICloseable IDisposable

Комментарии

Мультиплексор SelectableChannel объектов.

Селектор может быть создан путем вызова #open open метода этого класса, который будет использовать систему по умолчанию java.nio.channels.spi.SelectorProvider selector provider для создания нового селектора. Селектор также может быть создан путем вызова java.nio.channels.spi.SelectorProvider#openSelector openSelector метода пользовательского поставщика селектора. Селектор остается открытым, пока он не будет закрыт через его #close close метод.

"ks">

Регистрация выбранного канала с помощью селектора представлена SelectionKey объектом. Селектор поддерживает три набора ключей выбора:

<ul>

<Литий>

Набор ключей содержит ключи, представляющие текущие регистрации каналов этого селектора. Этот набор возвращается методом #keys() keys .

</Литий>

<Литий>

Выбранный набор ключей — это набор ключей, так что канал каждого ключа был обнаружен готовым по крайней мере к одной из операций, определенных в интересе ключа во время предыдущей операции выбора, которая добавляет ключи или обновления ключей в набор. Этот набор возвращается методом #selectedKeys() selectedKeys . Выбранный набор ключей всегда является подмножеством набора ключей.

</Литий>

<Литий>

Набор отмененных ключей — это набор ключей, которые были отменены, но каналы которых еще не зарегистрированы. Этот набор недоступен напрямую. Набор отмененных ключей всегда является подмножеством набора ключей.

</Литий>

</ul>

Все три набора пусты в созданном селекторе.

Ключ добавляется в набор ключей селектора в качестве побочных эффектов регистрации канала с помощью метода канала SelectableChannel#register(Selector,int) register . Отмененные ключи удаляются из набора ключей во время операций выбора. Сам набор ключей не является напрямую изменяемым.

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

"sks">

Ключи добавляются в выбранный набор ключей операциями выбора. Ключ может быть удален непосредственно из набора выбранных ключей путем вызова метода набора java.util.Set#remove(java.lang.Object) remove или вызова java.util.Iterator#remove() remove метода, полученного java.util.Iterator iterator из набора. Все ключи могут быть удалены из набора выбранных ключей путем вызова метода набора java.util.Set#clear() clear . Ключи могут не добавляться непосредственно в выбранный набор ключей.

"selop"><h2 Selection</h2>>

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

<Пр>

<Литий>

#select(long)Методы #select()и #selectNow() методы добавляют ключи каналов, готовые к выполнению операции в набор выбранных ключей, или обновите готовый набор ключей, уже в выбранном наборе ключей.

</Литий>

<Литий>

#select(Consumer, long)Методы #select(Consumer)и #selectNow(Consumer) методы выполняют действие с ключом каждого канала, готового к выполнению операции. Эти методы не добавляются в набор выбранных ключей.

</Литий>

</Пр>

<Операции выбора h3>, которые добавляются в набор< выбранных ключей/h3>

Во время каждой операции выбора ключи могут быть добавлены и удалены из выбранного набора ключей селектора и могут быть удалены из его ключа и отмененных наборов ключей. Выбор выполняется методами #select()и #select(long)#selectNow() методами, а также включает три этапа:

<Пр>

<Литий>

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

</Литий>

<Литий>

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

<Пр>

<Литий>

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

</Литий>

<Литий>

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

</Литий>

</Пр>

Если все ключи в наборе ключей в начале этого шага имеют пустые наборы интересов, то ни выбранный набор ключей, ни все наборы готовых операций ключей не будут обновлены.

<Литий>

Если все ключи были добавлены в набор отмененных ключей во время выполнения шага (2), они обрабатываются как на шаге (1).

</Литий>

</Пр>

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

<Операции выбора h3>, выполняющие действие с выбранными ключами</h3>

Во время каждой операции выбора ключи могут быть удалены из ключа селектора, выбранного ключа и отмененных наборов ключей. Выбор выполняется методами #select(Consumer)и #select(Consumer,long)#selectNow(Consumer) методами, а также включает три этапа:

<Пр>

<Литий>

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

</Литий>

<Литий>

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

Для канала, готового по крайней мере к одной такой операции, набор готовых операций ключа канала определяет именно те операции, для которых канал готов, и действие , указанное select методу, вызывается для использования ключа канала. Все сведения о готовности, записанные ранее в готовом наборе, удаляются до вызова действия.

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

</Литий>

<Литий>

Если все ключи были добавлены в набор отмененных ключей во время выполнения шага (2), они обрабатываются как на шаге (1).

</Литий>

</Пр>

<h2>Concurrency</h2>

Селектор и его набор ключей безопасны для использования несколькими параллельными потоками. Его выбранный набор ключей и отмененный набор ключей, однако, не являются.

Операции выбора синхронизируются с селектором в выбранном наборе ключей в этом порядке. Они также синхронизируются с набором отмененных ключей во время шагов (1) и (3) выше.

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

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

Поток, заблокированный в операции выбора, может быть прерван другим потоком одним из трех способов:

<ul>

<Литий>

Вызывая метод селектора #wakeup wakeup ,

</Литий>

<Литий>

Вызов метода селектора #close close или

</Литий>

<Литий>

Вызывая метод заблокированного java.lang.Thread#interrupt() interrupt потока, в этом случае его состояние прерывания будет задано, а метод селектора #wakeup wakeup будет вызван.

</Литий>

</ul>

Метод #close close синхронизируется с селектором и выбранным ключом в том же порядке, что и в операции выбора.

"ksc">

Набор ключей селектора является безопасным для использования несколькими параллельными потоками. Операции извлечения из набора ключей обычно не блокируются и поэтому могут перекрываться новыми регистрациями, добавляющими в набор, или с этапами отмены операций выбора, которые удаляют ключи из набора. Итераторы и разделители возвращают элементы, отражающие состояние набора в какой-то момент или после создания итератора или разбителя. Они не бросают java.util.ConcurrentModificationException ConcurrentModificationException.

"sksc">

Выбранный набор ключей селектора не является безопасным для использования несколькими параллельными потоками. Если такой поток может изменить набор непосредственно, то доступ должен управляться синхронизацией в самом наборе. Итераторы, возвращаемые методами набора java.util.Set#iterator() iterator , завершаются сбоем: если набор изменяется после создания итератора, в любом случае, за исключением вызова собственного java.util.Iterator#remove() remove метода итератора, java.util.ConcurrentModificationException создается исключение.

Добавлено в версии 1.4.

Документация по Java для java.nio.channels.Selector.

Части этой страницы — это изменения на основе работы, созданной и общей проектом с открытым исходным кодом Android и используемой в соответствии с условиями, описанными в лицензии Creative Commons 2.5 Attribution.

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

Свойства

Методы

Явные реализации интерфейса

Методы расширения

Применяется к