Merge branch 'master' of https://git.gitbook.com/quanke/elasticsearch-java

# Conflicts:
#	README.md

Author: quanke

README.md

@@ -4,23 +4,42 @@
 
 本书由 [全科](http://woquanke.com) 翻译，并且整理成电子书，支持PDF,ePub,Mobi格式，方便大家下载阅读。
 
+
 阅读地址：[http://woquanke.com/esjava/](http://woquanke.com/esjava/)
 
 下载地址：[https://www.gitbook.com/book/quanke/elasticsearch-java](https://www.gitbook.com/book/quanke/elasticsearch-java)
 
 github地址：[https://github.com/quanke/elasticsearch-java](https://github.com/quanke/elasticsearch-java)
 
+
+
+gitee 地址：[https://gitee.com/quanke/elasticsearch-java](https://gitee.com/quanke/elasticsearch-java) 
+配套示例代码：[https://gitee.com/quanke/elasticsearch-java-study](https://gitee.com/quanke/elasticsearch-java-study)
+
+
 编辑：[http://woquanke.com](http://woquanke.com)
 
 编辑整理辛苦，还望大神们点一下star ，抚平我虚荣的心
 
+> 不只是官方文档的翻译，还包含使用实例，包含我们使用踩过的坑
+
+## 推荐阅读
+
+[Elasticsearch Java Rest 手册](https://www.gitbook.com/book/quanke/elasticsearch-java-rest/) 已经完成大部分
+
+
 更多请关注我的微信公众号：
 
 ![](/assets/qrcode_for_gh_26893aa0a4ea_258.jpg)
 
 
+下面几个章节应用的相对少，所以会延后更新，计划先把 配套实例 [ elasticsearch-java-study](https://gitee.com/quanke/elasticsearch-java-study) 项目写完；
 
-
+* [Indexed Scripts API](indexed-scripts-api.md)
+  * [Script Language](indexed-scripts-api/script-language.md)
+* [Java API Administration](java-api-administration.md)
+  * [Indices Administration](java-api-administration/indices-administration.md)
+  * [Cluster Administration](java-api-administration/cluster-administration.md)
 
 ## 参考
 

aggregations/metrics-aggregations.md

@@ -62,7 +62,7 @@ import org.elasticsearch.search.aggregations.metrics.max.Max;
 
 ```
 // sr is here your SearchResponse object
-Min agg = sr.getAggregations().get("agg");
+Max agg = sr.getAggregations().get("agg");
 double value = agg.getValue();
 ```
 

client.md

@@ -0,0 +1,27 @@
+## Client
+
+Java 客户端连接 Elasticsearch
+
+一个是`TransportClient`，一个是`NodeClient`，还有一个`XPackTransportClient`
+
+- TransportClient：
+
+作为一个外部访问者，请求ES的集群，对于集群而言，它是一个外部因素。
+
+
+- NodeClient
+
+作为ES集群的一个节点，它是ES中的一环，其他的节点对它是感知的。
+
+- XPackTransportClient：
+
+服务安装了 `x-pack` 插件
+
+> 重要：客户端版本应该和服务端版本保持一致
+
+> TransportClient旨在被Java高级REST客户端取代，该客户端执行HTTP请求而不是序列化的Java请求。 在即将到来的Elasticsearch版本中将不赞成使用TransportClient，建议使用Java高级REST客户端。
+
+
+> 上面的警告比较尴尬，但是在 5xx版本中使用还是没有问题的，可能使用rest 客户端兼容性更好做一些。
+
+[Elasticsearch Java Rest API 手册](https://www.gitbook.com/book/quanke/elasticsearch-java-rest)

dependency.md

@@ -6,7 +6,8 @@
 Elasticsearch Java API包已经上传到 [Maven Central](http://search.maven.org/#search%7Cga%7C1%7Ca%3A%22elasticsearch%22)
 
 在`pom.xml`文件中增加：
-> 版本号选择自己合适的。
+
+> transport 版本号最好就是与Elasticsearch版本号一致。
 
 ```
 <dependency>

document-apis.md

@@ -0,0 +1,23 @@
+## Document APIs
+
+本节介绍以下 CRUD API：
+
+
+单文档  APIs
+
+* [Index API](document-apis/index-api.md)
+* [Get API](document-apis/get-api.md)
+* [Delete API](document-apis/delete-api.md)
+* [Delete By Query API](document-apis/delete-by-query-api.md)
+* [Update API](document-apis/update-api.md)
+
+多文档 APIs
+
+* [Multi Get API](document-apis/multi-get-api.md)
+* [Bulk API](document-apis/bulk-api.md)
+* [Using Bulk Processor](document-apis/using-bulk-processor.md)
+
+Multi Get API
+Bulk API
+
+> 注意:所有的单文档的CRUD API，index参数只能接受单一的索引库名称，或者是一个指向单一索引库的alias。

document-apis/bulk-api.md

@@ -1,11 +1,13 @@
 
 ### Bulk API
-Bulk API可以批量插入：
 
+Bulk API，批量插入：
 
 ```
 import static org.elasticsearch.common.xcontent.XContentFactory.*;
+```
 
+```
 BulkRequestBuilder bulkRequest = client.prepareBulk();
 
 // either use client#prepare, or use Requests# to directly build index/delete requests
@@ -32,5 +34,6 @@ bulkRequest.add(client.prepareIndex("twitter", "tweet", "2")
 BulkResponse bulkResponse = bulkRequest.get();
 if (bulkResponse.hasFailures()) {
     // process failures by iterating through each bulk response item
+    //处理失败
 }
 ```

document-apis/get-api.md

@@ -1,11 +1,13 @@
 
 ### Get API
-get api可以通过id查看文档：
+
+根据id查看文档：
 
 ```
 GetResponse response = client.prepareGet("twitter", "tweet", "1").get();
 
 ```
+
 更多请查看 [rest get API](https://www.elastic.co/guide/en/elasticsearch/reference/5.6/docs-get.html) 文档
 
 #### 配置线程

document-apis/update-api.md

@@ -1,6 +1,5 @@
 
 ### Update API
-更新索引
 
 有两种方式更新索引：
 - 创建 `UpdateRequest`,通过client发送；
@@ -22,6 +21,8 @@ client.update(updateRequest).get();
 
 #### 使用 `prepareUpdate()` 方法
 
+> 这里官方的示例有问题，new Script（）参数错误，所以一下代码是我自己写的（2017/11/10）
+
 ```
 client.prepareUpdate("ttl", "doc", "1")
         .setScript(new Script("ctx._source.gender = \"male\""  ,ScriptService.ScriptType.INLINE, null, null))//脚本可以是本地文件存储的，如果使用文件存储的脚本，需要设置 ScriptService.ScriptType.FILE 
@@ -37,7 +38,7 @@ client.prepareUpdate("ttl", "doc", "1")
 
 #### Update by script
 
-使用脚本更新文档
+使用脚本更新文档 
 
 ```
 UpdateRequest updateRequest = new UpdateRequest("ttl", "doc", "1")

document-apis/using-bulk-processor.md

@@ -12,7 +12,9 @@ import org.elasticsearch.action.bulk.BulkProcessor;
 import org.elasticsearch.common.unit.ByteSizeUnit;
 import org.elasticsearch.common.unit.ByteSizeValue;
 import org.elasticsearch.common.unit.TimeValue;
+```
 
+```
 BulkProcessor bulkProcessor = BulkProcessor.builder(
         client,  //增加elasticsearch客户端
         new BulkProcessor.Listener() {
@@ -66,9 +68,9 @@ bulkProcessor.close();
 
 ```
 
-#### 在测试用使用Bulk Processor
+#### 在测试中使用Bulk Processor
 
-可以执行同步方法
+如果你在测试种使用`Bulk Processor`可以执行同步方法
 ```
 BulkProcessor bulkProcessor = BulkProcessor.builder(client, new BulkProcessor.Listener() { /* Listener methods */ })
         .setBulkActions(10000)

query-dsl/full-text-queries.md

@@ -49,7 +49,7 @@ QueryBuilder qb = commonTermsQuery("name",    //field 字段
 
 - 查询语句查询（query_string query）
 
-与lucene查询语句的语法结合的更加紧密的一种查询，允许你在一个查询语句中使用多个 特殊条件关键字（如：AND|OR|NOT ）对多个字段进行查询，当然这种查询仅限专家用户去使用。
+与lucene查询语句的语法结合的更加紧密的一种查询，允许你在一个查询语句中使用多个 特殊条件关键字（如：AND|OR|NOT ）对多个字段进行查询，当然这种查询仅限`专家用户`去使用。
 
 查看[Query String Query](https://www.elastic.co/guide/en/elasticsearch/reference/5.6/query-dsl-query-string-query.html)