第 7 章 Hibernate Search

Hibernate 搜索为 Hibernate 应用程序提供全文本搜索功能。尤其适合搜索基于 SQL 的解决方案不适合的应用程序，包括全文本、模糊搜索和地理位置搜索。Hibernate Search 使用 Apache Lucene 作为其全文本搜索引擎，但旨在最大限度地降低维护开销。配置后，索引、群集和数据同步将保持透明，让您专注于满足您的业务需求。

Hibernate 搜索由索引组件和索引搜索组件组成，它们都由 Apache Lucene 支持。每次从数据库插入、更新或删除实体时，Hibernate Search 都会通过 Hibernate 事件系统跟踪此事件并计划索引更新。所有这些更新都会被处理，而无需直接与 Apache Lucene API 交互。相反，与底层 Lucene 索引的交互是通过索引 管理器 来处理的。默认情况下，IndexManager 和 Lucene 索引之间有一个一对一的关系。IndexManager 会提取特定的索引配置，包括所选后端、readread 策略和 DirectoryProvider。

索引创建后，您可以搜索实体并返回受管实体列表，而不是处理底层 Lucene 基础架构。Hibernate 和 Hibernate 搜索之间共享相同的持久性上下文。FullTextSession 类构建在 Hibernate 会话 类之上，以便应用程序代码可以使用统一 org.hibernate.Query 或 javax.persistence.Query API，其方式与 HQL、Java Persistence 查询语言(JPQL)或原生查询相同。

建议在所有操作中使用事务性批处理模式，无论它们是基于 Java 命名和目录接口。

Apache Lucene 是 Hibernate Search 基础架构的一部分，拥有用于存储索引的目录的概念。Hibernate Search 通过目录提供程序处理 Lucene Directory 实例的初始化和配置。

directory_provider 属性指定用于存储索引的目录提供程序。默认文件系统目录提供商是 filesystem，它使用本地文件系统来存储索引。

Lucene 索引的更新由 Hibernate Search Worker 处理，它接收所有实体更改，按照上下文对其进行队列，并在上下文结束时应用它们。最常见的上下文是事务，但可能取决于实体更改的数量或其他一些应用事件。

为提高效率，交互分批，一般在上下文结束时应用。在事务之外，索引更新操作会在实际数据库操作后执行。如果是持续事务，则为事务提交阶段调度索引更新操作，并在交易回滚时丢弃。工作程序可以配置特定的批处理大小限制，之后无论上下文如何进行索引。

这种处理索引更新的方法有两大好处：

两种批处理模式（无范围与事务）等同于 autocommit 与事务性行为。从性能角度看，建议使用事务模式。范围选择是透明的。Hibernate Search 可检测是否存在交易并调整范围范围。

在执行查询时，Hibernate Search 使用 reader 策略与 Apache Lucene 索引交互。根据应用的配置集选择一个 reader 策略，如频繁更新、阅读主要异步索引更新。