java包装类仅作不可变数值载体，不参与字节解析；应使用原始类型+bytebuffer显式字节序处理+边界校验完成解析，再用包装类封装业务语义。
Java 包装类本身不直接参与网络报文解析，也不具备“安全转换字节数据”的能力；真正承担字节解析与数值封装的是 字节序处理、边界校验、类型转换逻辑，包装类（如 Integer、Long、Short）仅作为不可变的业务数值载体。关键在于：**用好原始类型 + 显式字节操作 + 包装类做结果封装，而非依赖包装类自动解析**。
明确字节布局与字节序（Big/Little Endian）
网络协议（如 TCP/IP、自定义二进制协议）通常规定字段长度和字节序（多数为大端，即网络字节序）。若误读字节序，会导致数值错乱（如 0x00000001 读成 16777216）。
- 使用
ByteBuffer并显式设置order(ByteOrder.BIG_ENDIAN)或order(ByteOrder.LITTLE_ENDIAN) - 避免直接用
Integer.parseInt(new String(bytes), 16)等字符串中转方式——效率低、易出错、不支持有符号扩展 - 示例：解析 4 字节大端整数字段
int value = bb.getInt(); // 原始 int，非 new Integer(...) —— 后续再包装
严格校验字节范围与有效性
网络数据不可信，必须防止越界读取、截断、溢出或非法编码（如将超范围字节解释为 short 导致负值）。
- 检查剩余字节数 ≥ 字段长度（如解析 long 需 ≥ 8 字节）
- 对有符号类型，确认协议是否允许负值；若协议约定为无符号（如 uint32），需用
Long.toUnsignedString()或手动掩码（如(bb.getInt() & 0xFFFFFFFFL)）转为逻辑无符号值 - 对枚举/状态码等字段，解析后应校验是否在合法取值范围内，非法值可抛
ProtocolException或设为 UNKNOWN
用包装类封装业务语义，而非参与解析
解析完成后的原始值（int、long 等）可安全装箱为包装类，用于构建不可变业务对象，体现领域含义。
- 避免在解析过程中频繁装箱（如循环里写
new Integer(bb.get())），优先复用原始类型做计算 - 推荐用 record 或普通 POJO 封装完整报文字段，内部字段用包装类表示“可空业务值”（如 header length 可为
Integer表示缺失时为 null） - 示例业务对象：
Integer version,
Long sequenceNumber,
Short payloadLength) {}
// 解析后构造：
PacketHeader header = new PacketHeader(
bb.get() & 0xFF, // byte → Integer，保留为非负
bb.getLong(),
bb.getShort());
统一异常处理与不可变性保障
解析失败不应静默吞掉错误，而应提供上下文信息（偏移、期望长度、实际剩余）；业务对象一旦构建，应禁止修改。
- 自定义解析异常（如
MalformedPacketException extends RuntimeException），携带 packet ID、offset、expectedSize 等字段 - 业务对象字段全部用
final或 record，确保线程安全与语义清晰 - 不依赖包装类的“空安全”特性来掩盖解析缺陷——null 应是有意设计（如可选字段未出现），而非解析失败的默认 fallback
Java免费学习笔记：立即使用
解锁 Java 大师之旅：从入门到精通的终极指南
