本节介绍从版本 4.3.x 到 4.4.x 的重大更改，以及如何将已删除的功能替换为新引入的功能。Spring中文文档

弃用

org.springframework.data.elasticsearch.core.ReactiveElasticsearchOperations

该方法已弃用。 由于现在有多个使用不同客户端库的实现，因此该方法在不同的实现中仍然可用，但接口中没有更多方法，因为不同客户端没有通用的回调接口。<T> Publisher<T> execute(ClientCallback<Publisher<T>> callback)executeSpring中文文档

重大变更

删除已弃用的类

org.springframework.data.elasticsearch.core.ElasticsearchTemplate已被删除

从 4.4 版开始，Spring Data Elasticsearch 不再使用 Elasticsearch（自 Elasticsearch 7.0 起已弃用）。 这意味着自 Spring Data Elasticsearch 4.0 以来已弃用的类已被删除。 这是使用 . 必须使用命令式或反应式 .TransportClientorg.springframework.data.elasticsearch.core.ElasticsearchTemplateElasticsearchOperationsTransportClientElasticsearchRestTemplateReactiveElasticsearchTemplateSpring中文文档

软件包更改

在 4.3 中，两个类（ 和 ）被移到了软件包中，为集成新的 Elasticsearch 客户端做准备。 这些被移回了包中，因为我们保留了这些类使用它们所在的旧 Elasticsearch 客户端。ElasticsearchAggregationsElasticsearchAggregationorg.springframework.data.elasticsearch.core.clients.elasticsearch7org.springframework.data.elasticsearch.coreSpring中文文档

行为改变

直接创建或由 Spring Boot 配置创建时，默认刷新策略为 IMMEDIATE。 这可能会导致繁重索引的性能问题，并且与 Elasticsearch 的默认行为不同。 这已更改为现在默认刷新策略为 NONE。 当使用反应式 REST 客户端中所述的配置提供时，默认刷新策略已设置为 NONE。ReactiveElasticsearchTemplateReactiveElasticsearchTemplateSpring中文文档

新 Elasticsearch 客户端

Elasticsearch 引入了它的新功能，并弃用了以前的 . Spring Data Elasticsearch 4.4 仍然使用旧客户端作为默认客户端，原因如下：ElasticsearchClientRestHighLevelClientSpring中文文档

  • 新客户端强制应用程序使用该包，而 Spring Boot 将坚持到版本 3。因此，在Spring Data Elasticsearch中切换默认实现只能与Spring Data Elasticsearch 5（Spring Data 3，Spring 6）一起提供。jakarta.json.spi.JsonProviderjavax.json.spi.JsonProviderSpring中文文档

  • Elasticsearch 客户端中仍有一些 bug 需要解决Spring中文文档

  • 由于资源有限，在 Spring Data Elasticsearch 中使用新客户端的实现尚未完成 - 请记住，Spring Data Elasticsearch 是一个社区驱动的项目，它以公共贡献为生。Spring中文文档

如何使用新客户端

使用新客户端的实现尚未完成，某些操作会抛出或可能抛出 NPE（例如，当 Elasticsearch 无法解析来自服务器的响应时，有时仍然会发生这种情况）
使用新客户端测试实现，但不要在生产代码中使用它！java.lang.UnsupportedOperationException

为了尝试使用新客户端，必须执行以下步骤：Spring中文文档

请确保不配置现有的默认客户端

如果使用 Spring Boot，请从自动配置中排除 Spring Data ElasticsearchSpring中文文档

@SpringBootApplication(exclude = ElasticsearchDataAutoConfiguration.class)
public class SpringdataElasticTestApplication {
	// ...
}

从应用程序配置中删除 Spring Data Elasticsearch 相关属性。 如果 Spring Data Elasticsearch 是使用编程配置配置的（请参阅 Elasticsearch 客户端），请从 Spring 应用程序上下文中删除这些 Bean。Spring中文文档

添加依赖项

新 Elasticsearch 客户端的依赖项在 Spring Data Elasticsearch 中仍然是可选的，因此需要显式添加它们：Spring中文文档

<dependencies>
    <dependency>
        <groupId>co.elastic.clients</groupId>
        <artifactId>elasticsearch-java</artifactId>
        <version>7.17.3</version>
        <exclusions>
            <exclusion>
                <groupId>commons-logging</groupId>
                <artifactId>commons-logging</artifactId>
            </exclusion>
        </exclusions>
    </dependency>
    <dependency>
        <groupId>org.elasticsearch.client</groupId>
        <artifactId>elasticsearch-rest-client</artifactId> <!-- is Apache 2-->
        <version>7.17.3</version>
        <exclusions>
            <exclusion>
                <groupId>commons-logging</groupId>
                <artifactId>commons-logging</artifactId>
            </exclusion>
        </exclusions>
    </dependency>
</dependencies>

使用 Spring Boot 时，需要在pom.xml中设置以下属性。Spring中文文档

<properties>
    <jakarta-json.version>2.0.1</jakarta-json.version>
</properties>

新的配置类

命令式风格

为了配置Spring Data Elasticsearch以使用新客户端，必须创建一个配置Bean，该bean派生自：org.springframework.data.elasticsearch.client.elc.ElasticsearchConfigurationSpring中文文档

@Configuration
public class NewRestClientConfig extends ElasticsearchConfiguration {

	@Override
	public ClientConfiguration clientConfiguration() {
		return ClientConfiguration.builder() //
			.connectedTo("localhost:9200") //
			.build();
	}
}

配置的完成方式与旧客户机相同，但不再需要创建比配置 Bean 更多的数据。 使用此配置，以下 Bean 将在 Spring 应用程序上下文中可用：Spring中文文档

  • 一个 bean，即 Elasticsearch 客户端使用的配置低级别RestClientRestClientSpring中文文档

  • 一个 bean，这是使用ElasticsearchClientRestClientSpring中文文档

  • 一个 bean，提供 bean 名称 elasticsearchOperations 和 elasticsearchTemplate，它使用ElasticsearchOperationsElasticsearchClientSpring中文文档

反应式

要在响应式环境中使用新客户端，唯一的区别是要从中派生配置的类：Spring中文文档

@Configuration
public class NewRestClientConfig extends ReactiveElasticsearchConfiguration {

	@Override
	public ClientConfiguration clientConfiguration() {
		return ClientConfiguration.builder() //
			.connectedTo("localhost:9200") //
			.build();
	}
}

使用此配置，以下 Bean 将在 Spring 应用程序上下文中可用：Spring中文文档

  • 一个 bean，即 Elasticsearch 客户端使用的配置低级别RestClientRestClientSpring中文文档

  • 一个 bean，这是使用ReactiveElasticsearchClientRestClientSpring中文文档

  • 一个 bean，提供 bean 名称 reactiveElasticsearchOperations 和 reactiveElasticsearchTemplate，它使用ReactiveElasticsearchOperationsReactiveElasticsearchClientSpring中文文档

使用新客户端的实现尚未完成，某些操作会抛出或可能抛出 NPE（例如，当 Elasticsearch 无法解析来自服务器的响应时，有时仍然会发生这种情况）
使用新客户端测试实现，但不要在生产代码中使用它！java.lang.UnsupportedOperationException