zoukankan      html  css  js  c++  java
  • 使用CURL与ElasticSearch服务进行通信

    其他高级的语言统一使用RESTful API和JSON,Java开发者可使用Java API。

    Java API

    如果你正在使用 Java,在代码中你可以使用 Elasticsearch 内置的两个客户端:

    节点客户端(Node client)
    节点客户端作为一个非数据节点加入到本地集群中。换句话说,它本身不保存任何数据,但是它知道数据在集群中的哪个节点中,并且可以把请求转发到正确的节点。
    传输客户端(Transport client)
    轻量级的传输客户端可以将请求发送到远程集群。它本身不加入集群,但是它可以将请求转发到集群中的一个节点上。

    两个 Java 客户端都是通过 9300 端口并使用 Elasticsearch 的原生 传输 协议和集群交互。集群中的节点通过端口 9300 彼此通信。如果这个端口没有打开,节点将无法形成一个集群。

    Java 客户端作为节点必须和 Elasticsearch 有相同的 主要 版本;否则,它们之间将无法互相理解。

    更多的 Java 客户端信息可以在 Elasticsearch Clients 中找到。

    RESTful API with JSON over HTTP

    所有其他语言可以使用 RESTful API 通过端口 9200 和 Elasticsearch 进行通信,你可以用你最喜爱的 web 客户端访问 Elasticsearch 。事实上,正如你所看到的,你甚至可以使用 curl 命令来和 Elasticsearch 交互。

    注:想了解curl可参考文章:https://www.cnblogs.com/cangqiongbingchen/p/10180535.html

    Elasticsearch 为以下语言提供了官方客户端--Groovy、JavaScript、.NET、 PHP、 Perl、 Python 和 Ruby—​还有很多社区提供的客户端和插件,所有这些都可以在 Elasticsearch Clients 中找到。

    一个 Elasticsearch 请求和任何 HTTP 请求一样由若干相同的部件组成:

    curl -X<VERB> '<PROTOCOL>://<HOST>:<PORT>/<PATH>?<QUERY_STRING>' -d '<BODY>'

    < > 标记的部件:

    VERB

    适当的 HTTP 方法谓词 : GETPOSTPUTHEAD 或者 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/'

    在书中剩余的部分,我们将用缩写格式来展示这些 curl 示例,所谓的缩写格式就是省略请求中所有相同的部分,例如主机名、端口号以及 curl 命令本身。而不是像下面显示的那样用一个完整的请求:

    curl -XGET 'localhost:9200/_count?pretty' -d '
    {
        "query": {
            "match_all": {}
        }
    }'

    我们将用缩写格式显示:

    GET /_count
    {
        "query": {
            "match_all": {}
        }
    }

    事实上, Sense 控制台 也使用这样相同的格式。如果你正在阅读这本书的在线版本,可以通过点击 Sense 链接视图在 Sense 上打开和运行示例代码。

    原文链接:https://www.elastic.co/guide/cn/elasticsearch/guide/current/_talking_to_elasticsearch.html

    Keep moving forwards~
  • 相关阅读:
    中国石油大学天梯赛真题模拟第二场
    AtCoder Grand Contest 016 B
    POJ1011 Sticks
    UPC7817: Supermarket
    UPC5652: Ants on a Circle
    石大iCal课表使用指南
    UPC10582: Cowpatibility
    UPC11079: 小P的决斗 POJ3244 Difference between Triplets
    UPC6976:矩阵模板(二维哈希)
    知识点2-3:视图的职责
  • 原文地址:https://www.cnblogs.com/-X-peng/p/15060429.html
Copyright © 2011-2022 走看看