這是關於elasticsearch java api的第一篇教程,陸續會把es的一些心得寫出來。
可以通過兩種方式來串連到elasticsearch(簡稱es)叢集,第一種是通過在你的程式中建立一個嵌入es節點(Node),使之成為es叢集的一部分,然後通過這個節點來與es叢集通訊。第二種方式是用TransportClient這個介面和es叢集通訊。
Node方式
建立嵌入節點的方式如下:
import static org.elasticsearch.node.NodeBuilder.*; //啟動節點 Node node = nodeBuilder().node(); Client client = node.client(); //關閉節點node.close();
當你啟動一個節點,它會自動加入同網段的es叢集,一個前提就是es的叢集名(cluster.name)這個參數要設定一致。
預設的話啟動一個節點,es叢集會自動給它分配一些索引的分區,如果你想這個節點僅僅作為一個用戶端而不去儲存資料,你就可以設定把node.data設定成false或 node.client設定成true。下面是例子:
Node node = nodeBuilder().clusterName(clusterName).client(true).node();
還有一種情況是你並不想把節點加入叢集,只想用它進行單元測試時,就要啟動一個“本地”的es,這裡“本地”指的是在jvm的層級下運行,即兩個不同的es節點運行在同一個JVM中時會組成一個叢集。它需要把節點的local參數設定成true,下面是例子:
Node node = nodeBuilder().local(true).node();
TransportClient方式
通過TransportClient這個介面,我們可以不啟動節點就可以和es叢集進行通訊,它需要指定es叢集中其中一台或多台機的ip地址和連接埠,例子如下:
Client client = new TransportClient() .addTransportAddress(new InetSocketTransportAddress("host1", 9300)) .addTransportAddress(new InetSocketTransportAddress("host2", 9300)); client.close();
如果你需要更改叢集名(預設是elasticsearch),需要如下設定:
Settings settings = ImmutableSettings.settingsBuilder() .put("cluster.name", "myClusterName").build(); Client client = new TransportClient(settings);
你可以設定client.transport.sniff為true來使用戶端去嗅探整個叢集的狀態,把叢集中其它機器的ip地址加到用戶端中,這樣做的好處是一般你不用手動設定叢集裡所有叢集的ip到串連用戶端,它會自動幫你添加,並且自動探索新加入叢集的機器。代碼執行個體如下:
Settings settings = ImmutableSettings.settingsBuilder() .put("client.transport.sniff", true).build(); TransportClient client = new TransportClient(settings);
參考資料:http://www.searchtech.pro/articles/2013/02/18/1361194853254.html