前言

內(nèi)部調(diào)試是每個(gè)軟件開發(fā)的從業(yè)替代不可少的一項(xiàng)技能，一個(gè)項(xiàng)目的完成，可能接口測試調(diào)試的時(shí)間比真正開發(fā)寫代碼的時(shí)間還要多，幾乎是每個(gè)開發(fā)的日常工作項(xiàng)。所謂工欲善其事必先利其器，在沒有嘗到IDEA REST真香之前，postman（chrome的單個(gè)插件）確實(shí)是一個(gè)非常不錯(cuò)的選擇，具有完備的REST Client功能和請求歷史記錄功能。但是當(dāng)使用了IDEA REST之后，postman就可以丟了，因?yàn)?，IDEA REST Client具有postman的所有功能，而且還有postman沒有的功能，繼續(xù)往下看。

從郵遞員到IDEA REST客戶端

真香定律的原因有如下幾個(gè)：

首先郵遞員的所有功能IDEA REST客戶端都加入了，如REST客戶端控制臺和歷史請求記錄
通常如果能夠在一個(gè)生產(chǎn)工具里完成開發(fā)和調(diào)試的事情，干嘛要切換到另一個(gè)工具呢
然后IDEA REST Client還支持環(huán)境配置區(qū)分的功能，以及接口響應(yīng)斷言和腳本化處理的能力
IDEA REST客戶端的請求配置可以用文件配置描述，所以可以跟隨項(xiàng)目和項(xiàng)目成員共享

IDEA REST客戶端控制臺

從頂部工具欄依次工具-> HTTP客戶端->測試RESTFUL Web服務(wù)：后，IDEA REST客戶端控制臺的界面如下樣式：

可以看到，這個(gè)控制臺展示的功能區(qū)和postman已經(jīng)沒什么區(qū)別了，包括請求方式，請求參數(shù)和請求頭的填充都已經(jīng)包含了，特別說明下的是，如果請求的方式是授權(quán)：基本方式方式認(rèn)證的話，可以點(diǎn)擊下圖所示的按鈕，會插入替換用戶名和密碼的窗口出來，填完后會自動補(bǔ)充到授權(quán)的標(biāo)題里面去

歷史請求記錄

IntelliJ IDEA自動將最近執(zhí)行的50個(gè)請求保存到http-requests-log.http文件中，該文件存儲在項(xiàng)目的.idea / httpRequests /目錄下。使用請求歷史記錄，您可以快速導(dǎo)航到特定響應(yīng)并再次如果從請求歷史記錄再次發(fā)出請求，則其執(zhí)行信息和響應(yīng)輸出的鏈接將添加到請求歷史記錄文件的頂部。

構(gòu)建HTTP請求腳本

上面的歷史記錄就是一個(gè)完整的IDEA REST客戶請求腳本，如果你是從控制臺觸發(fā)的，那么可以直接復(fù)制歷史請求記錄的文件放到項(xiàng)目里作為HTTP請求的腳本，給其他成員共享，如果不是，也可以直接新建一個(gè)。http或.rest結(jié)尾的文件，IDEA會自動識別為HTTP請求腳本。

語法部分

###?演示POST請求
POST?{{baseUrl}}}get?show_env=1
Accept:?application/json

{
???"name":"a"
}
###?演示GET請求

GET?{{baseUrl}}}/post
Content-Type:?application/x-www-form-urlencoded

id=999&value=content

首先通過###三個(gè)井號鍵來分開每個(gè)請求體，然后請求url和header參數(shù)是緊緊挨著的，請求參數(shù)不管是POST的正文傳參還是GET的參數(shù)傳參，都是要換行的

環(huán)境區(qū)分

