在推薦這個(gè) IDEA 插件之前，我認(rèn)為有必要簡單談一下我們經(jīng)常接觸到的 REST 這個(gè)概念。

REST 相關(guān)概念解讀

什么是 REST？

REST是REpresentational State Transfer的縮寫，即“表現(xiàn)層狀態(tài)轉(zhuǎn)化”。這個(gè)詞組的翻譯有些晦澀，實(shí)際上REST的全稱是Resource Representational State Transfer，直白地翻譯過來就是“資源在網(wǎng)絡(luò)傳輸中以某種表現(xiàn)形式進(jìn)行狀態(tài)轉(zhuǎn)移”。

你有沒有覺得這很難理解？

沒關(guān)系，看了我對 REST 涉及到的一些概念的解讀之后你沒準(zhǔn)就能理解了！

• 資源（Resource）: 我們可以把真實(shí)的對象數(shù)據(jù)稱為資源。一個(gè)資源既可以是一個(gè)集合，也可以是單個(gè)個(gè)體。比如我們的班級 classes 是代表一個(gè)集合形式的資源，而特定的 class 代表單個(gè)個(gè)體資源。每一種資源都有特定的 URI（統(tǒng)一資源定位符）與之對應(yīng)，如果我們需要獲取這個(gè)資源，訪問這個(gè) URI 就可以了，比如獲取特定的班級:?/class/12。另外，資源也可以包含子資源，比如?/classes/classId/teachers：列出某個(gè)指定班級的所有老師的信息。

• 表現(xiàn)形式（Representational）： "資源"是一種信息實(shí)體，它可以有多種外在表現(xiàn)形式。我們把"資源"具體呈現(xiàn)出來的形式，如 JSON、XML、Image、TXT 等等，稱作它的"表現(xiàn)層/表現(xiàn)形式"。

• 狀態(tài)轉(zhuǎn)移（State Transfer）: 大家第一眼看到這個(gè)詞語一定會很懵逼？內(nèi)心 納悶: 這是啥??？?換種說法，REST 中的狀態(tài)轉(zhuǎn)移更多地描述服務(wù)器端資源的狀態(tài)，例如你通過增刪改查（通過 HTTP 動詞實(shí)現(xiàn)）引起資源狀態(tài)的改變。（HTTP 協(xié)議是無狀態(tài)的，所有資源狀態(tài)都保存在服務(wù)器端）

什么是 RESTful 架構(gòu)？

遵循符合 REST 風(fēng)格的架構(gòu)設(shè)計(jì)就可以被稱為 RESTful 架構(gòu):

1. 每個(gè) URI 代表一種資源；

2. 客戶端和服務(wù)器之間，傳遞這種資源的某種表現(xiàn)形式，比如 json，xml，image，txt 等等；

3. 客戶端通過特定的 HTTP 動詞，對服務(wù)器端資源進(jìn)行操作，實(shí)現(xiàn)"表現(xiàn)層狀態(tài)轉(zhuǎn)化"。

什么是RESTful Web 服務(wù)？

基于 REST 架構(gòu)的 Web 服務(wù)就被稱為 RESTful Web 服務(wù)。

RESTful Web 服務(wù)輔助開發(fā)工具

安裝

這個(gè)插件的名字叫做 "RestfulToolkit"。我們可以在 IDEA 的插件市場中直接找到這個(gè)插件，如下圖所示。

如果因?yàn)榫W(wǎng)絡(luò)問題無法使用 IDEA 自帶的插件市場，也可以通過 IDEA 插件市場的官網(wǎng)（open in new window）手動下載并安裝。

https://p3-juejin.byteimg.com/tos-cn-i-k3u1fbpfcp/41a9bfa18920403ba4db83e324f8621e~tplv-k3u1fbpfcp-zoom-1.image

簡單使用

URL 跳轉(zhuǎn)到對應(yīng)方法

通過 URL 直接跳轉(zhuǎn)到對應(yīng)的方法定義（Windows: ctrl+\\\\ 或 ctrl+alt+n，Mac: command+\\\\ 或 command+alt+n），同時(shí)提供了一個(gè)樹形結(jié)構(gòu)的可視化顯示窗口，如下圖所示。

https://p3-juejin.byteimg.com/tos-cn-i-k3u1fbpfcp/c26ea05ad472488fbf9eb21627964bee~tplv-k3u1fbpfcp-zoom-1.image

作為 HTTP 請求工具

這個(gè)插件還可以作為一個(gè)簡單的 http 請求工具來使用。如下圖所示。

復(fù)制生成 URL、復(fù)制方法參數(shù)...

此插件還提供了生成 URL、查詢參數(shù)、請求體（RequestBody）等功能。

例如，我們選中 Controller 中的某個(gè)請求對應(yīng)的方法并右鍵單擊，會發(fā)現(xiàn)多出幾個(gè)可選項(xiàng)。選擇 Generate & Copy Full URL，即可復(fù)制整個(gè)請求的路徑，例如：http://localhost:9333/api/users?pageNum=1&pageSize=1。

將 Java 類轉(zhuǎn)換為對應(yīng)的 JSON 格式

這個(gè)插件還為 Java 類添加了“Convert to JSON”功能。

選中某個(gè)類對應(yīng)的方法，然后右鍵單擊，你會發(fā)現(xiàn)多了幾個(gè)選項(xiàng)。

當(dāng)我們選擇?Convert to JSON?的話，你會得到如下 json 類型的數(shù)據(jù):