Java ByteBuffer mark 和 reset 怎样回到已标记位置
我第一次在 Java NIO 里给变长字段做“试读”时,最容易混淆的是:mark() 并没有复制一份字节,reset() 也不是把缓冲区内容恢复原样。它们操作的是同一个 ByteBuffer 的游标状态。直接记住一句话:mark() 记录当前 position,reset() 把 position 放回这个标记位置。
官方地址:https://docs.oracle.com/en/java/javase/26/docs/api/java.base/java/nio/ByteBuffer.html
如果只是想在解析判断失败后回到某个读取位置,优先用 mark/reset;如果需要多个互不影响的读取视角,再考虑 duplicate。reset 能否成功,关键在于 mark 是否仍然有效。
mark 保存的是 position,不是数据副本
ByteBuffer 至少要看三个状态:position 是下一次相对读写的位置,limit 是当前可访问上界,mark 是可选的回退位置。调用 mark() 时,mark 被设置为当下的 position;调用 reset() 时,position 回到 mark,mark 本身不会因为 reset 自动消失。
ByteBuffer buffer = ByteBuffer.wrap(new byte[] {10, 20, 30, 40});
// 先读取一个字节,再把当前位置记下来,便于后续回退。
buffer.get();
buffer.mark();
// 相对读取会推进 position,但不会改变已经记录的 mark。
buffer.get();
buffer.get();
// reset 只恢复游标位置,底层四个字节仍然保持原样。
buffer.reset();
byte value = buffer.get(); // 从 mark 对应的位置再次读取
这里的重点是“游标回退”,不是“内容回滚”。如果中间调用的是 put 并改写了底层字节,reset() 不会撤销这次写入;它只负责改变下一次相对读写从哪里开始。

在变长字段解析里用 mark 做一次回退
mark/reset 很适合“先看一眼,再决定是否消费”的局部解析。例如协议字段可能是短头部,也可能是扩展头部,先保存当前位置,读取足够的判断字节;如果发现这不是目标类型,就回到标记处交给另一个分支处理。
ByteBuffer input = ByteBuffer.wrap(new byte[] {0x2A, 0x01, 0x7F});
// 保存候选字段的起点;后续失败时仍从这里交给其他解析分支。
input.mark();
byte kind = input.get();
if (kind != 0x10) {
// 不匹配时只回退 position,不复制也不清空缓冲区内容。
input.reset();
}
// 当前分支只在确认类型后继续消费剩余字节。
if (input.hasRemaining()) {
byte first = input.get();
}
这种写法的边界是:mark 只属于当前 buffer 实例,而且只保存一个位置。再次调用 mark() 会覆盖旧标记。如果业务需要同时保存多个候选起点,单个 mark 不够,应显式保存 int position = input.position(),或者用多个 duplicate() 创建独立游标。
为什么 reset 有时会抛 InvalidMarkException
最直接的原因是当前 buffer 没有有效 mark:从未调用 mark(),或者标记已经被状态操作丢弃。官方 API 还明确说明,调用 position(newPosition) 时,如果新位置小于 mark,mark 会被丢弃;设置更小的 limit 也可能让 mark 失效。
另外几个常见操作也要特别小心:
| 操作 | 对 mark 的影响 | 排查重点 |
|---|---|---|
position(newPosition) | 新位置落在 mark 之前时丢弃 | 不要把它当作无条件回退 |
limit(newLimit) | 新上限落在 mark 之前时丢弃 | 缩小读取窗口后重新 mark |
clear/flip/rewind/compact | 会丢弃 mark | 这些是改变缓冲区工作状态的操作 |
reset() | 没有有效 mark 时抛 InvalidMarkException | 确认 mark 与 reset 属于同一个实例 |
ByteBuffer buffer = ByteBuffer.allocate(8);
// 这里先建立标记,reset 才有可恢复的位置。
buffer.position(4);
buffer.mark();
// 把 position 移到 mark 之前会让标记失效。
buffer.position(2);
try {
// 标记已失效,不能把 reset 当成历史快照恢复。
buffer.reset();
} catch (InvalidMarkException ex) {
// 生产代码应转入重新定位或放弃当前解析分支。
System.out.println("mark 已失效,需要重新定位");
}

