ElasticSearch的javaAPI之Client

翻译的原文：http://www.elasticsearch.org/guide/en/elasticsearch/client/java-api/current/client.html#node-client

翻译ElasticSearch的javaAPI之Client

本节描写叙述了elasticsearch提供的Java API，全部elasticsearch操作使用client对象运行。

全部的操作在本质上是全然asynchronous（接受一个listener，或返回一个future）。

此外，在client的操作，能够批量处理。

注意： all the APIs are exposed through the Java API

maven repository

比如，你能够在pom.xml文件里增加以下这几行

<dependency>

    <groupId>org.elasticsearch</groupId>

    <artifactId>elasticsearch</artifactId>

    <version>${es.version}</version>

</dependency>

您能够以多种方式使用Java client：

对一个现有的cluster中index，运行标准的get，delete和search操作

在一个执行群集执行管理任务

执行嵌入在您自己的应用程序的elasticsearch，或者当你想执行单元和集成測试，启动节点

获取一个elasticsearch client是easy的。以下最经常使用的方式：

     1.创建一个节点（ acts as a node within a cluster）

     2.从节点请求client(from your embedded
Node)

还有一种方式是通过创建一个TransportClient连接到群集。

Important:

请注意，我们建议使用同一版本号的client和集群。由于你可能遇到一些不兼容的问题，当混用不同版本号。

Node client:

实例化一个基于节点的client是最简单的方法，能够让客户对elasticsearch进行运行操作。

   importstatic org.elasticsearch.node.NodeBuilder.*;

// on startup

Node node = nodeBuilder().node();
Client client = node.client();

// on shutdown

node.close();

当你启动一个节点，它增加了一个elasticsearch集群。你能够通过简单的设置cluster.name设置不同的集群，或显式地使用clusterName method方法。

你能够定义cluster.name在/src/main/resources / elasticsearch.yml文件在您的项目。仅仅要elasticsearch.yml是在类路径中存在，它将被用来当您启动节点。

cluster.name: yourclustername

 Or in Java:

Node node = nodeBuilder().clusterName("yourclustername").node();
Client client = node.client();

使用client的优点是操作是自己主动路由到节点的操作须要运行，不运行“double hop”。比如，index操作将在shard上自己主动运行的。

当你启动一个节点，最重要的是决定是否应该保存数据或不。换句话说，该indices和shards被分配给它的。非常多时候我们会须要client不过client，没有shards分配给他们。这是简单的设置是node.data设置为false或node.client的配置true（the NodeBuilder respectivehelper methods on it）：

importstatic org.elasticsearch.node.NodeBuilder.*;

// on startup

Node node = nodeBuilder().client(true).node();
Client client = node.client();

// on shutdown

node.close();

还有一个常见方法启动节点和使用client单元/集成測试。在这样的情况下，我们要開始一个“local”节点（与“local”的discovery and transpor）。再次，这仅仅是一个简单的设置启动节点时。注意，“local”在这里是指当地的JVM（嗯，实际上的类装载器），这意味着两个本地server开在同样的JVM，组成一个集群。

importstatic org.elasticsearch.node.NodeBuilder.*;

// on startup

Node node = nodeBuilder().local(true).node();
Client client = node.client();

// on shutdown

node.close();

transport  client

TransportClient 使用 transport module远程连接elasticsearch集群，它不增加群集，但仅仅会有一个或多个初始传输地址和与集群交流对每一个动作robin fashion（尽管大多数行动将可能是“two hop”操作）。

// on startup

Client client = new TransportClient()
        .addTransportAddress(new InetSocketTransportAddress("host1", 9300))
        .addTransportAddress(new InetSocketTransportAddress("host2", 9300));

// on shutdown

client.close();

请注意，你必须设置群集名称，假设你使用一个不同的“elasticsearch”：

Settings settings =ImmutableSettings.settingsBuilder()
        .put("cluster.name", "myClusterName").build();
Client client =    new TransportClient(settings);
//Add transport addresses and do something with the client...

或者使用elasticsearch.yml

客户能够sniff集群的歇息，并加入到列表中的机器使用。在这样的情况下，请注意，使用的IP地址将是其它节点開始的（"publish" address）。为了使用它，把client.transport.sniff设置true：

Settings settings =ImmutableSettings.settingsBuilder()
        .put("client.transport.sniff", true).build();
TransportClient client = new TransportClient(settings);

Other transport client levelsettings include:

client.transport.ignore_cluster_name	Set to true to ignore cluster name validation of connected nodes. (since 0.19.4)
client.transport.ping_timeout	The time to wait for a ping response from a node. Defaults to 5s.
client.transport.nodes_sampler_interval	How often to sample / ping the nodes listed and connected. Defaults to 5s.

原文：http://www.elasticsearch.org/guide/en/elasticsearch/client/java-api/current/client.html#node-client

翻译欠佳，希望不会对大家造成误导