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

从 4.2.x 升级到 4.3.x

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

Elasticsearch 正在开发一个新的客户端，它将取代RestHighLevelClient因为RestHighLevelClient使用不再获得 Apache 2 许可的 Elasticsearch 核心库中的代码。 Spring Data Elasticsearch 也在为这一变化做准备。 这意味着在内部，*Operations接口需要更改 - 如果用户针对ElasticsearchOperations或ReactiveElasticsearchOperations. 如果您使用的是ElasticsearchRestTemplate直接，您将需要适应这些变化。spring-doc.cadn.net.cn

Spring Data Elasticsearch 还删除或替换了org.elasticsearch包，仅在实现对 Elasticsearch 的访问的实现中使用它们。 对于用户来说，这意味着一些使用的枚举类被位于org.springframework.data.elasticsearch使用相同的值，这些值将在内部映射到 Elasticsearch 上。spring-doc.cadn.net.cn

使用不易替换的类的地方，此用法被标记为已弃用，我们正在努力替换。spring-doc.cadn.net.cn

有关更多详细信息，请查看 弃用 和 重大更改 部分。spring-doc.cadn.net.cn

弃用

建议方法

在SearchOperations，依此类推ElasticsearchOperations此外，suggest方法采用org.elasticsearch.search.suggest.SuggestBuilderas 参数并返回org.elasticsearch.action.search.SearchResponse已被弃用。 用SearchHits<T> search(Query query, Class<T> clazz)相反，传入NativeSearchQuery它可以包含一个SuggestBuilder并从返回的SearchHit<T>.spring-doc.cadn.net.cn

在ReactiveSearchOperations新的suggest方法返回一个Mono<org.springframework.data.elasticsearch.core.suggest.response.Suggest>现在。 在这里，旧方法也被弃用了。spring-doc.cadn.net.cn

重大更改

移除org.elasticsearch类。

  • 在org.springframework.data.elasticsearch.annotations.CompletionContext注解属性type()已从org.elasticsearch.search.suggest.completion.context.ContextMapping.Type自org.springframework.data.elasticsearch.annotations.CompletionContext.ContextMappingType，则可用的枚举值相同。spring-doc.cadn.net.cn

  • 在org.springframework.data.elasticsearch.annotations.Document注解中，将versionType()属性已更改为org.springframework.data.elasticsearch.annotations.Document.VersionType，则可用的枚举值相同。spring-doc.cadn.net.cn

  • 在org.springframework.data.elasticsearch.core.query.Query接口searchType()属性已更改为org.springframework.data.elasticsearch.core.query.Query.SearchType，则可用的枚举值相同。spring-doc.cadn.net.cn

  • 在org.springframework.data.elasticsearch.core.query.Query接口中，返回timeout()已更改为java.time.Duration.spring-doc.cadn.net.cn

  • 这SearchHits<T>`class does not contain the `org.elasticsearch.search.aggregations.Aggregations了。 相反，它现在包含org.springframework.data.elasticsearch.core.AggregationsContainer<T>类，其中T是所使用的基础客户端的具体聚合类型。 目前，这将是一个org .springframework.data.elasticsearch.core.clients.elasticsearch7.ElasticsearchAggregations对象;稍后将提供不同的实现。 对ReactiveSearchOperations.aggregate()函数，现在返回一个Flux<AggregationContainer<?>>. 需要更改使用聚合的程序，以将返回的值强制转换为适当的类以进一步处理它。spring-doc.cadn.net.cn

  • 可能引发org.elasticsearch.ElasticsearchStatusException现在会扔org.springframework.data.elasticsearch.RestStatusException相反。spring-doc.cadn.net.cn

处理 Query 的 field 和 sourceFilter 属性

在版本 4.2 之前，fields属性Query被解释并添加到sourceFilter. 这是不正确的，因为这些对于 Elasticsearch 来说是不同的事情。 此问题已得到纠正。 因此，依赖于使用fields指定应从文档的_source' and should be changed to use the `sourceFilter.spring-doc.cadn.net.cn

search_type默认值

的search_type在 Elasticsearch 中是query_then_fetch. 现在，此 ID 也设置为Queryimplementations，它之前设置为dfs_query_then_fetch.spring-doc.cadn.net.cn

BulkOptions 更改

某些属性org.springframework.data.elasticsearch.core.query.BulkOptionsclass 已更改其类型：spring-doc.cadn.net.cn

指数选项更改

Spring Data Elasticsearch 现在使用org.springframework.data.elasticsearch.core.query.IndicesOptions而不是org.elasticsearch.action.support.IndicesOptions.spring-doc.cadn.net.cn

完成类

包中的类org.springframework.data.elasticsearch.core.completion已移至org.springframework.data.elasticsearch.core.suggest.spring-doc.cadn.net.cn

其他重命名

这org.springframework.data.elasticsearch.core.mapping.ElasticsearchPersistentPropertyConverterinterface 已重命名为org.springframework.data.elasticsearch.core.mapping.PropertyValueConverter. 同样，名为 XXPersistentPropertyConverter 的实现类已重命名为 XXPropertyValueConverter。spring-doc.cadn.net.cn