【lucene】HitsThresholdChecker命中阈值检测器
`HitsThresholdChecker`，它是一个抽象类，用于定义允许搜索提前终止的自定义算法。以下是代码的详细解释：
### 1. **类的结构**
- **包名**：`org.apache.lucene.search`
- 这表明该类属于 Apache Lucene 的搜索模块。
- **导入**：`java.util.concurrent.atomic.AtomicLong`
- 用于线程安全地操作长整型变量。
### 2. **静态内部类**
#### **GlobalHitsThresholdChecker**
- **功能**：实现全局命中计数的 `HitsThresholdChecker`。
- **成员变量**：
- `totalHitsThreshold`：设置的命中阈值。
- `globalHitCount`：一个线程安全的长整型变量，用于记录全局命中的次数。
- **构造函数**：
- 检查 `totalHitsThreshold` 是否小于 0，如果是，则抛出 `IllegalArgumentException`。
- **方法**：
- `incrementHitCount()`：增加全局命中计数。
- `isThresholdReached()`：检查是否达到命中阈值。
- `scoreMode()`：根据 `totalHitsThreshold` 的值返回 `ScoreMode`，如果阈值为 `Integer.MAX_VALUE`，则返回 `ScoreMode.COMPLETE`，否则返回 `ScoreMode.TOP_SCORES`。
- `getHitsThreshold()`：返回当前的命中阈值。
#### **LocalHitsThresholdChecker**
- **功能**：实现单线程执行的 `HitsThresholdChecker`。
- **成员变量**：
- `totalHitsThreshold`：设置的命中阈值。
- `hitCount`：记录当前线程的命中次数。
- **构造函数**：
- 检查 `totalHitsThreshold` 是否小于 0，如果是，则抛出 `IllegalArgumentException`。
- **方法**：
- `incrementHitCount()`：增加当前线程的命中计数。
- `isThresholdReached()`：检查是否达到命中阈值。
- `scoreMode()`：根据 `totalHitsThreshold` 的值返回 `ScoreMode`，逻辑与 `GlobalHitsThresholdChecker` 相同。
- `getHitsThreshold()`：返回当前的命中阈值。
### 3. **静态方法**
- **`create(final int totalHitsThreshold)`**：
- 返回一个适用于单线程搜索的 `HitsThresholdChecker` 实例，即 `LocalHitsThresholdChecker`。
- **`createShared(final int totalHitsThreshold)`**：
- 返回一个基于共享计数器的 `HitsThresholdChecker` 实例，即 `GlobalHitsThresholdChecker`。
### 4. **抽象方法**
- **`incrementHitCount()`**：
- 增加命中计数。
- **`scoreMode()`**：
- 返回当前的评分模式。
- **`getHitsThreshold()`**：
- 返回当前的命中阈值。
- **`isThresholdReached()`**：
- 检查是否达到命中阈值。
### 5. **用途**
- 该类用于在搜索过程中动态检查是否达到某个命中阈值。如果达到阈值，可以提前终止搜索，节省资源。
- **多线程场景**：使用 `GlobalHitsThresholdChecker`，通过共享计数器实现全局监控。
- **单线程场景**：使用 `LocalHitsThresholdChecker`，仅监控当前线程的命中情况。