从传输客户端到高级REST客户端的Elasticsearch升级路径

Question

使用Elasticsearch原生Java客户端API（TransportClient）的应用程序升级到使用Java高级REST客户端的路径是什么？

文件（初步？）似乎表明：

Java高级REST客户端依赖于Elasticsearch核心项目。它接受与TransportClient相同的请求参数，并返回相同的响应对象。

（来源：https://www.elastic.co/guide/en/elasticsearch/client/java-rest/5.x/java-rest-high.html)

但我并不完全清楚这意味着什么。我是否能够在不重写查询或其他客户端类型操作的情况下，将整个代码库切换到高级REST客户端？REST客户端似乎没有实现客户端接口。从脱钩的角度来看，这可能是有道理的

我需要知道的是，我是否应该围绕客户机操作构建自己的抽象，或者HighLevelRestClient是否将基本上实现client接口。

我是否应该暂时继续针对TransportClient API编写代码，或者当TransportClient不推荐使用时，这些代码都需要重写？

请注意，我关注的是高级REST客户机，而不是低级REST客户机。

Answer 1

高级REST客户端不实现客户端接口。我不久前写的这篇博文描述了这个计划。

我们还正在编写文档，其中将包含一个页面，说明如何从传输客户端迁移。

新客户端重用来自现有传输客户端的请求和响应，但客户端对象不兼容，这意味着例如以下情况：

IndexRequest indexRequest = new IndexRequest("index", "type", "id");
indexRequest.source("field", "value");
IndexResponse indexResponse = transportClient.index(indexRequest).get();

会变成这样的东西：

IndexRequest indexRequest = new IndexRequest("index", "type", "id");
indexRequest.source("field", "value");
IndexResponse indexResponse = restHighLevelClient.index(indexRequest);

至于异步请求，调用略有不同（请参见方法名称），在新客户端中，我们选择了另一个名称以“async”后缀结尾的方法，您可以选择以下选项：

transportClient.index(indexRequest, new ActionListener<IndexResponse>() {
                    @Override
                    public void onResponse(IndexResponse indexResponse) {
                        // called when the operation is successfully completed
                    }

                    @Override
                    public void onFailure(Exception e) {
                        // called on failure
                    }
                });

以下是：

restHighLevelClient.indexAsync(indexRequest, new ActionListener<IndexResponse>() {
                @Override
                public void onResponse(IndexResponse indexResponse) {
                    // called when the operation is successfully completed
                }

                @Override
                public void onFailure(Exception e) {
                    // called on failure
                }
            });

不幸的是，客户端#准备*方法在高级客户端中不可用，因此类似于：

IndexResponse indexResponse = transportClient.prepareIndex("index", "type", "id").setSource("field", "value").get();

需要使用ActionRequests而不是ActionRequestBuilders将其迁移到上述位置。我们正在进行此更改，因为传输客户端中的请求和构建程序之间总是存在混淆，这两种方法完全相同。新客户端将使用单一方式提供请求。

如果您想查看当前的文档，它已经处于活动状态，但仍在进行中：https://www.elastic.co/guide/en/elasticsearch/client/java-rest/master/java-rest-high.html .

高级REST客户端将取代传输客户端，尽管它的第一个即将发布的版本将只支持索引、批量、获取、删除、更新、搜索、搜索滚动和清除滚动API。接下来将支持缺失的API，我们也像往常一样欢迎用户的贡献。

Transport客户端将很快被弃用，因此我建议尽快转移到高级别REST客户端，这不应该是一个巨大的变化，它将得到回报，因为我们将不断改进，已经通过REST是一个很大的改进。