如何通过 ByteBuffer 的 flip 与 compact 指针操作理解 NIO 缓冲区的读写模式转换

老敏小哥_3999

老敏小哥_3999

2026-04-13

588人浏览

原创

flip()是写完转读的唯一安全切换动作:将limit设为当前position、position重置为0,不改变capacity和底层数组,使后续get()能从头读取已写入的全部数据。

如何通过 bytebuffer 的 flip 与 compact 指针操作理解 nio 缓冲区的读写模式转换

flip() 是写完转读的唯一安全切换动作

不调用 flip() 就直接 get(),结果不是读到 0,就是抛 BufferUnderflowException。因为写完后 position 停在数据末尾,limit 还是 capacity,读操作会从末尾开始、一路越界。

flip() 只做两件事:limit = position,然后 position = 0。它不复制、不清空、不改变 capacity,只是“封存当前写入成果”,让后续 get() 能从头读到刚写进去的所有字节。

  • 典型场景:用 channel.read(buffer) 写入后,必须 flip() 才能交给 decoder 或 get() 解析
  • 误用风险:重复调用 flip() 会让 limit = 0,再读就什么都没有
  • 只读 ByteBuffer 也能调 flip(),但之后调 put() 会抛 ReadOnlyBufferException

compact() 是半包处理时的读写衔接关键

TCP 粘包场景下,一次 read() 可能只收到半个消息。这时你不能 flip()(否则后半截丢了),也不能 clear()(前半截白读了)。compact() 就是为此设计的:把 position 到 limit 之间还没读完的数据,拷贝到缓冲区开头,再把 position 设为已拷贝长度,limit 恢复为 capacity。

  • 执行后状态示例:原 buffer 容量 1024,写入 800 字节 → position=800, limit=1024;读了 500 字节 → position=500, limit=1024;调 compact() 后 → 前 300 字节移到开头,position=300, limit=1024
  • 注意:这是内存拷贝操作,64KB 以上缓冲区频繁调用会影响吞吐,可考虑增大初始容量或改用堆外缓冲区减少 GC 压力
  • compact() 后不能立刻 get(),得先 flip() —— 因为它本质是为“继续写”准备的,不是为读

clear() 和 rewind() 的语义差异常被混淆

clear() 是“全盘重来”:position = 0,limit = capacity,相当于把缓冲区当新分配的一样用,之前所有数据逻辑上丢弃(底层数组不变,但指针已移开)。

rewind() 是“重头再来”:position = 0,limit 不变。适合你刚读了一半又想重读一遍,或者写了一半想检查开头内容。

  • 误用案例:读完数据后调 clear() 再写,没问题;但如果读完一半发现格式错,想重试解析,该用 rewind(),不是 clear()
  • rewind() 不影响 limit,所以如果之前没调过 flip(),limit 还是 capacity,rewind() 后 get() 可能读到脏数据
  • 三者都不加锁,多线程共享同一个 ByteBuffer 时,必须自行同步或改用线程局部实例

实际调试时怎么看指针状态

别靠猜,直接打日志看三个值。JDK 自带的 toString() 输出格式是 java.nio.HeapByteBuffer[pos=0 lim=1024 cap=1024],一眼就能确认当前模式。

  • 写模式特征:position
  • 读模式特征:position ,且 limit 通常等于上一轮写入长度
  • 危险状态:position == limit 时再 get() 必抛异常;position > limit 是非法状态,一般由手动改指针导致
  • 建议在关键路径(如 read() 后、flip() 前、get() 循环中)插入 System.out.println(buffer) 快速定位问题

真正容易被忽略的是:这些指针操作全部不校验业务逻辑。比如 flip() 后 limit 是 0,它不会提醒你“你根本没写入任何数据”;compact() 把未读数据挪到开头,也不会保证那 300 字节恰好是个完整协议帧。边界判断和协议解析,始终得由你自己兜底。

PHP速学视频免费教程(入门到精通)
PHP速学视频免费教程(入门到精通)

PHP怎么学习?PHP怎么入门?PHP在哪学?PHP怎么学才快?不用担心,这里为大家提供了PHP速学教程(入门到精通),有需要的小伙伴保存下载就能学习啦!

下载

相关标签:

本站声明:本文内容由网友自发贡献,版权归原作者所有,本站不承担相应法律责任。如您发现有涉嫌抄袭侵权的内容,请联系admin@php.cn

相关专题

更多
java
java

Java是一个通用术语,用于表示Java软件及其组件,包括“Java运行时环境 (JRE)”、“Java虚拟机 (JVM)”以及“插件”。php中文网还为大家带了Java相关下载资源、相关课程以及相关文章等内容,供大家免费下载使用。

2023.06.15

12137

6

java正则表达式语法
java正则表达式语法

java正则表达式语法是一种模式匹配工具,它非常有用,可以在处理文本和字符串时快速地查找、替换、验证和提取特定的模式和数据。本专题提供java正则表达式语法的相关文章、下载和专题,供大家免费下载体验。

2023.07.05

9222

9

java自学难吗
java自学难吗

Java自学并不难。Java语言相对于其他一些编程语言而言,有着较为简洁和易读的语法,本专题为大家提供java自学难吗相关的文章,大家可以免费体验。

2023.07.31

7872

8

java配置jdk环境变量
java配置jdk环境变量

Java是一种广泛使用的高级编程语言,用于开发各种类型的应用程序。为了能够在计算机上正确运行和编译Java代码,需要正确配置Java Development Kit(JDK)环境变量。php中文网给大家带来了相关的教程以及文章,欢迎大家前来阅读学习。

2023.08.01

1284

3

java保留两位小数
java保留两位小数

Java是一种广泛应用于编程领域的高级编程语言。在Java中,保留两位小数是指在进行数值计算或输出时,限制小数部分只有两位有效数字,并将多余的位数进行四舍五入或截取。php中文网给大家带来了相关的教程以及文章,欢迎大家前来阅读学习。

2023.08.02

1028

3

java基本数据类型
java基本数据类型

java基本数据类型有:1、byte;2、short;3、int;4、long;5、float;6、double;7、char;8、boolean。本专题为大家提供java基本数据类型的相关的文章、下载、课程内容,供大家免费下载体验。

2023.08.02

1536

5

java有什么用
java有什么用

java可以开发应用程序、移动应用、Web应用、企业级应用、嵌入式系统等方面。本专题为大家提供java有什么用的相关的文章、下载、课程内容,供大家免费下载体验。

2023.08.02

3169

5

java在线网站
java在线网站

Java在线网站是指提供Java编程学习、实践和交流平台的网络服务。近年来,随着Java语言在软件开发领域的广泛应用,越来越多的人对Java编程感兴趣,并希望能够通过在线网站来学习和提高自己的Java编程技能。php中文网给大家带来了相关的视频、教程以及文章,欢迎大家前来学习阅读和下载。

2023.08.03

20431

3

配置java环境变量
配置java环境变量

配置Java环境变量是为了让操作系统能够识别和使用Java的相关命令和功能。本专题为大家提供配置java环境变量相关文章,帮助大家解决问题。

2023.08.03

1395

8

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
热门推荐
/
最新课程
phpStudy极速入门视频教程
phpStudy极速入门视频教程

共6课时 | 54.7万人学习

独孤九贱(4)_PHP视频教程
独孤九贱(4)_PHP视频教程

共89课时 | 134.1万人学习