elasticsearch怎么構造Client實現java客戶端調用接口

本篇內容主要講解“elasticsearch怎么構造Client實現java客戶端調用接口”，感興趣的朋友不妨來看看。本文介紹的方法操作簡單快捷，實用性強。下面就讓小編來帶大家學習“elasticsearch怎么構造Client實現java客戶端調用接口”吧!

elasticsearch通過構造一個client對外提供了一套豐富的java調用接口。總體來說client分為兩類cluster信息方面的client及數據（index）方面的client。這兩個大類由可以分為通用操作和admin操作兩類。

client的繼承關系

（1.5版本，其它版本可能不一樣）：

通過這個繼承關系圖可以很清楚的了解client的實現，及功能。總共有三類即client， indicesAdminClient和ClusterAdminClient。它都有自己的實現類，但最后都是通過client接口對外提供服務。client作為對外的總接口，首先通過admin()方法組合了admin的相關操作，它本身也提供了所有對數據和cluster的通用操作。

方法實現上

所有的接口都通過兩種方式實現了異步調用，一個是返回一個ActionFuture，另外一種方式是接受一個ActionListener。

以index方法為例

如下所示

 ActionFuture<IndexResponse>  index(IndexRequest request) ;

 void index(IndexRequest request, ActionListener<IndexResponse> listener);

第一個方法會返回一個future，第二個方法則需要傳遞一個Listener。這也是異步實現的兩個基本方式。client使用了門面模式，所有的實現都在AbstractClient類中，還以index方法為例，代碼如下所示：

@Override
    public ActionFuture<IndexResponse> index(final IndexRequest request) {
        return execute(IndexAction.INSTANCE, request);
    }
    @Override
    public void index(final IndexRequest request, final ActionListener<IndexResponse> listener) {
        execute(IndexAction.INSTANCE, request, listener);
    }

實現如上所示，之所以說它是門面模式是因為所有的方法都被集成到了client中，但是執行過程都是在對應的action中執行。在execute方法中，獲取到相應的action實例，真正的邏輯是在對應的transportaction中實現。

execute方法代碼

如下所示：

@SuppressWarnings("unchecked")
    @Override
    public <Request extends ActionRequest, Response extends ActionResponse, RequestBuilder extends ActionRequestBuilder<Request, Response, RequestBuilder, Client>> ActionFuture<Response> execute(Action<Request, Response, RequestBuilder, Client> action, Request request) {
        headers.applyTo(request);
        TransportAction<Request, Response> transportAction = actions.get((ClientAction)action);
        return transportAction.execute(request);
    }
    @SuppressWarnings("unchecked")
    @Override
    public <Request extends ActionRequest, Response extends ActionResponse, RequestBuilder extends ActionRequestBuilder<Request, Response, RequestBuilder, Client>> void execute(Action<Request, Response, RequestBuilder, Client> action, Request request, ActionListener<Response> listener) {
        headers.applyTo(request);
        TransportAction<Request, Response> transportAction = actions.get((ClientAction)action);
        transportAction.execute(request, listener);
    }

每一種操作都對應有相應的transportAction，這些transportAction才是最終的執行者。這里先以index為例簡單說明，在后面索引功能分析中會看到更多這種的結果。

public class IndexAction extends ClientAction<IndexRequest, IndexResponse, IndexRequestBuilder> {
    public static final IndexAction INSTANCE = new IndexAction();
    public static final String NAME = "indices:data/write/index";
    private IndexAction() {
        super(NAME);
    }
    @Override
    public IndexResponse newResponse() {
        return new IndexResponse();
    }
    @Override
    public IndexRequestBuilder newRequestBuilder(Client client) {
        return new IndexRequestBuilder(client);
    }
}

在IndexAction中只是簡單的定義了一個NAME，及幾個簡單的方法。這個名字會在啟動時作為對于的transportHandler的key注冊到TransportService中。在execute方法中，會根據action的將transportAction取出如上一段代碼所示。真正的執行邏輯在InternalTransportClient中，這里先略過它的實現，后面會有詳細分析。所有這些action的注冊都是在actionModule中實現，注冊過程會在后面跟action一起分析。

到此，相信大家對“elasticsearch怎么構造Client實現java客戶端調用接口”有了更深的了解，不妨來實際操作一番吧！這里是億速云網站，更多相關內容可以進入相關頻道進行查詢，關注我們，繼續學習！