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

相关推荐
music score2 天前
google 的C++自动化测试框架详解(Google Test)(2)
c++·qt·lucene
risc1234562 天前
【lucene】Scorer 和 BulkScorer的区别?
lucene
星河耀银海4 天前
Unity C#入门:变量的定义与访问权限(public/private)
unity·c#·lucene
risc1234564 天前
Elasticsearch的shrink为啥不用软链接用硬链接
elasticsearch·lucene
risc1234568 天前
lucene包文件功能概述
lucene
risc12345612 天前
【lucene】PostingsEnum跟TermsEnum 的区别是啥?
java·lucene
risc12345613 天前
SegmentTermsEnum#postings 和 IntersectTermsEnum#postings
算法·lucene
星辰徐哥15 天前
Unity基础:游戏对象的激活与隐藏:SetActive方法详解
游戏·unity·lucene
星辰徐哥15 天前
Unity C#入门:变量的定义与访问权限(public/private)
unity·c#·lucene
risc12345617 天前
writeBlocks
lucene