从4.3.x升级到4.4.x
本节介绍了从4.3.x到4.4.x版本的重大变更,以及如何用新引入的功能替代被移除的功能。
变更
废弃类别的移除
org.springframework.data.elasticsearch.core.ElasticsearchTemplate已被移除
自4.4版本起,Spring Data Elasticsearch 不再使用运输客户端不再是Elasticsearch(而Elasticsearch自7.0版起已被弃用)。
这意味着org.springframework.data.elasticsearch.core.ElasticsearchTemplate自 Spring Data Elasticsearch 4.0 起被弃用的 class 已被移除。
这是弹性搜索作该接口使用运输客户端.
与弹性搜索的连接必须通过以下命令式弹性搜索Rest模板或反应性ReactiveElasticsearch模板.
包装变更
在4.3中,两个类别(弹性搜索聚合和弹性搜索聚合)已被迁移到org.springframework.data.elasticsearch.core.clients.elasticsearch7为新 Elasticsearch 客户端的集成做准备的软件包。
他们被调回了org.springframework.data.elasticsearch.corepackage,我们保留了这些类,使用旧的Elasticsearch客户端,位于它们所在的位置。
行为改变
这ReactiveElasticsearch模板, 无论直接创建还是通过 Spring Boot 创建,配置默认刷新策略为 IMMEDIATE。
这可能导致重度索引时的性能问题,且与Elasticsearch的默认行为不同。
现在默认刷新策略改为无刷新。
当ReactiveElasticsearch模板通过使用Reactive REST Client中描述的配置实现,默认刷新策略已设置为NONE。
新的 Elasticsearch 客户端
Elasticsearch 推出了它的新功能Elasticsearch客户端并且已经弃用了之前的RestHighLevel客户端.
Spring Data Elasticsearch 4.4 仍然使用旧客户端作为默认客户端,原因如下:
-
新客户端强制应用程序使用
jakarta.json.spi.JsonProvider而 Spring Boot 则会坚持javax.json.spi.JsonProvider直到版本3。所以在 Spring Data Elasticsearch 中切换默认实现只能在 Spring Data Elasticsearch 5(Spring Data 3、Spring 6)中实现。 -
Elasticsearch 客户端仍存在一些需要解决的漏洞
-
由于资源有限,使用新客户端在 Spring Data Elasticsearch 中的实现尚未完成——请记住,Spring Data Elasticsearch 是一个由社区驱动的项目,依靠公众贡献实现。
如何使用新客户端
使用新客户端的实现尚未完成,有些作会抛出java.lang.UnsupportedOperationException或者可能会抛出NPE(例如当Elasticsearch无法解析服务器响应时,这种情况有时仍会发生)。使用新客户端测试实现,但还不要在生产代码中使用! |
为了尝试使用新客户端,需要以下步骤:
确保不要配置现有的默认客户端
如果使用 Spring Boot,请在自动配置中排除 Spring Data Elasticsearch
@SpringBootApplication(exclude = ElasticsearchDataAutoConfiguration.class)
public class SpringdataElasticTestApplication {
// ...
}
从你的应用配置中移除与 Spring Data Elasticsearch 相关的属性。 如果 Spring Data Elasticsearch 是通过程序化配置配置(参见 Elasticsearch 客户端),请将这些 Burn 从 Spring 应用上下文中移除。
添加依赖
新 Elasticsearch 客户端的依赖在 Spring Data Elasticsearch 中仍然是可选的,因此需要明确添加:
<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中设置以下属性。
<properties>
<jakarta-json.version>2.0.1</jakarta-json.version>
</properties>
新配置类别
祈使式
为了配置 Spring Data Elasticsearch 以使用新客户端,必须创建一个从 衍生的配置豆org.springframework.data.elasticsearch.client.elc.ElasticsearchConfiguration:
@Configuration
public class NewRestClientConfig extends ElasticsearchConfiguration {
@Override
public ClientConfiguration clientConfiguration() {
return ClientConfiguration.builder() //
.connectedTo("localhost:9200") //
.build();
}
}
配置方式与旧客户端相同,但不再需要创建超过配置豆的部分。 通过这种配置,以下豆子将在春季应用环境中可用:
-
一个
Rest客户端Bean,那是配置好的低级Rest客户端该系统由Elasticsearch客户端使用 -
一
Elasticsearch客户端Bean,这是使用新客户端Rest客户端 -
一
弹性搜索作豆子,可用 elasticsearchOperations 和 elasticsearchTemplate 这两个豆子名称,这使用Elasticsearch客户端
响应式风格
在响应式环境中使用新客户端的唯一区别在于从哪个类派生配置:
@Configuration
public class NewRestClientConfig extends ReactiveElasticsearchConfiguration {
@Override
public ClientConfiguration clientConfiguration() {
return ClientConfiguration.builder() //
.connectedTo("localhost:9200") //
.build();
}
}
通过这种配置,以下豆子将在春季应用环境中可用:
-
一个
Rest客户端Bean,那是配置好的低级Rest客户端该系统由Elasticsearch客户端使用 -
一
ReactiveElasticsearchClientBean,这是新的响应式客户端,它使用Rest客户端 -
一
响应式弹性搜索作豆子,可用豆子名称 reactiveElasticSearchOperations 和 reactiveElasticsearchTemplate,使用ReactiveElasticsearchClient