Hibernate Search

7.0 系列 有限支持

JDK 11 作为基线,切换到 Jakarta EE,与 ORM 6.4 兼容(无需 -orm6 工件),与 Elasticsearch 8.10/8.11/8.12 和 OpenSearch 2.9/2.10/2.11 兼容,升级到 Lucene 9(在 Lucene 后端),发布 Hibernate Search BOM,实验性兼容 Amazon OpenSearch Serverless,放弃对已停止支持的 Elasticsearch 版本 5.x、6.x、7.0-7.9 和 OpenSearch 版本 1.0-1.2 的兼容性,其他错误修复和改进

Hibernate Search 7.0 处于有限支持模式

  • 版本发布可能延迟,直到出现重大需求;

  • 只有在错误被认为足够重大或在付费支持的范围内才会修复错误;

  • 针对此版本的拉取请求可能会被拒绝,因为这些错误未被认为是严重错误;

  • 使用此版本的错误重现将被降低优先级。

我们建议您尽可能升级到较新的系列,或者寻求 付费支持

另请参阅 维护策略

兼容性

Java 11、17 或 21
Hibernate ORM 6.4
Elasticsearch 服务器 7.10 - 8.12
OpenSearch 服务器 1.3 - 2.11
Apache Lucene 9.8

不符合您的要求?请查看 其他系列。

另请参阅 兼容性策略维护策略

文档

可以通过以下链接访问 Hibernate Search 7.0 的文档

HTML PDF API (JavaDoc)

您可以在 文档页面 上找到所有系列的更多文档。

如何获取

Hibernate Search 7.0 处于有限维护模式:我们建议您尽可能升级到更新的系列,或寻求 付费支持

另请参阅 维护策略

Maven、Gradle...

Hibernate Search 的 Maven 工件发布到 Maven 中央仓库。大多数构建工具默认从 Maven 中央仓库获取工件,但如果您的情况并非如此,请查看 此页面 以配置您的构建工具。

您可以通过以下链接找到所有工件的 Maven 坐标。

Maven 工件

以下是主要工件的 Maven 坐标。

org.hibernate.search:hibernate-search-bom:7.0.1.Final
Hibernate Search BOM
org.hibernate.search:hibernate-search-mapper-orm:7.0.1.Final
Hibernate ORM 映射器
org.hibernate.search:hibernate-search-mapper-orm-outbox-polling:7.0.1.Final
Hibernate ORM 映射器的“outbox-polling”协调策略
org.hibernate.search:hibernate-search-mapper-pojo-standalone:7.0.1.Final
独立 POJO 映射器
org.hibernate.search:hibernate-search-backend-lucene:7.0.1.Final
Lucene 后端
org.hibernate.search:hibernate-search-backend-elasticsearch:7.0.1.Final
Elasticsearch/OpenSearch 后端
org.hibernate.search:hibernate-search-backend-elasticsearch-aws:7.0.1.Final
Amazon IAM 身份验证,适用于 Elasticsearch/OpenSearch
org.hibernate.search:hibernate-search-mapper-orm-jakarta-batch-core:7.0.1.Final
Jakarta Batch 批量索引作业,适用于 Hibernate ORM 映射器 - 核心
org.hibernate.search:hibernate-search-mapper-orm-jakarta-batch-jberet:7.0.1.Final
Jakarta Batch 批量索引作业,适用于 Hibernate ORM 映射器 - JBeret 特定内容
org.hibernate.search:hibernate-search-v5migrationhelper-orm:7.0.1.Final
用于从 Hibernate Search 5 迁移到 Hibernate Search 6/7 的助手(Hibernate ORM 映射器 + Lucene 后端)

2022-01-26 之后发布的该项目的所有 Maven 工件都已签名。

要验证签名的 Maven 工件,请前往 此页面

直接下载

包含所有 JAR 文件、文档和源代码的 ZIP 存档可从 SourceForge 获取

下载 ZIP 存档

可以从 Maven 仓库直接下载单个 Maven 工件

Maven 中央仓库子目录

查看 这里,了解如何将 Maven 项目的所有依赖项下载到文件系统上的本地目录。

查看 这里,了解如何将显式列出的工件集下载到文件系统上的本地目录。

有关特定版本的更多信息(公告、下载链接),请查看 这里

入门

Hibernate Search 7.0 处于有限维护模式:我们建议您尽可能升级到更新的系列,或寻求 付费支持

另请参阅 维护策略

如果您想开始使用 Hibernate Search 7.0,请参考入门指南

HTML PDF

迁移

如果您需要从之前的系列升级,请参考迁移指南

HTML PDF

新特性

最新版本发布公告(2024-04-10): 7.0.1.Final

有关本系列中新增功能、改进和修复的详细列表,请查看 我们的问题跟踪器

依赖项升级

Java

Hibernate Search 现在使用 JDK 11 作为基线,可以在 JDK 11、17 或 21 上运行。已放弃对 JDK 8 的兼容性。

Hibernate ORM

Hibernate Search 现在依赖于 Hibernate ORM 6.4,因为它已完全切换到 Jakarta EE。不再存在 -orm6/-jakarta 工件或 Java EE 兼容性。

Lucene

Lucene 后端现在使用 Lucene 9.8。升级需要重新索引,有关详细信息,请参阅迁移指南。

Elasticsearch

