【lucene】SegmentCoreReaders

`SegmentCoreReaders` 是 Lucene 内部的一个包级可见(package-private)工具类,位于

`org.apache.lucene.index` 包中。它的唯一职责是 一次性打开某个 segment 最核心、最常用的只读读柄(reader),然后把它们缓存起来供 `SegmentReader` 反复使用,避免重复打开文件句柄和重复解码元数据。


✅ 存在目的

任务 说明

一次性打开底层文件 把 segment 中最常用的格式(postings、stored fields、doc values、term vectors ...)对应的 Reader 全部打开并保存。

避免重复 IO / 解码 这些 Reader 创建代价高(涉及文件头解析、内存映射、解压字典等),因此缓存起来可以极大提升查询效率。

供 SegmentReader 使用 `SegmentReader` 的所有公开查询 API(`terms()`, `storedFields()`, `getNumericDocValues(...)` 等)最终都委托给 `SegmentCoreReaders` 里保存的实例。


✅ 内部保存的核心 Reader

变量名 对应格式 文件名示例

`fields` `FieldsProducer`(倒排索引) `.tim`, `.tip`, `.doc`, `.pos`, `.pay`

`storedFieldsReader` `StoredFieldsReader` `.fdx`, `.fdt`

`termVectorsReader` `TermVectorsReader` `.tvx`, `.tvd`, `.tvf`

`normsProducer` `NormsProducer` `.nvd`, `.nvm`

`docValuesProducer` `DocValuesProducer` `.dvd`, `.dvm`

`pointsReader` `PointsReader` `.dii`, `.dim`

`knnVectorsReader` `KnnVectorsReader` (>=8.0) `.vec`, `.veq`, `.vex`


✅ 生命周期

  1. 创建

在 `SegmentReader` 构造函数里通过

```java

core = new SegmentCoreReaders(...);

```

一次性打开所有文件句柄。

  1. 使用

`SegmentReader` 的所有公开方法(如 `storedFields()`, `getTermVector(...)`, `getNumericDocValues(...)`)都直接返回 `core` 中缓存的实例。

  1. 关闭

当 `SegmentReader.close()` 被调用时,会统一关闭 `SegmentCoreReaders` 中保存的所有底层 Reader,释放文件句柄和内存。


✅ 与外部 API 的关系

外部 API 内部实现

`IndexReader.leafContexts()` → `LeafReader` 每个 `LeafReader` 就是 `SegmentReader`,其背后用 `SegmentCoreReaders`。

`StoredFields#document(docID)` 最终调用 `core.storedFieldsReader.document(...)`

`Terms terms(String field)` 最终调用 `core.fields.terms(field)`

`NumericDocValues getNumericDocValues(String field)` 最终调用 `core.docValuesProducer.getNumeric(field)`


✅ 总结一句话

> `SegmentCoreReaders` 是 Lucene 内部的一个"只读核心 Reader 缓存器",它一次性打开 segment 中所有底层格式文件,供 `SegmentReader` 高效复用,屏蔽了复杂且昂贵的底层 IO 细节。

相关推荐
与火星的孩子对话3 天前
Unity高级开发:反射原理深入解析与实践指南 C#
java·unity·c#·游戏引擎·lucene·反射
risc1234569 天前
【lucene】文档id docid
lucene
risc1234569 天前
【lucene】lucene索引文件的读取器都是单向的只能向前不能后退读
lucene
chenglin01612 天前
ClickHouse、Doris、OpenSearch、Splunk、Solr系统化分析
clickhouse·solr·lucene
Freed&18 天前
倒排索引:Elasticsearch 搜索背后的底层原理
大数据·elasticsearch·搜索引擎·lucene
risc12345618 天前
【lucene】ByteBufferGuard
lucene
risc12345620 天前
【lucene】使用docvalues的案例
lucene
risc12345620 天前
【lucene】currentFrame与staticFrame
lucene
risc12345621 天前
【lucene】IndexOptions
全文检索·lucene