# 基础
# 安装
略
# 使用 demo
如果你正在使用 Java，在代码中你可以使用 Elasticsearch 内置的两个客户端：
节点客户端（Node client）
节点客户端作为一个非数据节点加入到本地集群中。换句话说，它本身不保存任何数据，但是它知道数据在集群中的哪个节点中，并且可以把请求转发到正确的节点。
传输客户端（Transport client）
轻量级的传输客户端可以将请求发送到远程集群。它本身不加入集群，但是它可以将请求转发到集群中的一个节点上。
两个 Java 客户端都是通过 9300 端口并使用 Elasticsearch 的原生 传输 协议和集群交互。集群中的节点通过端口 9300 彼此通信。如果这个端口没有打开，节点将无法形成一个集群。
如果用的是其他语言，那么 Elasticsearch 支持使用 RESTful API 通过端口 9200 与 Elasticsearch 进行通信，可以用 web 客户端，甚至可以使用 curl 命令。
一个 Elasticsearch 请求和任何 HTTP 请求一样由若干相同的部件组成：
curl -X<VERB> '<PROTOCOL>://<HOST>:<PORT>/<PATH>?<QUERY_STRING>' -d '<BODY>' |
被 < > 标记的部件：
VERB | 适当的 HTTP 方法 或 谓词 : GET 、 POST 、 PUT 、 HEAD 或者 DELETE 。 |
|---|---|
PROTOCOL | http 或者 https （如果你在 Elasticsearch 前面有一个 https 代理） |
HOST | Elasticsearch 集群中任意节点的主机名，或者用 localhost 代表本地机器上的节点。 |
PORT | 运行 Elasticsearch HTTP 服务的端口号，默认是 9200 。 |
PATH | API 的终端路径（例如 _count 将返回集群中文档数量）。Path 可能包含多个组件，例如： _cluster/stats 和 _nodes/stats/jvm 。 |
QUERY_STRING | 任意可选的查询字符串参数 (例如 ?pretty 将格式化地输出 JSON 返回值，使其更容易阅读) |
BODY | 一个 JSON 格式的请求体 (如果请求需要的话) |
例子
curl -XGET 'http://localhost:9200/_count?pretty' -d ' | |
{ | |
"query": { | |
"match_all": {} | |
} | |
} | |
' |
Elasticsearch 返回一个 HTTP 状态码（例如： 200 OK ）和（除 HEAD 请求）一个 JSON 格式的返回值。前面的 curl 请求将返回一个像下面一样的 JSON 体：
{ | |
"count" : 0, | |
"_shards" : { | |
"total" : 5, | |
"successful" : 5, | |
"failed" : 0 | |
} | |
} |
在返回结果中没有看到 HTTP 头信息是因为我们没有要求 curl 显示它们。想要看到头信息，需要结合 -i 参数来使用 curl 命令：
curl -i -XGET 'localhost:9200/' |
Elasticsearch 使用 JavaScript Object Notation（ JSON）作为文档的序列化格式。
demo
输入数据：我们可以通过一条命令完成所有这些动作：
PUT /megacorp/employee/1 | |
{ | |
"first_name" : "John", | |
"last_name" : "Smith", | |
"age" : 25, | |
"about" : "I love to go rock climbing", | |
"interests": [ "sports", "music" ] | |
} |
url：megacorp ：索引employee ：类型1 ：特定雇员的 ID
检索文档：
GET /megacorp/employee/1 | |
//return | |
{ | |
"_index" : "megacorp", | |
"_type" : "employee", | |
"_id" : "1", | |
"_version" : 1, | |
"found" : true, | |
"_source" : { | |
"first_name" : "John", | |
"last_name" : "Smith", | |
"age" : 25, | |
"about" : "I love to go rock climbing", | |
"interests": [ "sports", "music" ] | |
} | |
} |