Elasticsearch 后端适用于 Elasticsearch 8.10/8.11/8.12,以及其他已兼容的版本(除了以下版本,由于它们已到达生命周期终结,因此已放弃对它们的兼容性)

  • 5.x/6.x

  • 7.0-7.9

OpenSearch

Elasticsearch 后端适用于 OpenSearch 2.10 和 2.11,以及其他已兼容的版本(除了版本 1.0、1.1 和 1.2,由于它们已到达生命周期终结,因此已放弃对它们的兼容性)。

Hibernate Search BOM

Hibernate Search 现在提供 BOM,为所有已发布的工件提供依赖项管理。可以将其作为依赖项管理的一部分导入,以保持 Hibernate Search 工件的版本一致

<dependencyManagement>
    <dependencies>
        <!-- Import Hibernate Search BOM to get all of its artifact versions aligned: -->
        <dependency>
            <groupId>org.hibernate.search</groupId>
            <artifactId>hibernate-search-bom</artifactId>
            <version>7.0.1.Final</version>
            <type>pom</type>
            <scope>import</scope>
        </dependency>
        <!-- Any other dependency management entries -->
    </dependencies>
</dependencyManagement>
<!-- ... -->
<dependencies>
    <!-- Declare dependencies -->
    <dependency>
        <groupId>org.hibernate.search</groupId>
        <artifactId>hibernate-search-mapper-orm</artifactId>
        <!-- The version is managed by the BOM above -->
    </dependency>
    <dependency>
        <groupId>org.hibernate.search</groupId>
        <artifactId>hibernate-search-backend-elasticsearch</artifactId>
        <!-- The version is managed by the BOM above -->
    </dependency>
    <!-- Any other dependency entries -->
</dependencies>

Amazon OpenSearch Serverless 实验性兼容性

Hibernate Search 现在与 Amazon OpenSearch Serverless 具有孵化兼容性。

与常规 OpenSearch 集群相比,Amazon OpenSearch Serverless 存在一些限制,并且 可能不支持常规集群支持的所有操作。必须通过设置后端版本属性明确启用对 Amazon OpenSearch Serverless 的兼容性

hibernate.search.backend.version=amazon-opensearch-serverless

查看 参考文档的本节,以获取更多信息,尤其是有关限制的信息。

与 Hibernate ORM 的基于区分符的多租户兼容性

Hibernate Search 现在可以索引利用 数据库中基于区分符的多租户(@TenandId 的 Hibernate ORM 实体。

Maven 工件重命名

一些 Hibernate Search Maven 工件已重命名

  • 与 JSR-352 工件相关的 Maven 工件已重命名,以反映迁移到 Jakarta EE 规范。

    • hibernate-search-mapper-orm-batch-jsr352-core 已重命名为 hibernate-search-mapper-orm-jakarta-batch-core

    • hibernate-search-mapper-orm-batch-jsr352-jberet 已重命名为 hibernate-search-mapper-orm-jakarta-batch-jberet

  • 工件 hibernate-search-mapper-orm-coordination-outbox-polling 已重命名为 hibernate-search-mapper-orm-outbox-polling

开发版本(快照)

Hibernate Search 的 Maven 工件的最新开发版本发布到 OSSRH 快照 仓库。

OSSRH 快照子目录

您只需要这些(不稳定)版本来测试最近合并的补丁,并且决不应该在生产中使用它们。

要使用这些工件,您可能需要配置构建工具以从 https://oss.sonatype.org/content/repositories/snapshots 获取工件,并启用快照

Maven Gradle

此系列中的版本

Hibernate Search 7.0 处于有限维护模式:我们建议您尽可能升级到更新的系列,或寻求 付费支持

另请参阅 维护策略

7.0.1.Final

2024-04-10

LGPL v2.1

与 Elasticsearch 8.12 的兼容性,一些修复和文档更新。

如何获取它 入门

Maven 工件 下载 已解决的问题 版本发布公告

7.0.0.Final

2023-12-05

LGPL v2.1

一个错误修复;否则与 7.0.0.CR2 相同。

Maven 工件 下载 已解决的问题 版本发布公告

7.0.0.CR2

2023-11-24

LGPL v2.1

与 Elasticsearch 8.11 的兼容性,升级到 Hibernate ORM 6.4.0.Final,其他错误修复和改进

Maven 工件 下载 已解决的问题 版本发布公告

7.0.0.CR1

2023-10-23

LGPL v2.1

与 Hibernate ORM 的基于区分符的多租户的兼容性,与 Elasticsearch 8.10 和 OpenSearch 2.9/2.10/2.11 的兼容性,已放弃对已到达生命周期终结的 Elasticsearch 版本 7.0-7.9 和 OpenSearch 版本 1.0-1.2 的兼容性,升级到 Hibernate ORM 6.3.1.Final,升级到 Lucene 9.8,一些 Maven 工件重命名,其他错误修复和改进

Maven 工件 下载 已解决的问题 版本发布公告

7.0.0.Beta1

2023-09-05

LGPL v2.1

JDK 11 作为基线,切换到 Jakarta EE,与 ORM 6.3 的兼容性,无需 -orm6 工件,升级到 Lucene 后端的 Lucene 9,已发布 Hibernate Search BOM,与 Amazon OpenSearch Serverless 的实验性兼容性,已放弃对已到达生命周期终结的 Elasticsearch 版本 5.x - 6.x 的兼容性,其他错误修复和改进

Maven 工件 下载 已解决的问题 版本发布公告

返回顶部