position、limit、capacity 是控制读写范围的整数索引:capacity 固定为分配大小;position 指向当前读/写位置;limit 是操作截止下标;flip() 将 limit 设为 position 并重置 position 为 0;clear() 归零 position 并恢复 limit 为 capacity;compact() 移动未读数据至开头并更新 position 和 limit;rewind() 仅重置 position 为 0;所有操作均不加锁,多线程共享需自行同步。

position、limit、capacity 三个指针到底在动什么
它们不是“指针”而是整数索引,控制着你每次 put() 或 get() 能操作哪一段内存。真正关键的不是“它们是什么”,而是“谁改它们、什么时候改、为什么这么改”。
比如:ByteBuffer.allocate(8) 创建后,capacity 固定为 8,position 是 0,limit 也是 8 —— 此时是写模式,你可以往里写最多 8 字节。
当你调用 put((byte)'a') 一次,position 变成 1;再写 3 次,position 就是 4。此时缓冲区里有 4 个有效字节,但 limit 还是 8,你继续 put() 会覆盖或抛异常(取决于是否越界)。
-
position:当前读/写起始下标,每次put()/get()后自动+1 -
limit:读/写操作的“截止下标”,不能等于也不能超过它 -
capacity:永远不变,是分配内存时定死的总长度
flip() 不是“切换模式”,而是“封边界 + 归零读起点”
很多人误以为 flip() 是给 Buffer 打了个“读模式 flag”,其实它只干两件事:limit = position,然后 position = 0。没有其他副作用,也不检查你有没有写满、有没有读完。
常见错误现象:flip() 后 hasRemaining() 返回 false,或者读出来全是 0 —— 很可能是因为写入时没成功(比如 channel.read(buffer) 返回 -1 或 0),导致 position 还是 0,flip() 后 limit 也变成 0。
- 必须确认写操作真实推进了
position,再调flip() -
flip()前如果position == 0,那翻完啥也读不到 -
flip()不清空数据,也不移动已有字节,只是重划读取范围
clear() 和 compact() 的本质区别在“要不要保留未读数据”
clear() 是暴力重置:把 position 设为 0,limit 设为 capacity,准备从头覆盖写。适合“上一批数据已完全处理完毕”的场景。
compact() 是温和回收:把所有未读数据(即 position 到 limit 之间的字节)拷贝到缓冲区开头,然后 position 设为“未读数据长度”,limit 设为 capacity。适合处理半包(比如 TCP 粘包)时,前半段已读完,后半段不够一个完整消息,要留着等下次续写。
- 如果你用
clear()处理半包,未读数据会被后续put()直接覆盖,消息就丢了 -
compact()会触发一次数组内拷贝,小缓冲区影响不大,大缓冲区(如 64KB+)要注意性能 - 二者都不影响底层
hb(堆内字节数组)内容,只是调整指针和搬数据
rewind()、mark()/reset() 不是读写转换,而是“读写过程中的微调”
rewind() 就是 position = 0,mark = -1,常用于想重复读一遍刚写进去的内容(比如调试打印),但它不改 limit —— 如果之前 flip() 过,limit 还是上次写入长度,没问题;但如果之前是写模式且没 flip(),limit 是 capacity,rewind() 后直接 get() 可能读到脏数据。
mark() 记下当前 position,reset() 回退到那个位置。比 rewind() 更灵活,但容易忘调 mark() 就直接 reset(),抛 InvalidMarkException。
- 不要依赖
rewind()来“模拟 flip()”,它不设limit -
mark()是一次性快照,put()/get()之后再mark()才会更新 - 这些操作都绕不开
position ≤ limit这个硬约束,违反就会抛BufferUnderflowException或BufferOverflowException
最易被忽略的一点:所有指针操作(flip、clear、rewind 等)都是无锁、无同步的纯内存状态变更。多线程共用同一个 ByteBuffer 实例时,哪怕只调一个 flip(),也可能让另一个线程的读写逻辑彻底错乱 —— 这不是 bug,是设计使然。










