1. 简介

IDEA本身是提供测试接口工具的， rest-client/http client，功能很强大，在我日常使用中，完全可以做到不需要打开 postman 的程度。入口如下：

image.png

<center>图一打开方式</center>

点击 Test RESTful Web Service 是打开 Rest Client 工具，可以理解为一个使用了IDEAUI的接口测试工具，相对比较可视化，直接在上面根据实际需求填充值即可，再点左上角的按钮启动测试。

image.png

<center>图二 rest client</center>

图一选项中的第二个选项 Open Http Requests Collection 才是今天的重点，可以直接通过 .http 后缀的文件来请求接口。除了在工具栏进去，也可以在任何地方自己 new 一个出来(图4)，或者点击图二中黄色底的 Convert request to the new format ，也会在 Scratches and consoles 下的 Scratches文件夹 生成一个 .http文件(图五)

image.png

<center>图三 http client</center>

image.png

image.png

2. http client

下面主要讲一下 http client 的使用，简单理解就是 http请求的参数，都可以在这里自行定义。

刚刚进入文件会给你一个例子,第一行很容易理解，选择请求方式(GET、POST、PUT等) 以及请求地址，这是必填项；第二行开始并不一定是要有的，不给的话就根据你的请求方式按照默认参数来给

GET http://localhost:8080/resources
Accept: */*
Cache-Control: no-cache

2.1 普通请求

请求成功之后会在在下方控制台显示请求的内容，以及结果，并在 .http 文件的对应请求下方留有一条历史记录，方便查看(如图六)

image.png

<center>图六 http client运行效果</center>

2.2 变量请求

系统经常会部署在不同的环境之中，http client 同时也支持根据不同的环境修改参数，支持的参数有：

请求ip，端口和路径
查询参数或值
请求头的值
在外部文件为请求体提供任意值

支持的环境变量定义文件有具体的命名方式，并且需要跟 .http文件在同一目录下（Scratches and consoles文件夹下面的只能普通请求），命名也有要求，需要是下面的其中之一：

rest-client.env.json
http-client.env.json
rest-client.private.env.json
http-client.private.en.json

上述文件中带private的文件不表示是一个私人的文件，可能包括密码，令牌，证书等敏感信息，默认情况下，此文件被添加到VCS忽略文件列表中。使用如下（内容是 Json 格式）：

image.png

<center>图七环境变量文件设置</center>

image.png

<center>图八运行时选择</center>

如图七图八，在设置完环境变量之后运行时就可以选择相关的环境变量传入请求中，直接运行即可

3. 使用小技巧

3.1 语法

注释使用 // 或者 #
分开请求用 ###
如果不想要生成日志
脚本以>开头，将逻辑写在 {% %} 中，可以调用client对象

image.png

<center>图九不记录日志</center>

3.2 快捷键

快捷键	说明
gtr	生成一个get请求
gtrp	生成一个get请求，外加参数
ptr	生成一个post请求，格式是application/json
ptrt	生成一个post请求，格式是application/x-www-form-urlencoded
mptr	生成一个post请求，表单提交
fptr	生成一个post请求，文件上传

###
# gtr
GET http://localhost:80/api/item
Accept: application/json

### 
# gtrp 
GET http://localhost:80/api/item?id=99
Accept: application/json

###
# prt
POST http://localhost:80/api/item
Content-Type: application/json

{}

###
#ptrp
POST http://localhost:80/api/item
Content-Type: application/x-www-form-urlencoded

id=99&content=new-element

###
# mptr
POST http://localhost:80/api/item
Content-Type: multipart/form-data; boundary=WebAppBoundary

--WebAppBoundary
Content-Disposition: form-data; name="field-name"

field-value
--WebAppBoundary--

###
# fprt
POST http://localhost:80/api/item
Content-Type: multipart/form-data; boundary=WebAppBoundary

--WebAppBoundary
Content-Disposition: form-data; name="field-name" filename="file.txt"

< ./relative/path/to/local_file.txt
--WebAppBoundary--

###