java nio buffer 是由 capacity、position、limit、mark 四个索引协同控制的“智能卷尺”:capacity 永久固定为底层数组长度;position 与 limit 构成动态读写窗口,满足 0 ≤ position ≤ limit ≤ capacity;mark 是 position 的快照,初始为 -1,reset() 仅在其有效时生效。

Java NIO 中的 Buffer(如 ByteBuffer)不是普通容器,而是一套带状态机的“智能卷尺”。它的行为完全由四个整型索引控制:capacity、position、limit、mark。理解它们不是背定义,而是看清它们如何协同推进读写流程。
capacity:缓冲区的“物理上限”
它代表底层数组的长度,创建后**永久固定**,不可增减。无论你写入多少、读了多少、调用多少次 clear() 或 flip(),capacity 都不会变。
- 例如
ByteBuffer.allocate(1024)→capacity == 1024始终成立 - 它是所有其他索引的“天花板”,
limit和position永远不能超过它 - 不参与读写逻辑判断,只提供安全边界
position 与 limit:读写操作的“动态窗口”
position 是当前游标,limit 是当前窗口终点——二者共同框定“此刻能操作哪一段”。它们的值随模式切换剧烈变化,但始终满足 0 ≤ position ≤ limit ≤ capacity。
-
写模式下:
limit == capacity,position从 0 开始递增,每put()一次就 +1;当position == limit,缓冲区写满 -
读模式下:
limit被设为之前写入的末尾位置(即flip()后的limit = 原position),position归零;此后每次get(),position增加,直到等于limit就读完 -
remaining() == limit - position,这个差值就是当前剩余可读/可写数量,非常实用
mark:带约束的“临时书签”
mark 不是独立变量,而是 position 的快照副本。调用 mark() 时,mark 被赋值为**此刻的 position 值**;之后 position 可以前进,但 mark 不会自动更新。
-
mark初始为-1(未设置),只有显式调用mark()才生效 -
reset()仅在mark != -1且mark ≤ position时成功;否则抛InvalidMarkException - 任何修改
position或limit的操作(如position(n)、limit(n)、flip()、rewind()、clear())只要导致新值 mark,就会自动将mark设为-1(丢弃标记)
典型状态转换中的联动规律
一次完整写→读→重读流程,四者数值严格按规则跳变:
-
刚分配:
capacity=1024, limit=1024, position=0, mark=-1 -
写入 5 字节后:
capacity=1024, limit=1024, position=5, mark=-1(或某处,如 mark=2) -
flip() 后(准备读):
capacity=1024, limit=5, position=0, mark=-1(强制清除) -
读取 3 字节后:
capacity=1024, limit=5, position=3, mark=-1 -
rewind() 后(重头读):
capacity=1024, limit=5, position=0, mark=-1 -
clear() 后(清空复用):
capacity=1024, limit=1024, position=0, mark=-1
所有操作都服务于一个目标:让 position 在 [0, limit) 区间内安全移动,而 limit 的值由业务意图(写完?读到哪?)决定,capacity 和 mark 分别提供硬边界和回退锚点。










