平时都是用postman来调接口，有时候也会用到swagger。用swagger还可以，直接在浏览器上开个页面即可，但是postman就不行了，需要单独的运行，个人感觉postman还是比较占内存的。最近和一个其他组同事联调，发现他们使用的是idea自带的HTTP Client工具，感觉挺好用的，调接口不需要切浏览器，切应用。直接在idea中可以完成。挺酷(zhuang)炫(bi)的，所以准备学习一下，在网上也找到了这方面的很多文章，在研究的时候都有借鉴，多谢各位爱分享的博友们。
界面化操作很简单，都是类似postman等其他发送请求的客户端工具，这里就不具体介绍使用规则啦。
打开入口：工具栏(idea顶上的一行工具里面)->Tools->HTTP Client
在文件里面编写请求所需要的地址、参数、请求头等信息，还可以通过全局变量来设置共用的信息。既然是使用idea，可以使用快捷键是必须滴。下面来一一的介绍。
首先需要创建一个编写http请求信息的文件，可以在resources目录下建一个目录http，右击http->New->HTTP Request，输入文件名称即可创建文件。具体这个文件放在什么地方没有特殊的要求，但是个人习惯方在resources目录下，再有个http目录便于管理，下面也基于这个目录来说。建好的文件名是httpClient.http。
创建文件成功后，文件上面会有几行注释，这几行注释不多做解释，自己翻译一下即可。里面有快捷键的说明，下面我会再具体使用的时候说明。
附文件初始注释说明信息：
# For a quick start check out our HTTP Requests collection (Tools|HTTP Client|Open HTTP Requests Collection).
#
# Following HTTP Request Live Templates are available:
# * 'gtrp' and 'gtr' create a GET request with or without query parameters;
# * 'ptr' and 'ptrp' create a POST request with a simple or parameter-like body;
# * 'mptr' and 'fptr' create a POST request to submit a form with a text or file field (multipart/form-data);
@PostMapping("addArticle")
@ResponseBody
public String addArticle(@RequestBody ArticleReqDTO reqDTO) {
log.info("Execute ArticleController.addArticle，reqDTO=【{}】", reqDTO);
return "add success";
}
httpClient.http内代码：### 第一行：POST请求，请求地址
### 第二行：请求头信息，多个请求头信息依次写下去(第三行、第四行……)
### 第N行：写具体的请求体，这里是JSON串，请求头和请求体之间要空出一行
POST http://localhost:8282/api/addArticle
Content-Type: application/json
{
"title":"文章标题",
"abst":"文章摘要",
"categoryId":1,
"authorName":"IT-CRUD"
}
书写是很简单的，httpClient.http编写也不难，细节注意点就可以。
快捷键ptr，输入会有提示，直接回车即可。
@PostMapping(value = "updateArticle_form", produces = MediaType.APPLICATION_FORM_URLENCODED_VALUE) //指定请求数据格式是form表单
@ResponseBody
public String updateArticle_form(@ModelAttribute ArticleReqDTO reqDTO) {
log.info("Execute ArticleController.updateArticle_form，reqDTO=【{}】", reqDTO);
return "update success";
}
httpClient.http内代码：### 修改文章(form表单提交)
POST http://localhost:8282/api/updateArticle_form
Content-Type: application/x-www-form-urlencoded
id=1&title=文章标题&abst=文章摘要&categoryId=1&authorName=IT-CRUD
这个具体的说明就没写了，基本都是相同的格式，参考上一个示例，但是这里需要注意的是字段名和字段值不能加引号。如"id"=1&"title"="文章标题"，这样会报错的。生成此结构使用快捷键ptrp。
另外一个注意点： 每个请求后面都要加###结束，换句话说，就是两个请求之间用###分隔，否则会直接报错。
@GetMapping("getList")
@ResponseBody
public List<ArticleVO> getList(@RequestParam("keywords") String keywords
, @RequestParam("categoryId") Integer categoryId) {
log.info("Execute ArticleController.updateArticle_form，keywords=【{}】,categoryId=【{}】", keywords, categoryId);
List<ArticleVO> vos = Lists.newArrayList();
vos.add(ArticleVO.builder().abst("这是个摘要--1").authorName("IT-CRUD")
.categoryId(1).categoryName("Spring").createTime(new Date()).title("这是一个标题--1")
.build());
vos.add(ArticleVO.builder().abst("这是个摘要--2").authorName("IT-CRUD")
.categoryId(1).categoryName("Spring").createTime(new Date()).title("这是一个标题--2")
.build());
vos.add(ArticleVO.builder().abst("这是个摘要--3").authorName("IT-CRUD")
.categoryId(1).categoryName("Spring").createTime(new Date()).title("这是一个标题--3")
.build());
return vos;
}
httpClient.http内代码：### 查询文章列表
GET http://localhost:8282/api/getList?keywords=标题&categoryId=1
Accept: application/json
GET请求和POST请求一样，也是有两个快捷键，分别是gtr和gtrp，第一个是生成无参数的模板，第二个是生成有参数。区别就是第二种会在请求地址后面加上?id=xx这种参数。
常用的几种请求方式上面已经清楚啦，下面来看一下全局变量配置。这个全局的变量和spring的配置文件是完全分开的，没有关联。
配置文件的名称和内容格式都有特殊要求，名称必须是rest-client.env.json或者http-client.env.json。
配置文件格式：
{
"dev":{
"host":"http://localhost:8282"
## 其他属性 ……
},
"st":{
"host":"http://cs.itcrud.com"
## 其他属性 ……
}
}
格式不多说，官方规定，就如同spring的yml配置文件，就要按照它的来，没商量。
从json串可以看出这里可以配置多个环境，这个就很方便啦。在使用postman的时候就会有环境地址切换的问题，本地、测试等环境来回切换地址很头疼，如果直接配置两套，又感觉很傻。如果使用idea的这个http client就方便，提前配好，一劳永逸。
具体怎么使用呢？很简单，在httpClient.http文件里面修改如下：
# 修改前
GET http://localhost:8282/api/getList?keywords=标题&categoryId=1
# 修改后，这个host就指向配置文件中的host对应的值
GET {{host}}/api/getList?keywords=标题&categoryId=1
httpClient.http文件中每个请求前面都有个绿色的三角形（运行按钮），可以直接点击运行，点击后会提示你选择哪个环境的配置运行。如图：
整体基本写完啦，但是细心的可能会注意到还有两个快捷键没有介绍，那就是mptr和fptr，都是文件上传的快捷键，具体待研究，尝试了一次没有弄好，请求是通的，但是接口接受文件的对象是空。(研究完后期会在这篇文章里面更新)
另外还有一个挺酷的功能，可以自己写脚本，对执行的结果进行处理，如响应是500，控制台应该显示什么信息；还可以根据响应的值给予特殊的处理等。自动义脚本功能感觉用不上，就没有多去研究，脚本看起来并不是很难，如果你很感兴趣可以研究一下官方文档。
官方文档：https://www.jetbrains.com/help/idea/http-client-in-product-code-editor.html
码云（gitee）：https://gitee.com/itcrud/itcrud-note/tree/master/itcrud-note-1-2