IntObjectHashMap比HashMap更省内存，因其键用原生int（4字节）替代Integer对象（≥16字节），value直存平行数组而非Node节点（32字节起），且无链表指针，提升缓存命中率。
Netty 提供的 IntObjectMap 及其具体实现 IntObjectHashMap，不是为了“替代 HashMap”而存在，而是为特定场景——尤其是高吞吐、低延迟、内存敏感的网络服务中间件——量身定制的高性能原始类型集合。它真正价值在于：用 int 原生键 替代 Integer 包装类，绕过装箱/拆箱与 GC 压力，同时通过开放寻址法优化缓存局部性。
为什么 IntObjectMap 比 HashMap 更省？
核心差异不在接口层面，而在内存布局和运行时行为：
- 零包装对象开销：HashMap 的 key 必须是 Object，所以每个 int 都要 new 一个 Integer 实例，至少占用 16 字节（对象头 + value 字段 + 对齐填充）；IntObjectMap 直接在数组中存 raw int，仅占 4 字节。
-
更紧凑的 value 存储：HashMap 内部使用 Node
节点，每个节点含 hash、key、value、next 四个字段（通常 32 字节起）；IntObjectHashMap 用平行数组（keys[]、values[]、states[]），value 直接线性存放，无额外引用跳转。 - 无链表/树结构指针：不维护 next 引用或 TreeNode 结构，避免间接寻址，CPU 缓存命中率更高。
IntObjectMap 的典型适用场景
它不适合通用业务逻辑，但对以下场景效果显著：
- 连接 ID 映射管理：Netty 中常以 int 类型的 channel ID 或自增 request ID 为键，关联上下文对象（如 Session、RpcRequest）。
- 本地缓存索引：例如协议解析器中，将消息类型码（int）映射到对应的解码器实例；或统计模块中，用状态码（int）索引计数器对象。
- 高频短生命周期映射：单次请求内临时构建的轻量级查找表，生命周期与 EventLoop 任务一致，避免触发 Young GC。
使用时的关键注意事项
它高效，但有明确的设计取舍，不能简单套用：
- 键只能是 int，不支持 null key：若需表达“不存在”，靠返回 null value 或配合 containsKey 判断，不可 put(null, v)。
- 扩容代价高：采用线性探测开放寻址，rehash 需拷贝全部 keys/values 数组并重新散列，比 HashMap 的分桶迁移更重；应预估容量，调用 ensureCapacity(int) 避免频繁扩容。
- 不保证迭代顺序：entries() 返回的 Entry 是按内部数组顺序，非插入序，也不等价于 LinkedHashMap 行为。
- 线程不安全：和 HashMap 一样，多线程读写必须外加同步（如 Collections.synchronizedMap 包装，或限定在单个 EventLoop 内操作）。
同类结构还有哪些？
Netty 的 io.netty.util.collection 包还提供了一组配套原始类型集合：
-
LongObjectMap
：适用于 long 类型 ID（如分布式 traceId、时间戳毫秒值）映射。 -
CharObjectMap
：适合字符级协议解析，比如 ASCII 控制字符 → Handler 映射。 - IntObjectHashMap 已被标记为 legacy？注意版本差异：Netty 4.x 中该类仍在 io.netty.util.collection 下；Netty 5.x 路径变为 io.netty5.util.collection，接口统一为 IntObjectMap，实现类名保持一致。实际使用前建议确认依赖版本及包路径。
