登录
推荐 文章 Go 技术 课程 下载 专题 AI
首页 >  文章 >  java教程

Java ByteBuffer mark 和 reset 怎样回到已标记位置

来源:17golang原创

时间:2026-11-11 07:20:10 487浏览 收藏

我第一次在 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() 不会撤销这次写入;它只负责改变下一次相对读写从哪里开始。

ByteBuffer、position、limit、mark、mark() 和 reset() 的静态关系说明图
图1:ByteBuffer 状态说明图,展示 mark 记录 position、reset 恢复 position 的关系,不是运行截图。

在变长字段解析里用 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 已失效,需要重新定位");
}
ByteBuffer position、limit、clear、flip、rewind、compact 与 mark 失效边界说明图
图2: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。

声明:本文转载于:17golang原创 如有侵犯,请联系study_golang@163.com删除
相关阅读
更多>
最新阅读
更多>
课程推荐
更多>