在 java nio 中,向 bytebuffer 写入字节数组应调用 put(byte[] src) 方法。该方法会将数组内容从当前 position 开始写入,并自动将 position 增加数组长度。若剩余空间不足会抛出 bufferoverflowexception,因此使用前需确保 remaining() 足够,或通过 arrayoffset() 和 limit() 控制写入范围。

put(byte[]) 与 put(byte[], int, int) 的区别是什么
两者核心区别在于是否指定写入起始偏移量。put(byte[] src) 从数组索引 0 开始写入,而 put(byte[] src, int offset, int length) 允许从数组任意位置截取子数组写入。后者更灵活,适合处理分包或协议头拼接场景,但需手动校验 offset + length 且缓冲区剩余空间充足。

import java.nio.ByteBuffer;
public class BufferPutDemo {
public static void main(String[] args) {
// 创建容量为 16 的堆缓冲区
ByteBuffer buffer = ByteBuffer.allocate(16);
byte[] data = {0x01, 0x02, 0x03, 0x04, 0x05};
// 方式一:全量写入
buffer.put(data);
System.out.println("Position after full put: " + buffer.position()); // 输出 5
// 重置 position 以便演示部分写入
buffer.flip();
buffer.position(0);
buffer.limit(16);
// 方式二:从索引 1 开始写入 3 个字节
buffer.put(data, 1, 3); // 写入 {0x02, 0x03, 0x04}
System.out.println("Position after partial put: " + buffer.position()); // 输出 3
}
}
运行上述代码,第一次 put(data) 后 position 变为 5;第二次 put(data, 1, 3) 后 position 变为 3(因从 0 开始覆盖前 3 字节)。注意:flip() 仅用于读取模式切换,此处仅为重置 position 以清晰展示行为。实际写入时通常无需 flip,直接基于当前 position 追加即可。
FilePond 是一个 JavaScript 文件上传库,支持通过拖拽、粘贴和 API 方式处理文件、目录、URL 和 Data URI。它包含内置的图像优化功能、异步分块上传功能,并提供了适用于 React、Vue、Angular 和 Svelte 的适配器。
立即学习“Java免费学习笔记(深入)”;
写入前如何安全检查缓冲区剩余空间
安全写入的关键是调用 remaining() 判断 limit - position 是否大于等于待写数据长度。若使用 put(byte[], int, int),则需比较 length 。不检查直接写入会导致运行时异常,尤其在网络分包或内存复用场景中极易触发。

import java.nio.ByteBuffer;
public class SafePutDemo {
public static void main(String[] args) {
ByteBuffer buffer = ByteBuffer.allocate(8);
byte[] largeData = new byte[10]; // 模拟大数据包
// 安全写入:先检查再写入
if (largeData.length <= buffer.remaining()) {
buffer.put(largeData);
System.out.println("Success: wrote " + largeData.length + " bytes");
} else {
System.out.println("Failed: need " + largeData.length + ", have " + buffer.remaining());
}
// 部分写入示例
int chunkSize = Math.min(5, buffer.remaining());
buffer.put(largeData, 0, chunkSize);
System.out.println("Wrote chunk of size: " + chunkSize);
}
}
该程序输出为:Failed: need 10, have 8Wrote chunk of size: 5
可见 remaining() 返回的是当前可写字节数,而非总容量。即使 capacity() == 8,若 position > 0,remaining() 会小于容量。务必在每次写入前动态计算可用空间,避免硬编码假设。
当缓冲区处于只读视图时 put 会怎样
若通过 asReadOnlyBuffer() 获取只读视图,任何 put 操作都会立即抛出 ReadOnlyBufferException。这是由底层 ByteBuffer 的 readOnly 标志位控制的,与原始缓冲区状态无关。即使原始缓冲区可写,只读视图也禁止修改。此设计用于防止意外篡改共享数据,适用于多线程只读访问场景。

















