忘了 postman 是被誰種草的，很長一段時間內 postman 都是我做接口測試的首選工具，之前也有小伙伴跟我安利過 IDEA 中的 RestfulToolkit 插件，但是一直沒機會體驗，最近抽空玩了一把，感覺在某些場景下還蠻不錯的(不需要認證的場景下)，和小伙伴們分享下。

1. RestfulToolkit

RestfulToolkit 是一套 RESTful 服務開發輔助工具集，它主要提供了如下功能：

• 根據 URL 直接跳轉到對應的方法定義 ( Ctrl \ or Ctrl Alt N )；
• 提供了一個 Services tree 的顯示窗口；
• 一個簡單的 http 請求工具；
• 在請求方法上添加了有用功能: 復制生成 URL;,復制方法參數...
• 其他功能: java 類上添加 Convert to JSON 功能，格式化 json 數據 ( Windows: Ctrl + Enter; Mac: Command + Enter )。

它支持 Spring 體系 (Spring MVC / Spring Boot 1.x,2.x);支持 JAX-RS;支持 Java 和 Kotlin 語言。

2. 安裝

在 IDEA 中選擇 File->Plugins，然后搜索 RestfulToolkit，如下：

然后點擊 install 按鈕即可，安裝完成后重啟 IDEA 即可：

3. 使用

創建一個項目，在項目的右邊可以看到 Rest Services 選項，如下：

點開該選項卡，就可以進行 RESTful 接口測試了。

松哥寫了四個測試接口，大家來看一下：

@RestController
public class BookController {
    @PostMapping("/book")
    public RespBean addBook(Book book) {
        System.out.println(book);
        return RespBean.ok("添加成功");
    }

    @GetMapping("/book/{id}")
    public Book getBookById(@PathVariable Integer id) {
        Book book = new Book();
        book.setId(id);
        return book;
    }

    @PutMapping("/book")
    public RespBean updateBook(@RequestBody Book book) {
        return RespBean.ok("更新成功");
    }

    @DeleteMapping("/book")
    public RespBean deleteBookById(Integer id) {
        return RespBean.ok("刪除成功");
    }
}

這四個借口基本上涵蓋了我們日常常見的傳參方式，啟動項目，我們來看下右邊：

可以看到，項目啟動成功后，四個測試接口都會在 RestfulToolkit 工具中展示出來：

并且不同的接口，都有對應的默認參數，例如更新接口，參數是 JSON 格式，這里就會自動列出來：

開發者只需要根據實際情況重新填一下具體的參數值即可。

測試成功，結果如下：

RestfulToolkit 有一個功能，就是點擊接口，可以跳轉到對應的方法定義上，如下：

選中接口，右鍵單擊，有兩個選項：

• Copy Full Url：拷貝完整的 URL 地址。
• Jump to Source：跳轉到接口定義的代碼處。

除了這個，RestfulToolkit 還能幫我們根據一個類，快速轉換為 JSON，有時候我們用 postman 測試的時候，自己寫 JSON 太慢了，這是一個好辦法，具體操作如下：

選中類名，右鍵單擊，最上面有兩個選項，如下：

• Convert to JSON(Compressed)：生成一個壓縮后的 JSON，其實就是一行 JSON。
• Convert to JSON：生成一個帶格式的 JSON。

4. 一個題外話

有的小伙伴可能會問，用 RestfulToolkit 的話，基于 Cookie+Session 的認證怎么辦?其實，一個合格的 RESTful 接口，本身就是無狀態的，既然是無狀態的，那么認證就不需要 Cookie 了，每個請求都自己帶上令牌就行了，反正 RestfulToolkit 也支持修改請求頭。

不過話說回來，如果你的項目就是基于 Cookie + Session 認證的，那么接口測試，我還是建議使用 postman，畢竟這個工具更專業。或者你也可以試試 IDEA 自帶的 Http Client 工具，如下圖：

好啦，今天和小伙伴們分享了一個小工具，感興趣的小伙伴可以去體驗一把啦！對了，2020 版之后的 IDEA 可以使用 Restful Tools。