从 5.1.x 升级到 5.2.x

本节介绍了从 5.1.x 版本到 5.2.x 版本的重大更改，以及如何用新引入的功能替换已删除的功能。

重大更改

批量失败

在 org.springframework.data.elasticsearch.BulkFailureException 类中，getFailedDocuments 的返回类型已从 Map<String, String> 更改为 Map<String, FailureDetails>，这允许获取有关失败原因的更多详细信息。

FailureDetails 类（BulkFailureException 的内部类）的定义

public record FailureDetails(Integer status, String errorMessage) {
}

脚本和运行时字段

org.springframework.data.elasticsearch.core.RuntimeField 和 org.springframework.data.elasticsearch.core.query.ScriptType 类已移至子包 org.springframework.data.elasticsearch.core.query。

ScriptData 构造函数的 type 参数不再可为空。

弃用

删除弃用代码

  • 所有使用旧版弃用 RestHighLevelClient 的代码已被删除。自 5.0 版以来使用的默认 Elasticsearch 客户端是（并非如此）新的 Elasticsearch Java 客户端。

  • org.springframework.data.elasticsearch.client.ClientLogger 类已被删除。此记录器使用 org.springframework.data.elasticsearch.client.WIRE 设置配置，但无法与所有客户端一起使用。从 5.0 版开始，请使用 Elasticsearch Java 客户端中提供的跟踪记录器，请参阅 客户端日志记录。

  • org.springframework.data.elasticsearch.core.ElasticsearchOperations.stringIdRepresentation(Object) 方法已被删除，请改用同一接口中定义的 convertId(Object) 方法。

  • org.springframework.data.elasticsearch.core.Range 类已被删除，请改用 org.springframework.data.domain.Range。

  • org.springframework.data.elasticsearch.core.query.IndexQuery.getParentId() 和 setParentId(String) 方法已被删除，它们不再使用并且是无操作的。它也已从 org.springframework.data.elasticsearch.core.query.IndexQuery 类中删除。