【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` 才是随遍历或二分不断切换的“工作节点”。