細(xì)心的你可能發(fā)現(xiàn)了上面的示例代碼，沒有真實(shí)的請求地址，取而代之的，是一個(gè){{baseUrl}}的占位符，這個(gè)就是IDEA REST Client真香的地方，支持從指定的配置文件中獲取到環(huán)境相關(guān)的配置參數(shù)，多個(gè)baseUrl可以通過占位符替換，一些請求的參數(shù)是否和接口環(huán)境相關(guān)的都可以通過配置文件來區(qū)分。

首先在.http的腳本同目錄下創(chuàng)建一個(gè)稱為http-client.private.env.json的文件，然后內(nèi)容如下，一級的鍵值時(shí)采用不同的環(huán)境，、、 dev，uat，pro等，環(huán)境下的對象就是一次HTTP請求中能夠獲取到的環(huán)境變量了，你可以直接在請求的HTTP的腳本中通過{{xx}}占位符的方式獲取到此處配置的參數(shù)

{
??"uat":?{
????"baseUrl":?"http://gateway.xxx.cn/",
????"username":?"",
????"password":?""
??},
??"dev":?{
????"baseUrl":?"http://localhsot:8888/",
????"username":?"",
????"password":?""
??}
}

那么在選擇執(zhí)行請求的時(shí)候，IDEA就會讓你選執(zhí)行那個(gè)環(huán)境的配置，如：

結(jié)果斷言

IDEA REST客戶端可以針對接口的響應(yīng)值進(jìn)行腳本化的斷言處理，立馬從一個(gè)接口調(diào)試工具上升到測試工具了，類似：

###?Successful?test:?check?response?status?is?200
GET?https://httpbin.org/status/200

>?{%
client.test("Request?executed?successfully",?function()?{
??client.assert(response.status?===?200,?"Response?status?is?not?200");
});
%}

結(jié)果值暫存

試想下這樣的場景，當(dāng)一個(gè)系統(tǒng)需要通過認(rèn)證才能訪問的時(shí)候，如果用郵遞員的時(shí)候，是不是先訪問登錄接口，然后獲得令牌后，手動復(fù)制到新的調(diào)試接口的header參數(shù)里面去，這太麻煩了，IDEA REST Client還有一個(gè)真香的功能，可以完美解決這個(gè)問題，請看下面的腳本：

###?演示POST請求
POST?https://httpbin.org/post
Content-Type:?application/json

{
??"user":?"admin",
??"password":?"123456"
}

>?{%?client.global.set("auth_token",?response.body.json.token);?%}
###?演示GET請求

GET?https://httpbin.org/headers
Authorization:?Bearer?{{auth_token}}

在第一個(gè)認(rèn)證的請求結(jié)束后，可以在響應(yīng)里拿到返回的令牌信息，然后我們通過腳本設(shè)置到了變量變量里，然后在接下來的接口請求中，就可以直接使用雙大括號占位符的方式獲取到這個(gè)token了

結(jié)語

postman有口皆碑，確實(shí)是一個(gè)非常不錯(cuò)的必備工具，之前給比人推薦這種工具時(shí)總是安利他postman。但是，IDEA REST Client也真的很不錯(cuò)，值得嘗試一下，后面安利這種工具就切換到IDEA REST客戶端了，郵遞員反正被我丟掉了。和第三方做接口對接時(shí)，項(xiàng)目里必備一個(gè)rest-http.http接口請求文件，滿足自己的同時(shí)也成方便了別人。

推薦閱讀
這應(yīng)該是全網(wǎng)最全的Git分支開發(fā)規(guī)范手冊~
圖片驗(yàn)證碼的需求分析、優(yōu)雅實(shí)現(xiàn)
8種常見SQL錯(cuò)誤用法
一個(gè)小小的簽到功能，到底用MySQL還是Redis？

最后，推薦給大家一個(gè)有趣有料的公眾號：寫代碼的渣渣鵬，7年老程序員教你寫bug,回復(fù)?面試或資源 送一你整套開發(fā)筆記 有驚喜哦

是時(shí)候扔掉 Postman 了，試試 IntelliJ IDEA 自帶的高能神器！

前言