从 5.1.x 升级到 5.2.x

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

重大更改

批量失败

在org.springframework.data.elasticsearch.BulkFailureExceptionclass 的getFailedDocuments已从Map<String, String>自Map<String, FailureDetails>，这允许获取有关失败原因的其他详细信息。spring-doc.cadn.net.cn

的定义FailureDetails类（内部到BulkFailureException):spring-doc.cadn.net.cn

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

脚本化字段和运行时字段

类org.springframework.data.elasticsearch.core.RuntimeField和org.springframework.data.elasticsearch.core.query.ScriptType已移至 subpackageorg.springframework.data.elasticsearch.core.query.spring-doc.cadn.net.cn

这type参数的ScriptDataconstructor 不再可为 null。spring-doc.cadn.net.cn

弃用

删除已弃用的代码

  • 所有使用旧的已弃用RestHighLevelClient已被删除。 自 5.0 版以来使用的默认 Elasticsearch 客户端是（不是如此）新的 Elasticsearch Java 客户端。spring-doc.cadn.net.cn

  • 这org.springframework.data.elasticsearch.client.ClientLogger类已被删除。 此 Logger 配置了org.springframework.data.elasticsearch.client.WIRE设置，但并未与所有客户端一起使用。 从版本 5 开始，使用 Elasticsearch Java 客户端中提供的跟踪记录器，请参阅客户端日志记录。spring-doc.cadn.net.cn

  • 方法org.springframework.data.elasticsearch.core.ElasticsearchOperations.stringIdRepresentation(Object)已删除，请使用convertId(Object)方法。spring-doc.cadn.net.cn

  • 类org.springframework.data.elasticsearch.core.Range已被删除，请使用org.springframework.data.domain.Range相反。spring-doc.cadn.net.cn

  • 方法org.springframework.data.elasticsearch.core.query.IndexQuery.getParentId() and `setParentId(String)已被删除，它们不再使用并且是无作。 它已从org.springframework.data.elasticsearch.core.query.IndexQuery类。spring-doc.cadn.net.cn