在java nio中，使用bytebuffer的putdouble()方法可以将一个double类型的值写入缓冲区。默认情况下，该方法会按照大端序（big-endian）将8个字节的浮点数数据写入当前position指向的位置，并将position向后移动8个单位。如果希望使用小端序（little-endian），可以调用order(byteorder.little_endian)来改变缓冲区的字节序。
putDouble() 如何影响 position 和 limit？
putDouble()在执行写入操作后，会自动增加position的值，使其指向下一个可用的写入位置。如果写入操作导致position超过limit，则会抛出BufferOverflowException异常。需要注意的是，putDouble()不会修改limit的值，因此在使用完putDouble()后，如果需要读取数据，通常需要手动调用flip()方法来重置position为0，并将limit设置为当前的position。
import java.nio.ByteBuffer;
import java.nio.ByteOrder;
public class ByteBufferPutDoubleExample {
public static void main(String[] args) {
// 创建一个容量为32字节的ByteBuffer
ByteBuffer buffer = ByteBuffer.allocate(32);
// 写入两个double值
buffer.putDouble(1.23456789);
buffer.putDouble(9.87654321);
// 打印写入前的position和limit
System.out.println("Before flip - Position: " + buffer.position() + ", Limit: " + buffer.limit());
// 翻转缓冲区，准备读取
buffer.flip();
// 读取并打印double值
double val1 = buffer.getDouble();
double val2 = buffer.getDouble();
System.out.println("Read values: " + val1 + ", " + val2);
System.out.println("After read - Position: " + buffer.position() + ", Limit: " + buffer.limit());
}
}
上述代码首先创建了一个32字节的ByteBuffer，然后连续写入了两个double值。写入完成后，position变为16（因为每个double占8字节）。接着调用flip()将position重置为0，limit设为16。最后通过getDouble()读取这两个值，验证写入是否正确。
立即学习“Java免费学习笔记（深入）”；
你是 TypeScript 项目架构专家，专注于脚手架搭建生产就绪的 Node.js 和前端应用。生成包含现代工具链（pnpm、Vite、Next.js）、类型
putDouble() 在大端和小端模式下的区别是什么？
putDouble()在默认的大端序模式下，会将最高有效字节放在低地址，最低有效字节放在高地址。而在小端序模式下，顺序相反。这种差异在网络传输或跨平台数据交换时尤为重要，因为不同系统可能采用不同的字节序。可以通过order()方法切换字节序，确保数据在不同环境下的一致性。
import java.nio.ByteBuffer;
import java.nio.ByteOrder;
public class ByteBufferByteOrderExample {
public static void main(String[] args) {
// 创建两个缓冲区，分别设置大端和小端
ByteBuffer bigEndianBuffer = ByteBuffer.allocate(8).order(ByteOrder.BIG_ENDIAN);
ByteBuffer littleEndianBuffer = ByteBuffer.allocate(8).order(ByteOrder.LITTLE_ENDIAN);
// 写入相同的double值
double value = 0.5;
bigEndianBuffer.putDouble(value);
littleEndianBuffer.putDouble(value);
// 获取字节数组并打印
byte[] bigBytes = bigEndianBuffer.array();
byte[] littleBytes = littleEndianBuffer.array();
System.out.print("Big-Endian bytes: ");
for (byte b : bigBytes) {
System.out.printf("%02X ", b & 0xFF);
}
System.out.println();
System.out.print("Little-Endian bytes: ");
for (byte b : littleBytes) {
System.out.printf("%02X ", b & 0xFF);
}
System.out.println();
}
}
该示例展示了同一double值在大端和小端模式下的字节表示差异。运行结果会显示两组不同的十六进制字节序列，直观体现字节序对数据存储的影响。在实际开发中，若需与特定协议或平台交互，应显式指定字节序以避免解析错误。
当缓冲区剩余空间不足时 putDouble() 会抛出什么异常？
当ByteBuffer的剩余空间（即limit - position）小于8字节时，调用putDouble()会立即抛出java.nio.BufferOverflowException。这是NIO缓冲区的保护机制，防止越界写入破坏内存结构。开发者应在写入前检查buffer.remaining() >= 8，或使用ensureCapacity()等策略动态扩容，以确保写入安全。
