Track 2 files into repository.

- modified client/transport-client.md
- modified client/xpack-transport-client.md

Auto commit by GitBook Editor

Author: quanke

client/transport-client.md

@@ -0,0 +1,65 @@
+
+### Transport Client
+
+#### 不设置集群名称
+
+```
+// on startup
+
+//此步骤添加IP，至少一个，如果设置了"client.transport.sniff"= true 一个就够了，因为添加了自动嗅探配置
+TransportClient client = new PreBuiltTransportClient(Settings.EMPTY)
+        .addTransportAddress(new InetSocketTransportAddress(InetAddress.getByName("host1"), 9300))
+        .addTransportAddress(new InetSocketTransportAddress(InetAddress.getByName("host2"), 9300));
+
+// on shutdown  关闭client
+
+client.close();
+```
+
+#### 设置集群名称
+
+```
+Settings settings = Settings.builder()
+        .put("cluster.name", "myClusterName").build();  //设置ES实例的名称
+TransportClient client = new PreBuiltTransportClient(settings);  //自动嗅探整个集群的状态，把集群中其他ES节点的ip添加到本地的客户端列表中
+//Add transport addresses and do something with the client...
+```
+
+#### 增加自动嗅探配置
+```
+Settings settings = Settings.builder()
+        .put("client.transport.sniff", true).build();
+TransportClient client = new PreBuiltTransportClient(settings);
+```
+
+#### 其他配置
+
+```
+client.transport.ignore_cluster_name  //设置 true ，忽略连接节点集群名验证
+client.transport.ping_timeout       //ping一个节点的响应时间 默认5秒
+client.transport.nodes_sampler_interval //sample/ping 节点的时间间隔，默认是5s
+```
+> 对于ES Client，有两种形式，一个是TransportClient，一个是NodeClient。两个的区别为：
+TransportClient作为一个外部访问者，通过HTTP去请求ES的集群，对于集群而言，它是一个外部因素。
+NodeClient顾名思义，是作为ES集群的一个节点，它是ES中的一环，其他的节点对它是感知的，不像TransportClient那样，ES集群对它一无所知。NodeClient通信的性能会更好，但是因为是ES的一环，所以它出问题，也会给ES集群带来问题。NodeClient可以设置不作为数据节点，在elasticsearch.yml中设置，这样就不会在此节点上分配数据。
+
+如果用ES的节点，大家仁者见仁智者见智，各按所需。
+
+#### 实例
+
+```
+Settings esSettings = Settings.builder()
+
+    .put("cluster.name", clusterName) //设置ES实例的名称
+
+    .put("client.transport.sniff", true) //自动嗅探整个集群的状态，把集群中其他ES节点的ip添加到本地的客户端列表中
+
+    .build();
+
+    client = new PreBuiltTransportClient(esSettings);//初始化client较老版本发生了变化，此方法有几个重载方法，初始化插件等。
+
+    //此步骤添加IP，至少一个，其实一个就够了，因为添加了自动嗅探配置
+
+    client.addTransportAddress(new InetSocketTransportAddress(InetAddress.getByName(ip), esPort));
+
+```

client/xpack-transport-client.md

@@ -0,0 +1,60 @@
+
+### XPackTransportClient
+如果 `ElasticSearch ` 服务安装了 `x-pack` 插件，需要`PreBuiltXPackTransportClient`实例才能访问
+
+
+使用Maven管理项目，把下面代码增加到`pom.xml`;
+
+> 一定要修改默认仓库地址为https://artifacts.elastic.co/maven，因为这个库没有上传到Maven中央仓库
+
+```
+<project ...>
+
+   <repositories>
+      <!-- add the elasticsearch repo -->
+      <repository>
+         <id>elasticsearch-releases</id>
+         <url>https://artifacts.elastic.co/maven</url>
+         <releases>
+            <enabled>true</enabled>
+         </releases>
+         <snapshots>
+            <enabled>false</enabled>
+         </snapshots>
+      </repository>
+      ...
+   </repositories>
+   ...
+
+   <dependencies>
+      <!-- add the x-pack jar as a dependency -->
+      <dependency>
+         <groupId>org.elasticsearch.client</groupId>
+         <artifactId>x-pack-transport</artifactId>
+         <version>5.6.3</version>
+      </dependency>
+      ...
+   </dependencies>
+   ...
+
+ </project>
+```
+
+#### 实例
+
+
+```
+Settings settings = Settings.builder().put("cluster.name", "xxx")
+                    .put("xpack.security.transport.ssl.enabled", false)
+                    .put("xpack.security.user", "xxx:xxx")
+                    .put("client.transport.sniff", true).build();
+try {
+    client = new PreBuiltXPackTransportClient(settings)
+            .addTransportAddress(new InetSocketTransportAddress(InetAddress.getByName("xxx.xxx.xxx.xxx"), 9300))
+            .addTransportAddress(new InetSocketTransportAddress(InetAddress.getByName("xxx.xxx.xxx.xxx"), 9300));
+} catch (UnknownHostException e) {
+    e.printStackTrace();
+}
+```
+
+更多请浏览 dayu-spring-boot-starter 开源项目