Selector

public abstract class Selector
extends Object implements Closeable

Known Direct Subclasses AbstractSelector AbstractSelector 选择器的基本实现类。

一个 SelectableChannel对象的多路复用器。

可以通过调用open方法创建选择器，该方法将使用系统的默认 selector provider来创建新的选择器。 选择器也可以通过调用自定义选择器提供程序的openSelector方法来创建。 选择器保持打开状态，直到它通过其close方法关闭。

A selectable channel's registration with a selector is represented by a SelectionKey对象。 选择器保持三组选择键：

• 密钥集包含代表此选择器当前通道注册的密钥。 该组由keys方法返回。

• 所选密钥集合是密钥集合 ，使得在先前的选择操作期间检测到每个密钥的信道准备好用于在密钥的兴趣集合中识别的至少一个操作。 该组由selectedKeys方法返回。 所选密钥集始终是密钥集的子集。

• 已取消密钥集是已被取消但其通道尚未注销的密钥集。 这套不能直接访问。 取消密钥集始终是密钥集的一个子集。

在新创建的选择器中，所有三组都是空的。

通过通道的register方法将一个键添加到选择器的键集中，作为注册频道的register 。 在选择操作期间取消的键将从键集中移除。 密钥集本身不能直接修改。

一个键被取消时添加到其选择器的取消键集中，无论是通过关闭其频道还是调用其cancel方法。 取消密钥将导致其频道在下一次选择操作期间被注销，此时该密钥将从所有选择器的密钥集中移除。

Keys are added to the selected-key set by selection operations. A key may be removed directly from the selected-key set by invoking the set's remove方法或通过调用从该集合获得的 iterator的remove方法。 密钥永远不会以任何其他方式从选定密钥集中移除; 特别是它们不作为选择操作的副作用而被移除。 密钥可能不会直接添加到所选密钥集中。

During each selection operation, keys may be added to and removed from a selector's selected-key set and may be removed from its key and cancelled-key sets. Selection is performed by the select() ， select(long) ，并 selectNow()方法，以及包括三个步骤：

1. 取消密钥集中的每个密钥都从其所属的每个密钥集中移除，并且其信道被注销。 此步骤将取消密钥集留空。

2. 查询底层操作系统的更新，以便关于每个剩余频道准备执行由选择操作开始时刻开始其密钥的兴趣集所标识的任何操作。 对于至少可以进行一次此类操作的通道，将执行以下两个操作之一：

   1. 如果通道的密钥尚未处于选定密钥集中，则会将其添加到该集中，并修改其准备好的操作集以准确标识现在报告通道准备就绪的那些操作。 先前记录在就绪集中的任何准备信息都被丢弃。

   2. 否则，通道的密钥已经在选定的密钥集中，因此其准备好的操作集被修改，以识别通道被报告准备就绪的任何新操作。 先前记录在就绪集合中的任何准备信息都被保留; 换句话说，由底层系统返回的就绪集按位分散到密钥的当前就绪集中。

If all of the keys in the key set at the start of this step have empty interest sets then neither the selected-key set nor any of the keys' ready-operation sets will be updated.

3. 如果在步骤（2）正在进行时将任何键添加到已取消键集中，则按照步骤（1）处理它们。

选择操作是否阻塞以等待一个或多个通道准备就绪，以及如果是这样多长时间，这三种选择方法之间唯一的本质区别。

Concurrency

选择器本身是安全的，可供多个并发线程使用; 但是，他们的钥匙套件却不是。

选择操作按照选择器本身，按键组和选定按键组的顺序进行同步。 他们还在上述步骤（1）和（3）中的取消密钥集上进行同步。

选择操作正在进行时对选择器按键的兴趣集所做的更改对该操作没有影响; 他们将在下一次选择操作中看到。

密钥可能会被取消，频道可能随时关闭。 因此，在一个或多个选择器密钥集中存在密钥并不意味着密钥是有效的或者其信道是开放的。 如果有可能另一个线程将取消一个键或关闭一个通道，则应用程序代码应该小心地同步并根据需要检查这些条件。

在 select()或 select(long)方法之一中阻塞的线程可能会被其他线程以三种方式之一中断：

• 通过调用选择器的方法 wakeup ，

• 通过调用选择器的 close方法，或者

• 通过调用阻塞的线程的 interrupt方法，在这种情况下，它的中断状态将被设置和选择的 wakeup方法将被调用。

close方法在选择器和所有三个按键集上按照与选择操作相同的顺序进行同步。

A selector's key and selected-key sets are not, in general, safe for use by multiple concurrent threads. If such a thread might modify one of these sets directly then access should be controlled by synchronizing on the set itself. The iterators returned by these sets' iterator方法是 快速失败的：如果在创建迭代器后修改了集合，除了调用迭代器自己的 remove方法之外， remove方法都会抛出 ConcurrentModificationException 。

Summary

Inherited methods
From class java.lang.Object Object clone() 创建并返回此对象的副本。 boolean equals(Object obj) 指示其他某个对象是否“等于”这一个。 void finalize() 当垃圾收集确定没有更多对该对象的引用时，由对象上的垃圾回收器调用。 final Class<?> getClass() 返回此 Object的运行时类。 int hashCode() 返回对象的哈希码值。 final void notify() 唤醒正在等待该对象监视器的单个线程。 final void notifyAll() 唤醒在该对象监视器上等待的所有线程。 String toString() 返回对象的字符串表示形式。 final void wait(long millis, int nanos) 导致当前线程等待，直到另一个线程为该对象调用 notify()方法或 notifyAll()方法，或者某个其他线程中断当前线程，或者经过一定的实时时间。 final void wait(long millis) 导致当前线程等待，直到另一个线程调用此对象的 notify()方法或 notifyAll()方法或经过了指定的时间量。 final void wait() 使当前线程等待，直到另一个线程调用此对象的 notify()方法或 notifyAll()方法。
From interface java.io.Closeable abstract void close() 关闭此流并释放与其关联的所有系统资源。
From interface java.lang.AutoCloseable abstract void close() 关闭此资源，放弃任何底层资源。

Protected constructors

Selector ()

Public methods

void close ()

boolean isOpen ()

Set<SelectionKey> keys ()

Selector open ()

SelectorProvider provider ()

int select (long timeout)

int select ()

int selectNow ()

Set<SelectionKey> selectedKeys ()

Selector wakeup ()