【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(...);

   ```

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

2. 使用

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

 

3. 关闭

 

   当 `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 细节。