【lucene】currentFrame与staticFrame

`currentFrame` 是 `SegmentTermsEnum`（`TermsEnum` 的一个具体实现）里 "当前正在扫描的那个 block" 的 状态容器。

它对应的类型是 `SegmentTermsEnumFrame`，可以理解为 "在 BlockTree 字典里的一层节点解析器"。

---

✅ 一句话解释

`currentFrame` 负责 把 `.tim` 文件里的一个压缩 block 解包到内存，然后提供 在该 block 里顺序/二分查找 term 的能力，并且在找到目标 term 后，把指向 `.doc/.pos/.pay` 的指针解析出来。

---

✅ 主要职能拆成 4 步

步骤 方法 说明

1 `loadBlock()` 根据 `.tip` 给出的文件指针，把 `.tim` 文件里对应的 block 读进来并解压，得到 term 列表、统计信息、倒排指针等。

2 `scanToTerm(target)` 在上一步加载的 block 里 顺序或二分查找 是否包含目标 term，返回 FOUND / NOT_FOUND / END。

3 `decodeMetaData()` 找到 term 后，把 docFreq、docFP、posFP、payFP、skipFP 等指针解析成 `TermState`，供 `postings()` 使用。

4 `next()` / `nextLeaf()` 如果没命中或需要遍历，继续在同一个 block 里 顺序跳到下一个 term；block 用完就 弹栈 / 进栈 新的 `currentFrame`。

---

✅ 形象比喻

• 把 BlockTree 看成 一本多级目录的词典，`.tip` 是 目录页，`.tim` 是 词条页。

• `SegmentTermsEnum` 就像 翻书的人。

• `currentFrame` 就是 他手里当前摊开的这一页，上面记录着：

• 这一页的范围（prefix）

• 这一页里有多少词条（后缀数组）

• 每个词条的详细解释在哪一页（倒排指针）

只有 `currentFrame` 把这一页 真正摊开（loadBlock），后面的 `nextDoc()` 才能根据页码去 `.doc/.pos/.pay` 里拿 文档列表。

`staticFrame` 是 `SegmentTermsEnum` 里的一个 "永远指向 BlockTree 根节点"的只读 Frame，

它跟 `currentFrame` 不同：

• 只读：`staticFrame` 本身不随扫描过程移动，它永远保存整棵字典的根 block的元数据。

• 作用：

1. 在 `seekExact()/seekCeil()` 之前，先把 `currentFrame = staticFrame` 复位，表示"回到根节点，重新开始"。

2. 提供根节点的前缀长度、后缀起始地址等常量，供后面 push 新帧时计算偏移量。

3. 避免每次 new 一个空 Frame，省一次对象分配。

一句话：

`staticFrame` 是 SegmentTermsEnum 的"树根锚点"，用来快速回到字典起点，而 `currentFrame` 才是随遍历或二分不断切换的"工作节点"。