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 Spring Boot 后端 Controller 代码，自动生成 Markdown 格式的接口文档。当用户说“生成 Java 接口文档”、“生成 API 文档”、“从 Spring 代码生成文档”时触发。
- 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；若本次处理完毕，回到第一步）
Java免费学习笔记：立即使用
解锁 Java 大师之旅：从入门到精通的终极指南
