JavaByteBuffer字节操作技巧

Java ByteBuffer作为NIO中高效处理字节数据的核心工具，不仅支持堆内与堆外缓冲区的灵活创建、多类型数据的精准读写（如putInt/getLong）和可配置的字节序控制，更通过position、limit、capacity三要素及flip/clear等状态转换机制，为网络编程、文件IO、序列化和二进制协议解析等高性能场景提供了坚实基础——掌握其底层原理与正确用法，是写出稳定、高效字节操作代码的关键所在。

在Java中处理字节数据时，ByteBuffer 是 NIO（New I/O）包中最核心的类之一。它提供了一种高效、灵活的方式来读写原始字节数据，适用于网络通信、文件操作、序列化等场景。本文将介绍 ByteBuffer 的基本用法和常见操作，帮助你快速掌握其应用。

创建 ByteBuffer 实例

ByteBuffer 支持多种方式创建实例，主要分为堆内缓冲区和堆外缓冲区两种类型。

• allocate(int capacity)：创建一个指定容量的堆内缓冲区（基于 JVM 堆内存）
• allocateDirect(int capacity)：创建堆外缓冲区，适合对性能要求较高的场景，如网络传输
• wrap(byte[] array)：将已有字节数组包装成 ByteBuffer

byte[] data = {1, 2, 3, 4};
ByteBuffer buffer = ByteBuffer.allocate(10);        // 容量为10的堆缓冲区
ByteBuffer directBuf = ByteBuffer.allocateDirect(8); // 直接缓冲区
ByteBuffer wrapped = ByteBuffer.wrap(data);         // 包装现有数组

理解 Buffer 的核心属性：position、limit、capacity

每个 ByteBuffer 都有三个关键属性，控制着数据的读写位置和范围：

• capacity：缓冲区最大容量，不可变
• position：当前读写位置，初始为0，每次读写后自动递增
• limit：可操作的数据边界，不能超过 capacity

调用 flip() 方法会将 limit 设置为当前 position，position 置为0，用于从写模式切换到读模式。clear() 重置状态准备再次写入。

写入与读取字节数据

ByteBuffer 提供了多种 put 和 get 方法来操作不同类型的数据。

• put(byte b)：写入单个字节
• put(byte[] src)：批量写入字节数组
• putInt(int value)：写入4字节整数（注意字节序）
• get()：读取一个字节
• getInt()：读取4字节整数

ByteBuffer buf = ByteBuffer.allocate(12);
buf.putInt(123456);
buf.putLong(9876543210L);

buf.flip(); // 切换到读模式

int i = buf.getInt();    // 读出 123456
long l = buf.getLong();  // 读出 9876543210L

设置字节序（Byte Order）

多平台数据交互时，字节序（大端或小端）很重要。ByteBuffer 默认使用大端序（ByteOrder.BIG_ENDIAN），可通过 order() 方法修改。

ByteBuffer buf = ByteBuffer.allocate(8);
buf.order(java.nio.ByteOrder.LITTLE_ENDIAN); // 设置为小端序
buf.putInt(0x12345678);
// 在小端系统中，字节存储顺序为 78 56 34 12

常见应用场景

• 网络编程：配合 SocketChannel 发送或接收二进制数据包
• 文件读写：与 FileChannel 配合实现高效文件 IO
• 对象序列化：手动编码结构化数据，如消息头+体格式
• 数据解析：解析二进制协议（如图片、音视频、自定义格式）

今天关于《JavaByteBuffer字节操作技巧》的内容介绍就到此结束，如果有什么疑问或者建议，可以在golang学习网公众号下多多回复交流；文中若有不正之处，也希望回复留言以告知！