从 4.3.x 升级到 4.4.x

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

弃用

org.springframework.data.elasticsearch.core.ReactiveElasticsearchOperations

该方法已弃用。由于现在有多个 implementations 使用不同的 client 库，因此该方法在不同的 implementations 中仍然可用，但是接口中没有更多方法，因为不同的 clients 没有通用的回调接口。<T> Publisher<T> execute(ClientCallback<Publisher<T>> callback)executespring-doc.cn

重大更改

删除已弃用的类

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

从版本 4.4 开始， Spring Data Elasticsearch 不再使用 from Elasticsearch（自 Elasticsearch 7.0 起已弃用）。这意味着自 Spring Data Elasticsearch 4.0 以来弃用的类已被删除。这是使用 . 必须使用 imperative 或 reactive 建立与 Elasticsearch 的连接。TransportClientorg.springframework.data.elasticsearch.core.ElasticsearchTemplateElasticsearchOperationsTransportClientElasticsearchRestTemplateReactiveElasticsearchTemplatespring-doc.cn

套餐更改

在 4.3 中，两个类（和）已移至软件包中，以便为集成新的 Elasticsearch 客户端做准备。这些被移回了包中，因为我们保持类在原来的位置使用旧的 Elasticsearch 客户端。ElasticsearchAggregationsElasticsearchAggregationorg.springframework.data.elasticsearch.core.clients.elasticsearch7org.springframework.data.elasticsearch.corespring-doc.cn

行为改变

当直接创建或通过 Spring Boot 配置创建时，具有 IMMEDIATE 的默认刷新策略。这可能会导致大量索引的性能问题，并且与 Elasticsearch 的默认行为不同。这已更改为现在默认刷新策略为 NONE。当使用反应式 REST 客户端中描述的配置提供时，默认刷新策略已设置为 NONE。ReactiveElasticsearchTemplateReactiveElasticsearchTemplatespring-doc.cn

新的 Elasticsearch 客户端

Elasticsearch 引入了它的新功能，并弃用了之前的 . Spring Data Elasticsearch 4.4 仍然使用旧客户端作为默认客户端，原因如下：ElasticsearchClientRestHighLevelClientspring-doc.cn

新客户端强制应用程序使用该包，而 Spring Boot 将坚持使用版本 3。因此，在 Spring Data Elasticsearch 中切换默认实现只能随 Spring Data Elasticsearch 5（Spring Data 3、Spring 6）一起提供。jakarta.json.spi.JsonProviderjavax.json.spi.JsonProviderspring-doc.cn
Elasticsearch 客户端中仍有一些 bug 需要解决spring-doc.cn
由于资源有限，在 Spring Data Elasticsearch 中使用新客户端的实现尚未完成 - 请记住，Spring Data Elasticsearch 是一个社区驱动的项目，它依赖于公众贡献。spring-doc.cn

如何使用新客户端

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

为了尝试使用新客户端，需要执行以下步骤：spring-doc.cn

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

如果使用 Spring Boot，请从自动配置中排除 Spring Data Elasticsearchspring-doc.cn

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

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

添加依赖项

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

<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-doc.cn

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

新的配置类

命令式样式

为了配置Spring Data Elasticsearch以使用新客户端，必须创建一个派生自以下内容的配置bean：org.springframework.data.elasticsearch.client.elc.ElasticsearchConfigurationspring-doc.cn

@Configuration
public class NewRestClientConfig extends ElasticsearchConfiguration {

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

配置以与旧 Client 端相同的方式完成，但不再需要创建除配置 bean 之外的更多内容。使用此配置，以下 bean 将在 Spring 应用程序上下文中可用：spring-doc.cn

一个 Bean，这是 Elasticsearch 客户端使用的已配置低级别RestClientRestClientspring-doc.cn
一个 Bean 中，这是使用ElasticsearchClientRestClientspring-doc.cn
一个 Bean，其 Bean 名称为 elasticsearchOperations 和 elasticsearchTemplate，它使用ElasticsearchOperationsElasticsearchClientspring-doc.cn

反应式风格

要在反应式环境中使用新客户端，唯一的区别是要从中派生配置的类：spring-doc.cn

@Configuration
public class NewRestClientConfig extends ReactiveElasticsearchConfiguration {

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

使用此配置，以下 bean 将在 Spring 应用程序上下文中可用：spring-doc.cn

一个 Bean，这是 Elasticsearch 客户端使用的已配置低级别RestClientRestClientspring-doc.cn
一个 Bean 中，这是使用ReactiveElasticsearchClientRestClientspring-doc.cn
一个 Bean，其 Bean 名称为 reactiveElasticsearchOperations 和 reactiveElasticsearchTemplate，它使用ReactiveElasticsearchOperationsReactiveElasticsearchClientspring-doc.cn