flip用于写后读前，将position设为0、limit设为当前position以锁定已写数据；clear用于读后写前，将position设为0、limit设为capacity以重置为可写状态，二者均不擦除底层数据。

flip 和 clear 是 Java NIO Buffer（如 ByteBuffer）中控制读写模式切换的两个关键方法，用错顺序或场景会导致读不到数据、覆盖有效内容、甚至越界异常。它们不擦除数据，只调整内部指针——理解这一点，调用就自然清晰了。

flip：写完之后、读之前必须调用

当你用 put() 写入一批数据后，position 已移动到末尾，但此时 buffer 仍处于“写模式”，limit 还是 capacity，直接 get() 会读到未初始化区域或抛出异常。flip 的作用就是安全锁定已写范围，进入读模式：

• 把 limit 设为当前 position 值（即已写入的有效字节数）
• 把 position 归零（让读操作从头开始）
• 清除 mark（mark = -1）

典型流程：put() → flip() → get()。例如写入 "Hi"（2 字节），position 变为 2；flip 后 limit=2、position=0，后续 get(2) 才能准确读出这两个字节，不会多读乱码。

clear：读完之后、再写之前推荐调用

读完所有有效数据（比如 get() 到 limit）后，position 等于 limit，buffer 处于“读完状态”，不能再写（因为 position ≥ limit）。clear 就是把它重置为可写状态：

java-api-doc-generator

分析 Java Spring Boot 后端 Controller 代码，自动生成 Markdown 格式的接口文档。当用户说“生成 Java 接口文档”、“生成 API 文档”、“从 Spring 代码生成文档”时触发。

下载

立即学习“Java免费学习笔记（深入）”；

• position ← 0
• limit ← capacity
• mark ← -1

注意：底层数组里的旧数据还在，只是下次 put() 会从头覆盖。所以 clear 适合确定要丢弃之前全部内容、重新写入新数据的场景，比如每次 channel.read(buffer) 前都应 clear()，确保读进来的数据从缓冲区开头存放。

别混淆：flip 不是“清空”，clear 不是“读完才准用”

常见误用：

• 写了一半就想重头读？别 flip —— flip 是为“读全部已写内容”设计的；该用 rewind()（position=0，limit 不变）
• 读了一部分还没读完，但想再写点新数据？别 clear —— 它会丢失未读数据边界；该用 compact() 把未读内容移到开头，腾出尾部空间
• 刚 new 出 buffer 就 flip？没意义——position=0，flip 后 limit=0、position=0，get() 直接返回 0 字节

一个完整循环示例

处理网络请求时典型的 buffer 复用流程：

• clear() —— 准备接收新数据
• channel.read(buffer) —— 写入数据，position 移动
• flip() —— 锁定实际读到的字节数，准备解析
• decode / parse / get() —— 读取有效载荷
• （若需继续读剩余数据，用 rewind 或反复 get；若本次处理完毕，回到第一步）