此版本仍在开发中,尚未被视为稳定版本。对于最新的稳定版本,请使用 Spring Data Elasticsearch 5.4.0spring-doc.cadn.net.cn

从 4.4.x 升级到 5.0.x

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

弃用

自定义跟踪记录级别日志记录

通过设置属性logging.level.org.springframework.data.elasticsearch.client.WIRE=trace现已弃用,则 ElasticsearchRestClient提供了更好的解决方案,可以通过设置tracerpackage 添加到 “trace” 中。spring-doc.cadn.net.cn

org.springframework.data.elasticsearch.client.erhlc

请参阅包更改,此包中的所有类都已弃用,因为要使用的默认客户端实现是基于 Elasticsearch 的新 Java 客户端的实现,请参阅新的 Elasticsearch 客户端spring-doc.cadn.net.cn

删除已弃用的代码

DateFormat.noneDateFormat.custom自 4.2 版起已弃用,并已被删除。spring-doc.cadn.net.cn

的特性@Document自 4.2 以来已弃用的版本已被删除。 使用@Settings注解。spring-doc.cadn.net.cn

@DynamicMapping@DynamicMappingValue已被删除。 用@Document.dynamic@Field.dynamic相反。spring-doc.cadn.net.cn

重大更改

删除已弃用的调用

已删除作界面中的 SUGGEST 调用

SearchOperationsReactiveSearchOperations已弃用使用 Elasticsearch 类作为参数的调用。 这些 API 现在已被删除,因此这些 API 中对 Elasticsearch 类的依赖性也已清理。spring-doc.cadn.net.cn

套餐更改

使用或依赖于已弃用的 Elasticsearch 的所有类RestHighLevelClient已移动到包org.springframework.data.elasticsearch.client.erhlc. 通过此更改,我们现在明确区分了使用旧的已弃用 Elasticsearch 库的代码、使用新 Elasticsearch 客户端的代码以及独立于客户端实现的代码。 此外,到目前为止提供的反应式实现已移至此处,因为此实现包含从 Elasticsearch 库复制和改编的代码。spring-doc.cadn.net.cn

如果您正在使用ElasticsearchRestTemplate直接,而不是ElasticsearchOperations界面中,您还需要调整导入。spring-doc.cadn.net.cn

使用NativeSearchQuery类中,您需要切换到NativeQuery类,该类可以采用Query实例。 您将在测试代码中找到大量示例。spring-doc.cadn.net.cn

转换为 Java 17 条记录

以下类已转换为Record中,您可能需要将 getter 方法的使用从getProp()prop():spring-doc.cadn.net.cn

新的 HttpHeaders 类

在版本 4.4 之前,客户端配置使用HttpHeadersorg.springframework:spring-web项目。 这会引入对该构件的依赖关系。 不使用 spring-web 的用户将面临错误,因为找不到此类。spring-doc.cadn.net.cn

在 5.0 版本中,我们引入了自己的HttpHeaders配置客户端。spring-doc.cadn.net.cn

因此,如果您在客户端配置中使用标头,则需要将org.springframework.http.HttpHeadersorg.springframework.data.elasticsearch.support.HttpHeaders.spring-doc.cadn.net.cn

提示:您可以传递org.springframework.http .HttpHeadersaddAll()method 的org.springframework.data.elasticsearch.support.HttpHeaders.spring-doc.cadn.net.cn

新的 Elasticsearch 客户端

Spring Data Elasticsearch 现在使用新的ElasticsearchClient并已弃用以前的RestHighLevelClient.spring-doc.cadn.net.cn

命令式样式配置

要将 Spring Data Elasticsearch 配置为使用新客户端,必须创建一个派生自org.springframework.data.elasticsearch.client.elc.ElasticsearchConfiguration:spring-doc.cadn.net.cn

@Configuration
public class NewRestClientConfig extends ElasticsearchConfiguration {

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

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

  • 一个RestClientbean,即配置的低级别RestClient由 Elasticsearch 客户端使用spring-doc.cadn.net.cn

  • ElasticsearchClientbean,这是使用RestClientspring-doc.cadn.net.cn

  • ElasticsearchOperationsbean,可通过 bean 名称 elasticsearchOperationselasticsearchTemplate 获得,它使用ElasticsearchClientspring-doc.cadn.net.cn

反应式样式配置

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

@Configuration
public class NewRestClientConfig extends ReactiveElasticsearchConfiguration {

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

使用此配置,以下 bean 将在 Spring 应用程序上下文中可用:spring-doc.cadn.net.cn

  • 一个RestClientbean,即配置的低级别RestClient由 Elasticsearch 客户端使用spring-doc.cadn.net.cn

  • ReactiveElasticsearchClientbean,这是使用RestClientspring-doc.cadn.net.cn

  • ReactiveElasticsearchOperationsbean,可通过 bean 名称 reactiveElasticsearchOperationsreactiveElasticsearchTemplate 获得,它使用ReactiveElasticsearchClientspring-doc.cadn.net.cn

仍想使用旧客户端?

旧的已弃用RestHighLevelClient仍然可以使用,但您需要将依赖项显式添加到您的应用程序中,因为 Spring Data Elasticsearch 不再自动将其拉入:spring-doc.cadn.net.cn

<!-- include the RHLC, specify version explicitly	-->
<dependency>
	<groupId>org.elasticsearch.client</groupId>
	<artifactId>elasticsearch-rest-high-level-client</artifactId>
	<version>7.17.5</version>
	<exclusions>
		<exclusion>
			<groupId>commons-logging</groupId>
			<artifactId>commons-logging</artifactId>
		</exclusion>
	</exclusions>
</dependency>

确保明确指定版本 7.17.6,否则 maven 将解析为 8.5.0,并且不存在。spring-doc.cadn.net.cn


APP信息