![Elasticsearch实战与原理解析](https://wfqqreader-1252317822.image.myqcloud.com/cover/554/30918554/b_30918554.jpg)
4.2 提交请求
在创建好客户端之后,执行请求之前还需构建请求对象。用户可以通过调用客户端的performRequest和performRequestAsync方法来发送请求。
其中,performRequest是同步请求方法,它将阻塞调用线程,并在请求成功时返回响应,或者在请求失败时引发异常。
而performRequestAsync是异步方法,它接收一个ResponseListener对象作为参数。如果请求成功,则该参数使用响应进行调用;如果请求失败,则使用异常进行调用。
1.构建请求对象Request
请求对象Request的请求方式与The HTTP的请求方式相同,如GET、POST、HEAD等,代码如下所示:
![](https://epubservercos.yuewen.com/A9D91A/16793577104229806/epubprivate/OEBPS/Images/38380_95_3.jpg?sign=1734440736-FqYPtnvD0093DtudJM7MbDNLBxrF94h8-0-a7b38dce40a6271a7994c106d86d1e91)
2.请求的执行
在构建请求(Request)后,即可执行请求。请求有同步执行和异步执行两种方式。下面将分别展示如何使用performRequest方法和performRequestAsync方法发送请求。
同步方式
当以同步方式执行Request时,客户端会等待Elasticsearch服务器返回的查询结果Response。在收到Response后,客户端继续执行相关的逻辑代码。以同步方式执行的代码如下所示,我们仍然构建三层代码,分别是Controller层、Service层和ServiceImpl实现层。
其中,在Controller层的MeetElasticSearchController类中添加如下代码:
![](https://epubservercos.yuewen.com/A9D91A/16793577104229806/epubprivate/OEBPS/Images/38380_96_2.jpg?sign=1734440736-SYU9RWTMVJIjm2LgkYlRC2OedHKrwtUd-0-858c6a5b242eb6ee289aa75f4325f9f1)
随后,在Service层的MeetElasticSearchService类中添加如下代码:
![](https://epubservercos.yuewen.com/A9D91A/16793577104229806/epubprivate/OEBPS/Images/38380_96_3.jpg?sign=1734440736-d3TVk7VOEWEicqHt4sMIDH24bi78IIlz-0-82be3b7fb0e23fcc8ae5b0aa0c940263)
在ServiceImpl实现层的MeetElasticSearchServiceImpl类中添加如下代码:
![](https://epubservercos.yuewen.com/A9D91A/16793577104229806/epubprivate/OEBPS/Images/38380_96_4.jpg?sign=1734440736-A2aTbivbfHLaA77pUg1tZbiiS1zo2imI-0-eadefe3da3179cea536a2399c17e4a2d)
随后编译工程,在工程根目录下输入如下命令:
![](https://epubservercos.yuewen.com/A9D91A/16793577104229806/epubprivate/OEBPS/Images/38380_97_2.jpg?sign=1734440736-iKNkZ7fmbuOHuzKuYUOaKT0Vg8p0S7em-0-cf7ae5ea2e1daed1a96a49bacb53acc1)
通过如下命令启动工程服务:
![](https://epubservercos.yuewen.com/A9D91A/16793577104229806/epubprivate/OEBPS/Images/38380_97_3.jpg?sign=1734440736-67j8IzILWbtXowHmMhLvmpn6H002GOAL-0-f311055b745dcdead875b0c4ec53d019)
在工程服务启动后,在浏览器中通过调用如下接口查看Elasticsearch客户端的连接情况:
![](https://epubservercos.yuewen.com/A9D91A/16793577104229806/epubprivate/OEBPS/Images/38380_97_4.jpg?sign=1734440736-FDekDV2zFAnXtOKm0YqDlREpOIGN7yEe-0-ea3f14e044a4a99dffe57e47ea14747d)
在浏览器中可以看到请求发送成功,显示的Response信息如下所示。
![](https://epubservercos.yuewen.com/A9D91A/16793577104229806/epubprivate/OEBPS/Images/38380_97_5.jpg?sign=1734440736-Ssnu4HqdAsAEXeEIwrEh06ifmRmhnQl6-0-53c100f7b8c473c57c3a354ae3131b60)
异步方式
当以异步方式执行请求时,初级客户端不必同步等待请求结果的返回,可以直接向接口调用方返回异步接口执行成功的结果。
为了处理异步返回的响应信息或处理在请求执行过程中引发的异常信息,用户需要指定监听器。以异步方式调用的代码如下所示。我们在ServiceImpl实现层的MeetElasticSearchServiceImpl类中添加如下代码:
![](https://epubservercos.yuewen.com/A9D91A/16793577104229806/epubprivate/OEBPS/Images/38380_97_6.jpg?sign=1734440736-loDxRGLvKp5DPNVtif3ymhK26NySPju8-0-23ab9273ba23896a2f96d15f6a3b0768)
在异步请求处理后,如果请求执行成功,则调用ResponseListener类中的onResponse方法进行相关逻辑的处理;如果请求执行失败,则调用ResponseListener类中的onFailure方法进行相关逻辑的处理。
3.可选参数配置
不论同步请求,还是异步请求,我们都可以在请求中添加参数,添加方法如下所示:
![](https://epubservercos.yuewen.com/A9D91A/16793577104229806/epubprivate/OEBPS/Images/38380_98_2.jpg?sign=1734440736-nqvV3LPD8n8GT3wYwORpEzNw2G5XNfFd-0-9ca440a7ba24ea6efb32f68ad470b251)
可以将请求的主体设置为任意HttpEntity,设置方法如下所示:
![](https://epubservercos.yuewen.com/A9D91A/16793577104229806/epubprivate/OEBPS/Images/38380_98_3.jpg?sign=1734440736-wtZLwmMHSRoWcS8X3NmtUFsyMvc6cPVN-0-704def9ead00a1dfe962cf2d5107b88e)
还可以将其设置为一个字符串,在Elasticsearch中,默认使用application/json的内容格式,设置方法如下所示:
![](https://epubservercos.yuewen.com/A9D91A/16793577104229806/epubprivate/OEBPS/Images/38380_98_4.jpg?sign=1734440736-ZRSgalXyY2hlQYfOtLr3g8pG0VgTmkY0-0-13b33fd3ff67a475a71e4c1a7a99fc1c)
此外,Request还有一些可选的请求构建选项,通过RequestOptions来实现。
需要说明的是,在RequestOptions类中保存的请求,可以在同一应用程序的多个请求之间共享。因此用户可以创建一个单实例,然后在所有请求之间共享。具体方法如下所示:
![](https://epubservercos.yuewen.com/A9D91A/16793577104229806/epubprivate/OEBPS/Images/38380_98_5.jpg?sign=1734440736-YPRiLoiBgtgykJJ8G42yHN11y2z3TEPU-0-6f3d69a0f935b1e3d833c8d63b5551ac)
上述代码中的TOKEN表示添加所有请求所需的任何头。
而AddHeader用于授权或在Elasticsearch前使用代理所需的头信息。在使用时,不需要设置Content-Type头,因为客户端将自动在请求的HttpEntity中设置Content-Type头。
在创建好RequestOptions单实例COMMON_OPTIONS后,我们就可以在发出请求时使用它了,使用方法如下所示:
![](https://epubservercos.yuewen.com/A9D91A/16793577104229806/epubprivate/OEBPS/Images/38380_99_2.jpg?sign=1734440736-OASWJ07Jqvptc5Hgkjemvy3NPlp4ML8e-0-cf3a9c7d5680ba923bcdb0c26caa4877)
Elasticsearch允许用户根据每个请求定制这些选项,如添加一个额外的标题:
![](https://epubservercos.yuewen.com/A9D91A/16793577104229806/epubprivate/OEBPS/Images/38380_99_3.jpg?sign=1734440736-pGv1G1A2GYcDBq8PEUi6VCj02Pyoclfr-0-b6fa953d87a3273ca6c6bf6b84ed9d90)
RequestOptions在ServiceImpl实现层的MeetElasticSearchServiceImpl类中的代码如下所示:
![](https://epubservercos.yuewen.com/A9D91A/16793577104229806/epubprivate/OEBPS/Images/38380_99_4.jpg?sign=1734440736-joxTcj6lKGQXuIlGjn9u9VcPdjNvVLnm-0-c14dd9c74cd5dd780ee1cadc1ff1dcca)
4.多个并行异步操作
除单个操作的执行外,Elasticsearch的客户端还可以并行执行许多操作。下面通过ServiceImpl实现层MeetElasticSearchServiceImpl类中的示例,展示如何对多文档进行并行索引。代码如下:
![](https://epubservercos.yuewen.com/A9D91A/16793577104229806/epubprivate/OEBPS/Images/38380_100_2.jpg?sign=1734440736-hC5Z9raIKDbZVQT3WcUcn2EJaocrEpML-0-558f22aeef24d654b026ca762d1b3d4f)