Java NIO ByteBuffer flip 后 limit 和 position 怎么变化

Java NIO 里，ByteBuffer.flip() 的作用不是“把数据倒过来”，而是把缓冲区从写入视角切换为读取视角。调用前如果已经写入了 n 个字节，那么调用后 position=0、limit=n，capacity 保持不变。后续相对读取只能访问下标 0 到 n-1 的有效内容。

官方资料：https://docs.oracle.com/en/java/javase/25/docs/api/java.base/java/nio/ByteBuffer.html

先记住 flip 的核心变化：position 归零，limit 接管已写长度

ByteBuffer 有三个最容易混淆的状态值：capacity 是总容量，通常创建后不变；position 是下一次相对读写的位置；limit 是相对读写允许到达的上界。刚通过 allocate(16) 创建时，通常是 position=0，limit=16，capacity=16。

连续执行三次 put 后，position 变成 3，limit 仍是 16。此时直接 get 会从位置 3 开始读，方向没有切换。flip() 做的事情可以概括为：先把当前 position 记到 limit，再把 position 归零，同时丢弃旧 mark。

用一个 ByteBuffer 示例看读写模式切换

下面的例子写入 3 个字节，再读取这 3 个字节。代码中的注释只解释状态变化，避免把容量尾部的空闲空间误认为有效数据。

import java.nio.ByteBuffer;

public class FlipDemo {
    public static void main(String[] args) {
        ByteBuffer buffer = ByteBuffer.allocate(8);
        buffer.put((byte) 10).put((byte) 20).put((byte) 30);

        // flip 把已写长度交给 limit，并把读取位置移到 0
        buffer.flip();
        System.out.printf("position=%d, limit=%d, capacity=%d%n",
                buffer.position(), buffer.limit(), buffer.capacity());

        while (buffer.hasRemaining()) {
            // relative get 读取当前位置，并自动推进 position
            System.out.println(buffer.get());
        }
    }
}

这里输出的状态是 position=0, limit=3, capacity=8。第一次 get() 读下标 0，读完后 position 变为 1；当 position 到达 limit，hasRemaining() 返回 false。容量是 8 并不意味着本轮有 8 个字节可读。

flip、rewind、clear、compact 怎么区分

这四个方法都可能让 position 变化，但目标不同。实际代码里不要看到 position 不对就随意调用 clear()，因为它会把当前读写边界重置为“整块容量可写”，并不保存未读数据。

例如读取网络半包时，当前 limit 内还有未解析字节，不能直接 clear()。应先读取已完整处理的部分，再用 compact() 把剩余字节移到缓冲区开头，随后继续写入新的网络数据。

生产代码里的检查清单

1. 写入结束后是否明确调用了 flip()，而不是直接 get()？
2. 读取循环是否使用 hasRemaining() 或先判断 remaining()？
3. 是否把 capacity 当成了本轮有效数据长度？有效长度应看 limit。
4. 是要重读、覆盖写，还是保留未读半包？分别选择 rewind()、clear()、compact()。

如果出现 BufferUnderflowException，先打印 position、limit、remaining，通常能快速判断是少调用了 flip，还是读取协议本身还没有收齐。

相关问题

flip 会改变 ByteBuffer 的 capacity 吗？

不会。capacity 是底层容量；flip 只调整 limit 和 position。

flip 后还能继续 put 吗？

可以调用，但此时 limit 已变成有效数据末尾，通常不是继续写入的正确状态。要重新填充整块缓冲区，应先 clear。

为什么 get 读不到 capacity 的末尾？

相对读取受 limit 限制。flip 后 limit 是旧 position，容量尾部属于本轮尚未写入的数据，不应被读取。