bytebuffer.put(bytebuffer)是零拷贝批量写入方法,直接搬移源缓冲区position到limit间数据至目标缓冲区,要求目标remaining≥源remaining,否则抛bufferoverflowexception;源或目标为只读时抛readonlybufferexception。

ByteBuffer.put(ByteBuffer) 是一种高效、零拷贝式的数据转移方式,它不经过中间 byte[] 数组,直接将源缓冲区中 position 到 limit 之间 的字节批量写入目标缓冲区,前提是目标缓冲区有足够剩余空间(target.remaining() >= source.remaining())。
核心机制:不复制数据,只移动指针
该方法本质是内存块的连续搬移,底层由 JVM 优化为 native memcpy 或等效指令。它不会创建新数组,也不触发 GC 压力,比 get(byte[]) + put(byte[]) 组合更轻量。
- 源缓冲区 position 自动前移,limit 不变;
- 目标缓冲区 position 自动前移对应字节数,limit 不变;
- 两个缓冲区的 mark(如果已设置)均不受影响;
- 若目标缓冲区剩余空间不足,抛出
BufferOverflowException; - 若源缓冲区为只读,抛出
ReadOnlyBufferException。
使用前提与典型流程
必须确保状态匹配:源缓冲区处于“可读模式”(即已完成写入并调用过 flip()),目标缓冲区处于“可写模式”(position 在有效写入起点,且未越界)。
- 写入阶段:用
put(...)向 srcBuf 写数据 → 调用srcBuf.flip(); - 转移阶段:检查
dstBuf.remaining() >= srcBuf.remaining()→ 调用dstBuf.put(srcBuf); - 后续处理:如需复用 srcBuf,可调用
srcBuf.compact()或clear()。
与其它批量写法的对比
相比常见替代方案,put(ByteBuffer) 在链路中更干净、可控:
- vs put(byte[]):避免显式分配临时数组,减少堆内存占用和 GC 频次;
-
vs array() + put(byte[],...):无需判断
hasArray()和arrayOffset(),兼容直接/非直接缓冲区; - vs channel.write(buffer):适用于纯内存内流转(如协议解析、消息拼装),不依赖 IO 通道。
注意事项与易错点
实际编码中容易忽略几个关键细节:
- 源缓冲区不能是只读的(
isReadOnly() == true); - 目标缓冲区不能是只读的,且必须有足够
remaining(); - 该操作不改变源或目标的 limit,仅移动 position;
- 若源缓冲区是
slice()或duplicate()得到的视图,仍按其自身 position/limit 范围转移,安全隔离; - 跨线程使用时,需自行同步——ByteBuffer 本身不是线程安全的。










