在 java nio 中,使用 bytebuffer 的 putlong() 方法可以将一个 long 类型的值写入缓冲区。默认情况下,该方法使用大端序(big-endian)将 8 个字节写入当前位置,并将位置指针向后移动 8 个单位。若需指定偏移量或切换为小端序,可分别调用带偏移量的重载方法或先设置缓冲区的字节序。

如何向 ByteBuffer 写入 long 值并获取结果
直接调用 putLong(long val) 即可将数据写入缓冲区。执行后,缓冲区的 position 会增加 8。如果缓冲区剩余空间不足,会抛出 BufferOverflowException。可以通过 flip() 切换模式以便后续读取。

import java.nio.ByteBuffer;
import java.nio.ByteOrder;
public class Main {
public static void main(String[] args) {
// 创建容量为 16 字节的堆缓冲区
ByteBuffer buffer = ByteBuffer.allocate(16);
// 写入第一个 long 值:0x0000000000000001 (十进制 1)
buffer.putLong(1L);
// 写入第二个 long 值:0x0000000000000002 (十进制 2)
buffer.putLong(2L);
// 切换为读模式
buffer.flip();
// 读取并打印
System.out.println(buffer.getLong()); // 输出 1
System.out.println(buffer.getLong()); // 输出 2
}
}
上述代码首先分配了足够的空间,然后连续写入两个 long 值。由于默认是大端序,高位字节在前。读取时顺序一致,能正确还原数值。若缓冲区空间不足,例如只分配了 4 字节,则 putLong 会抛出异常。
立即学习“Java免费学习笔记(深入)”;
如何指定写入位置或使用小端序
如果需要将 long 写入特定位置,可以使用 putLong(int index, long val)。这会覆盖该位置的 8 个字节,但不会改变 position 的值。若需使用小端序(Little-Endian),需先调用 order(ByteOrder.LITTLE_ENDIAN)。小端序下,低位字节存储在低地址。

import java.nio.ByteBuffer;
import java.nio.ByteOrder;
public class Main {
public static void main(String[] args) {
ByteBuffer buffer = ByteBuffer.allocate(8);
// 设置小端序
buffer.order(ByteOrder.LITTLE_ENDIAN);
// 写入长整型 0x0102030405060708
long val = 0x0102030405060708L;
buffer.putLong(val);
// 切换到读模式
buffer.flip();
// 读取验证
long readVal = buffer.getLong();
System.out.println(Long.toHexString(readVal)); // 输出 102030405060708
// 测试指定位置写入
ByteBuffer buffer2 = ByteBuffer.allocate(16);
buffer2.putLong(0, 100L); // 从索引 0 开始写
buffer2.putLong(8, 200L); // 从索引 8 开始写
buffer2.flip();
System.out.println(buffer2.getLong()); // 输出 100
System.out.println(buffer2.getLong()); // 输出 200
}
}
通过 order() 修改字节序后,后续的 putLong 和 getLong 都会遵循新设定的顺序。指定索引的写入方式适合构建固定格式的数据包,如网络协议头。注意,指定索引写入不移动 position,因此读取时需手动调整或使用 position(index)。
当 ByteBuffer 是只读视图时 putLong 会发生什么
如果对 ByteBuffer 调用 asReadOnlyBuffer() 生成的只读缓冲区,或者原始缓冲区是通过 allocateDirect 创建的且被包装成只读视图,调用 putLong 会抛出 ReadOnlyBufferException。这是为了防止意外修改不可变数据。在实际开发中,若需修改只读缓冲区的内容,必须基于原缓冲区进行操作,或重新分配新的缓冲区。


















