ByteBuffer.wrap是最轻量的包装方式，不复制数据、不分配新内存，直接用原byte[]构建缓冲区视图；底层共享数组、position默认0、limit和capacity等于数组长度、mark未设置、字节序为BigEndian、返回HeapByteBuffer。
ByteBuffer.wrap 是最轻量的包装方式，不复制数据、不分配新内存，直接用原 byte[] 构建缓冲区视图。
核心行为必须清楚
调用 ByteBuffer.wrap(byte[]) 后： • 底层仍是你传入的原始数组，修改缓冲区内容会立刻反映在数组上，反之亦然； • position 默认为 0，limit 和 capacity 都等于数组长度； • mark 未设置（值为 -1），不可 reset； • 字节序默认为 BigEndian； • 返回的是 HeapByteBuffer，不是 DirectBuffer，也不属于任何缓冲区池。
常用写法与典型场景
基础包装（整个数组）：
byte[] data = "hello".getBytes(StandardCharsets.UTF_8);<br> ByteBuffer bb = ByteBuffer.wrap(data);
只暴露子区间（跳过前4字节头）：ByteBuffer bb = ByteBuffer.wrap(data, 4, data.length - 4);
此时 position = 4，limit = data.length，可直接从第5个字节开始读写。
配合字符串快速转缓冲区：ByteBuffer bb = ByteBuffer.wrap("ACK".getBytes(StandardCharsets.US_ASCII));
写入后读取必须 flip()
刚 wrap 出来的缓冲区处于“初始写模式”： • 可用 put() 写入，position 随之推进； • 但 limit 仍等于 capacity，get() 会抛 BufferUnderflowException； • 必须显式调用 flip() 才能切换到读模式。
正确流程示例：
byte[] buf = new byte[8];<br> ByteBuffer bb = ByteBuffer.wrap(buf);<br> bb.put((byte)1).put((byte)2).put((byte)3); // 写入3字节，position=3<br> bb.flip(); // limit=3, position=0<br> byte b = bb.get(); // → 1
注意事项和常见陷阱
• 生命周期要可控：若原数组是局部变量或会被其他逻辑复用，长期持有该缓冲区可能导致意外覆盖或读脏数据； • 无法扩容：wrap 生成的缓冲区 capacity 固定，不能通过 compact() 或 reallocate 改变大小； • array() 返回原始引用：调用 bb.array() 得到的就是你传进来的那个数组，注意别误改； • 多线程慎用：除非确保数组只被单一线程访问，否则应 clone 数组再 wrap，或改用 allocate + put(array)； • 不是池化操作：wrap 不等于入池，它不参与 Netty 等框架的缓冲区池管理，需要池化请用 PooledByteBufAllocator 分配并拷贝。