我的取舍:短回退用 mark,多视角用 duplicate
对我来说,mark/reset 的优点是意图非常直白:在一段局部判断前打标记,失败后回到原点。它的代价也同样明确:只有一个 mark,并且依赖 buffer 的状态操作没有把标记清掉。只要代码中同时出现 clear、flip、compact 或跨层传递 buffer,就应把 mark 的生命周期写在注释里。
如果两个解析分支需要同时保留各自的 position、limit 和 mark,duplicate() 更合适。它们共享底层内容,但游标状态独立;这解决的是“多个读取视角”,不是 mark/reset 的回退问题。不要为了回退而复制整个字节数组,也不要把 reset 误当成事务回滚。
最后可以按这张清单判断:
- 只需要一个短暂回退点:用
mark()和reset()。 - 需要多个独立读取游标:用
duplicate()或显式保存 position。 - 需要撤销写入内容:mark/reset 不适用,应设计自己的数据副本或事务层。
相关问题
reset 会把 limit 一起恢复吗?
不会。reset 只把 position 恢复到 mark,limit、capacity 和底层内容都不会因此回到过去的状态。
mark 能不能跨 duplicate 使用?
不能把它理解成跨实例共享的标记。duplicate 共享内容,但每个 buffer 的 position、limit、mark 独立;应在实际要 reset 的那个实例上建立 mark。
Java 导出 CSV 时字段里的逗号和换行怎么正确转义
- 上一篇
- Java 导出 CSV 时字段里的逗号和换行怎么正确转义
- 下一篇
- Apache Commons CSV 怎么强制导出需要引号的字段
-
- 文章 · java教程 | 50秒前 | Java · IO · java close OutputStream DeflaterOutputStream finish
- Java DeflaterOutputStream.finish 怎样保留底层流继续写
- 142浏览 收藏
-
- 文章 · java教程 | 4分钟前 | 命令行工具 · 安全编程 · java Console System.console readPassword 命令行密码 交互终端
- Java System.console 为 null 时怎么处理密码输入
- 339浏览 收藏
-
- 文章 · java教程 | 5分钟前 |
- Java Condition.awaitNanos 返回值怎么判断是否超时
- 238浏览 收藏
-
- 文章 · java教程 | 9分钟前 | 性能边界 · java 并发集合 concurrenthashmap size mappingCount 映射数量
- Java ConcurrentHashMap mappingCount 什么时候比 size 更合适
- 112浏览 收藏
-
- 文章 · java教程 | 10分钟前 |
- Java Condition.signalAll 为什么必须在持锁时调用
- 477浏览 收藏
-
- 文章 · java教程 | 13分钟前 | 异步任务 · CompletableFuture · java 异步编程 错误恢复 completablefuture Complete obtrudeValue
- Java CompletableFuture obtrudeValue 怎样覆盖已完成结果
- 470浏览 收藏
-
- 文章 · java教程 | 20分钟前 | Java · csv · java Apache Commons CSV CSVPrinter QuoteMode CSVFormat
- Apache Commons CSV 怎么强制导出需要引号的字段
- 488浏览 收藏
-
- 文章 · java教程 | 29分钟前 | Java · unicode · java locale BreakIterator getCharacterInstance 用户可见字符 扩展字素簇
- Java BreakIterator 怎样按本地化规则拆分用户可见字符
- 297浏览 收藏
-
- 文章 · java教程 | 30分钟前 | Java · nio · java nio ByteBuffer flip compact
- Java ByteBuffer 读取不完整时怎样正确使用 flip 和 compact
- 363浏览 收藏
-
- 文章 · java教程 | 32分钟前 |
- Java Bidi 怎么让段落方向跟随首个强方向字符
- 123浏览 收藏
-
- 前端进阶之JavaScript设计模式
- 设计模式是开发人员在软件开发过程中面临一般问题时的解决方案,代表了最佳的实践。本课程的主打内容包括JS常见设计模式以及具体应用场景,打造一站式知识长龙服务,适合有JS基础的同学学习。
- 543次学习
-
- GO语言核心编程课程
- 本课程采用真实案例,全面具体可落地,从理论到实践,一步一步将GO核心编程技术、编程思想、底层实现融会贯通,使学习者贴近时代脉搏,做IT互联网时代的弄潮儿。
- 516次学习
-
- 简单聊聊mysql8与网络通信
- 如有问题加微信:Le-studyg;在课程中,我们将首先介绍MySQL8的新特性,包括性能优化、安全增强、新数据类型等,帮助学生快速熟悉MySQL8的最新功能。接着,我们将深入解析MySQL的网络通信机制,包括协议、连接管理、数据传输等,让
- 500次学习
-
- JavaScript正则表达式基础与实战
- 在任何一门编程语言中,正则表达式,都是一项重要的知识,它提供了高效的字符串匹配与捕获机制,可以极大的简化程序设计。
- 487次学习
-
- 从零制作响应式网站—Grid布局
- 本系列教程将展示从零制作一个假想的网络科技公司官网,分为导航,轮播,关于我们,成功案例,服务流程,团队介绍,数据部分,公司动态,底部信息等内容区块。网站整体采用CSSGrid布局,支持响应式,有流畅过渡和展现动画。
- 485次学习
-
- PubMedQA
- 深入了解PubMedQA生物医学问答数据集,涵盖其核心功能、使用方法及在临床决策、药物研发等场景的应用,助力提升NLP模型性能。
- 977次使用
-
- H2O EvalGPT
- H2O EvalGPT是H2O.ai推出的开源LLM评估平台,提供详细的大模型性能排行榜、行业特定基准测试及A/B测试功能,助您快速选择最适合项目的高性能大语言模型。
- 983次使用
-
- LMArena
- LMArena是加州大学伯克利分校推出的AI模型匿名评测平台。通过盲测投票机制,用户可对比不同大模型回答并生成实时排行榜,助力开发者优化模型及用户选择最佳AI工具。
- 1098次使用
-
- HELM
- 深入了解斯坦福推出的HELM(Holistic Evaluation of Language Models)大模型评测体系。本文解析其核心功能、安装配置步骤及应用场景,涵盖准确性、公平性、鲁棒性等多维度指标,助力开发者全面优化语言模型性能。
- 1070次使用
-
- MMBench
- MMBench是由上海人工智能实验室等机构联合推出的多模态基准测试平台,提供细粒度能力评估、大规模数据集及VLMEvalKit工具。本文详细介绍其核心功能、安装使用方法及应用场景,助力开发者全面评估多模态模型性能。
- 908次使用
-
- Golang解析yaml文件操作指南
- 2022-12-26 131浏览
-
- golang生成JSON以及解析JSON
- 2023-01-17 329浏览
-
- Go Java 算法之字符串解码示例详解
- 2023-01-07 479浏览
-
- Go Java算法之单词搜索示例详解
- 2022-12-30 337浏览
-
- Gojava算法之括号生成示例详解
- 2023-02-22 128浏览
