SelectionKey 是 Java NIO 中通道与 Selector 的纽带，封装通道、关注事件、就绪事件及附件等状态，支持动态修改 interestOps 并需正确处理生命周期。
在 Java NIO 中，SelectionKey 是连接通道（Channel）与 Selector 的纽带，它代表一个已注册到选择器上的通道及其关注的事件类型。通过它，你可以在单线程中高效地管理成百上千个网络连接，实现非阻塞 I/O 多路复用。
注册通道并获取 SelectionKey
要让 Selector 监控某个通道的事件，必须先将该通道注册到选择器，并指定关注的操作类型（如 OP_READ、OP_WRITE、OP_CONNECT、OP_ACCEPT）。注册后会返回一个 SelectionKey 实例，后续所有对该通道事件的处理都围绕它展开。
常见注册方式示例：
-
服务端监听通道（ServerSocketChannel）：注册
OP_ACCEPT，等待新客户端连接 -
已建立的客户端或服务端数据通道（SocketChannel）：注册
OP_READ（通常还需OP_WRITE，但写操作一般按需启用）
注意：通道必须处于非阻塞模式（configureBlocking(false)），否则注册会抛出异常。
立即学习“Java免费学习笔记（深入）”；
通过 SelectionKey 获取关联对象和状态
每个 SelectionKey 封装了关键上下文信息，常用方法包括：
Java开发手册规约集合，基于阿里巴巴Java开发手册（嵩山版）。 涵盖7大维度：编程规约、异常日志、单元测试、安全规约、MySQL数据库、工程结构、设计规约。 当用户需要：(1) 编写或审查Java代码 (2) 检查命名/代码规范 (3) 处理异常和日志 (4) 编写单元测试 (5) 安全编码 (6) 数据库设...
-
channel()：获取绑定的通道（如SocketChannel） -
selector()：获取所属的选择器 -
interestOps()：获取当前关注的事件集合（如SelectionKey.OP_READ | SelectionKey.OP_WRITE） -
readyOps()：获取本次select()返回后已就绪的事件（即真正可操作的事件） -
attachment()和attach(Object)：存取自定义附件（常用于存放ByteBuffer、用户会话对象等）
例如，读取就绪的数据时，可从 key 取出 channel 和 attachment 中的 buffer，避免反复查找上下文。
动态修改关注事件（interestOps）
事件关注集不是一成不变的。比如：
- 刚完成连接建立（
OP_CONNECT就绪）后，应取消该操作，改为注册OP_READ - 写缓冲区满时，可能暂时不关注
OP_WRITE；待下次write()返回 0 或抛出IOException后，再重新 interestOps 添加OP_WRITE，等待底层 TCP 缓冲区有空间
修改方式为：key.interestOps(key.interestOps() | SelectionKey.OP_WRITE) 或直接赋值 key.interestOps(SelectionKey.OP_READ)。注意：该操作是线程安全的，但建议在 selector 所在线程中执行（如 select 循环内），避免竞态。
处理完事件后记得清理或重置
每次 select() 返回后，就绪的 key 会被放入 selected-key set。你必须显式遍历并处理它们。处理完毕后：
- 调用
key.cancel()：彻底移除该 key（如连接关闭时） - 或调用
key.channel().close()：自动触发 cancel - 若需继续监听，无需额外操作；但若未处理完（如读取未清空 buffer），下次 select 仍可能返回同一 key（取决于就绪状态是否持续）
特别提醒：不要在遍历 selected-key set 时直接 remove key —— 应使用 Iterator.remove()，否则可能抛出 ConcurrentModificationException。
掌握 SelectionKey 的生命周期和状态流转，是写出健壮 NIO 网络程序的核心。它把“哪个通道发生了什么事件、附带什么上下文、接下来该关注什么”全部封装在一起，让单线程驱动海量连接成为可能。
