Skip to content

Navigation Menu

Sign in
Appearance settings

Search code, repositories, users, issues, pull requests...

Provide feedback

We read every piece of feedback, and take your input very seriously.

Saved searches

Use saved searches to filter your results more quickly

Sign up
Appearance settings

Commit 4d3e703

Browse files
author
quanke
committed
# Conflicts: # README.md
2 parents c0a335b + 596e029 commit 4d3e703

15 files changed

+145
-20
lines changed

‎README.md‎

Lines changed: 20 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -4,23 +4,42 @@
44

55
本书由 [全科](http://woquanke.com) 翻译,并且整理成电子书,支持PDF,ePub,Mobi格式,方便大家下载阅读。
66

7+
78
阅读地址:[http://woquanke.com/esjava/](http://woquanke.com/esjava/)
89

910
下载地址:[https://www.gitbook.com/book/quanke/elasticsearch-java](https://www.gitbook.com/book/quanke/elasticsearch-java)
1011

1112
github地址:[https://github.com/quanke/elasticsearch-java](https://github.com/quanke/elasticsearch-java)
1213

14+
15+
16+
gitee 地址:[https://gitee.com/quanke/elasticsearch-java](https://gitee.com/quanke/elasticsearch-java)
17+
配套示例代码:[https://gitee.com/quanke/elasticsearch-java-study](https://gitee.com/quanke/elasticsearch-java-study)
18+
19+
1320
编辑:[http://woquanke.com](http://woquanke.com)
1421

1522
编辑整理辛苦,还望大神们点一下star ,抚平我虚荣的心
1623

24+
> 不只是官方文档的翻译,还包含使用实例,包含我们使用踩过的坑
25+
26+
## 推荐阅读
27+
28+
[Elasticsearch Java Rest 手册](https://www.gitbook.com/book/quanke/elasticsearch-java-rest/) 已经完成大部分
29+
30+
1731
更多请关注我的微信公众号:
1832

1933
![](/assets/qrcode_for_gh_26893aa0a4ea_258.jpg)
2034

2135

36+
下面几个章节应用的相对少,所以会延后更新,计划先把 配套实例 [ elasticsearch-java-study](https://gitee.com/quanke/elasticsearch-java-study) 项目写完;
2237

23-
38+
* [Indexed Scripts API](indexed-scripts-api.md)
39+
* [Script Language](indexed-scripts-api/script-language.md)
40+
* [Java API Administration](java-api-administration.md)
41+
* [Indices Administration](java-api-administration/indices-administration.md)
42+
* [Cluster Administration](java-api-administration/cluster-administration.md)
2443

2544
## 参考
2645

‎aggregations/metrics-aggregations.md‎

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -62,7 +62,7 @@ import org.elasticsearch.search.aggregations.metrics.max.Max;
6262

6363
```
6464
// sr is here your SearchResponse object
65-
Min agg = sr.getAggregations().get("agg");
65+
Max agg = sr.getAggregations().get("agg");
6666
double value = agg.getValue();
6767
```
6868

‎client.md‎

Lines changed: 27 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,27 @@
1+
## Client
2+
3+
Java 客户端连接 Elasticsearch
4+
5+
一个是`TransportClient`,一个是`NodeClient`,还有一个`XPackTransportClient`
6+
7+
- TransportClient:
8+
9+
作为一个外部访问者,请求ES的集群,对于集群而言,它是一个外部因素。
10+
11+
12+
- NodeClient
13+
14+
作为ES集群的一个节点,它是ES中的一环,其他的节点对它是感知的。
15+
16+
- XPackTransportClient:
17+
18+
服务安装了 `x-pack` 插件
19+
20+
> 重要:客户端版本应该和服务端版本保持一致
21+
22+
> TransportClient旨在被Java高级REST客户端取代,该客户端执行HTTP请求而不是序列化的Java请求。 在即将到来的Elasticsearch版本中将不赞成使用TransportClient,建议使用Java高级REST客户端。
23+
24+
25+
> 上面的警告比较尴尬,但是在 5xx版本中使用还是没有问题的,可能使用rest 客户端兼容性更好做一些。
26+
27+
[Elasticsearch Java Rest API 手册](https://www.gitbook.com/book/quanke/elasticsearch-java-rest)

‎dependency.md‎

Lines changed: 2 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -6,7 +6,8 @@
66
Elasticsearch Java API包已经上传到 [Maven Central](http://search.maven.org/#search%7Cga%7C1%7Ca%3A%22elasticsearch%22)
77

88
`pom.xml`文件中增加:
9-
> 版本号选择自己合适的。
9+
10+
> transport 版本号最好就是与Elasticsearch版本号一致。
1011
1112
```
1213
<dependency>

‎document-apis.md‎

Lines changed: 23 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,23 @@
1+
## Document APIs
2+
3+
本节介绍以下 CRUD API:
4+
5+
6+
单文档 APIs
7+
8+
* [Index API](document-apis/index-api.md)
9+
* [Get API](document-apis/get-api.md)
10+
* [Delete API](document-apis/delete-api.md)
11+
* [Delete By Query API](document-apis/delete-by-query-api.md)
12+
* [Update API](document-apis/update-api.md)
13+
14+
多文档 APIs
15+
16+
* [Multi Get API](document-apis/multi-get-api.md)
17+
* [Bulk API](document-apis/bulk-api.md)
18+
* [Using Bulk Processor](document-apis/using-bulk-processor.md)
19+
20+
Multi Get API
21+
Bulk API
22+
23+
> 注意:所有的单文档的CRUD API,index参数只能接受单一的索引库名称,或者是一个指向单一索引库的alias。

‎document-apis/bulk-api.md‎

Lines changed: 4 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,11 +1,13 @@
11

22
### Bulk API
3-
Bulk API可以批量插入:
43

4+
Bulk API,批量插入:
55

66
```
77
import static org.elasticsearch.common.xcontent.XContentFactory.*;
8+
```
89

10+
```
911
BulkRequestBuilder bulkRequest = client.prepareBulk();
1012
1113
// either use client#prepare, or use Requests# to directly build index/delete requests
@@ -32,5 +34,6 @@ bulkRequest.add(client.prepareIndex("twitter", "tweet", "2")
3234
BulkResponse bulkResponse = bulkRequest.get();
3335
if (bulkResponse.hasFailures()) {
3436
// process failures by iterating through each bulk response item
37+
//处理失败
3538
}
3639
```

‎document-apis/get-api.md‎

Lines changed: 3 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,11 +1,13 @@
11

22
### Get API
3-
get api可以通过id查看文档:
3+
4+
根据id查看文档:
45

56
```
67
GetResponse response = client.prepareGet("twitter", "tweet", "1").get();
78
89
```
10+
911
更多请查看 [rest get API](https://www.elastic.co/guide/en/elasticsearch/reference/5.6/docs-get.html) 文档
1012

1113
#### 配置线程

‎document-apis/update-api.md‎

Lines changed: 3 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,5 @@
11

22
### Update API
3-
更新索引
43

54
有两种方式更新索引:
65
- 创建 `UpdateRequest`,通过client发送;
@@ -22,6 +21,8 @@ client.update(updateRequest).get();
2221

2322
#### 使用 `prepareUpdate()` 方法
2423

24+
> 这里官方的示例有问题,new Script()参数错误,所以一下代码是我自己写的(2017年11月10日)
25+
2526
```
2627
client.prepareUpdate("ttl", "doc", "1")
2728
.setScript(new Script("ctx._source.gender = \"male\"" ,ScriptService.ScriptType.INLINE, null, null))//脚本可以是本地文件存储的,如果使用文件存储的脚本,需要设置 ScriptService.ScriptType.FILE
@@ -37,7 +38,7 @@ client.prepareUpdate("ttl", "doc", "1")
3738

3839
#### Update by script
3940

40-
使用脚本更新文档
41+
使用脚本更新文档
4142

4243
```
4344
UpdateRequest updateRequest = new UpdateRequest("ttl", "doc", "1")

‎document-apis/using-bulk-processor.md‎

Lines changed: 4 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -12,7 +12,9 @@ import org.elasticsearch.action.bulk.BulkProcessor;
1212
import org.elasticsearch.common.unit.ByteSizeUnit;
1313
import org.elasticsearch.common.unit.ByteSizeValue;
1414
import org.elasticsearch.common.unit.TimeValue;
15+
```
1516

17+
```
1618
BulkProcessor bulkProcessor = BulkProcessor.builder(
1719
client, //增加elasticsearch客户端
1820
new BulkProcessor.Listener() {
@@ -66,9 +68,9 @@ bulkProcessor.close();
6668
6769
```
6870

69-
#### 在测试用使用Bulk Processor
71+
#### 在测试中使用Bulk Processor
7072

71-
可以执行同步方法
73+
如果你在测试种使用`Bulk Processor`可以执行同步方法
7274
```
7375
BulkProcessor bulkProcessor = BulkProcessor.builder(client, new BulkProcessor.Listener() { /* Listener methods */ })
7476
.setBulkActions(10000)

‎query-dsl/full-text-queries.md‎

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -49,7 +49,7 @@ QueryBuilder qb = commonTermsQuery("name", //field 字段
4949

5050
- 查询语句查询(query_string query)
5151

52-
与lucene查询语句的语法结合的更加紧密的一种查询,允许你在一个查询语句中使用多个 特殊条件关键字(如:AND|OR|NOT )对多个字段进行查询,当然这种查询仅限专家用户去使用
52+
与lucene查询语句的语法结合的更加紧密的一种查询,允许你在一个查询语句中使用多个 特殊条件关键字(如:AND|OR|NOT )对多个字段进行查询,当然这种查询仅限`专家用户`去使用
5353

5454
查看[Query String Query](https://www.elastic.co/guide/en/elasticsearch/reference/5.6/query-dsl-query-string-query.html)
5555

0 commit comments

Comments
(0)

AltStyle によって変換されたページ (->オリジナル) /