我們經(jīng)常談 RESTful Web 服務開發(fā)诊赊,但是我發(fā)現(xiàn)很多人實際就根本不懂這個概念厚满。只是聽著大家都這么說,也就跟著一起說了碧磅,哈哈哈碘箍!
因此,在開始推薦這個IDEA插件之前续崖,非常有必要花一小會時間簡單聊聊 REST 相關的概念敲街。這是一個看似高大上,實際上很容易理解的概念严望。
REST 相關概念解讀
何為 REST多艇?
REST 即 REpresentational State Transfer 的縮寫。這個詞組的翻譯過來就是"表現(xiàn)層狀態(tài)轉化"像吻。
這樣理解起來甚是晦澀峻黍,實際上 REST 的全稱是 Resource Representational State Transfer ,直白地翻譯過來就是 “資源”在網(wǎng)絡傳輸中以某種“表現(xiàn)形式”進行“狀態(tài)轉移” 拨匆。
有沒有感覺很難理解姆涩?
沒關系,看了我對 REST 涉及到的一些概念的解讀之后你沒準就能理解了惭每!
-
資源(Resource) :我們可以把真實的對象數(shù)據(jù)稱為資源骨饿。一個資源既可以是一個集合,也可以是單個個體台腥。比如我們的班級 classes 是代表一個集合形式的資源宏赘,而特定的 class 代表單個個體資源。每一種資源都有特定的 URI(統(tǒng)一資源定位符)與之對應黎侈,如果我們需要獲取這個資源察署,訪問這個 URI 就可以了,比如獲取特定的班級:
/class/12
峻汉。另外贴汪,資源也可以包含子資源脐往,比如/classes/classId/teachers
:列出某個指定班級的所有老師的信息 - 表現(xiàn)形式(Representational):"資源"是一種信息實體,它可以有多種外在表現(xiàn)形式扳埂。我們把"資源"具體呈現(xiàn)出來的形式比如 json业簿,xml,image,txt 等等叫做它的"表現(xiàn)層/表現(xiàn)形式"聂喇。
- 狀態(tài)轉移(State Transfer) :大家第一眼看到這個詞語一定會很懵逼辖源?內心 BB:這尼瑪是啥啊希太? 大白話來說 REST 中的狀態(tài)轉移更多地描述的服務器端資源的狀態(tài)克饶,比如你通過增刪改查(通過 HTTP 動詞實現(xiàn))引起資源狀態(tài)的改變。 (HTTP 協(xié)議是一個無狀態(tài)的誊辉,所有的資源狀態(tài)都保存在服務器端)
何為 RESTful 架構矾湃?
滿足 REST 風格的架構設計就可以稱為RESTful 架構:
- 每一個 URI 代表一種資源;
- 客戶端和服務器之間堕澄,傳遞這種資源的某種表現(xiàn)形式比如 json邀跃,xml,image,txt 等等蛙紫;
- 客戶端通過特定的 HTTP 動詞拍屑,對服務器端資源進行操作,實現(xiàn)"表現(xiàn)層狀態(tài)轉化"坑傅。
何為 RESTful Web服務僵驰?
基于 REST 架構的 Web 服務就被稱為 RESTful Web 服務。
RESTful Web服務輔助開發(fā)工具
安裝
這個插件的名字叫做 “RestfulToolkit” 唁毒。我們直接在 IDEA 的插件市場即可找到這個插件蒜茴。如下圖所示。
如果你因為網(wǎng)絡問題沒辦法使用 IDEA 自帶的插件市場的話浆西,也可以通過IDEA 插件市場的官網(wǎng)手動下載安裝粉私。
簡單使用
URL 跳轉到對應方法
根據(jù) URL 直接跳轉到對應的方法定義 (Windows: ctrl+\
or ctrl+alt+n
Mac:command+\
or command+alt+n
)并且提供了一個服務的樹形可視化顯示窗口。 如下圖所示近零。
作為HTTP請求工具
這個插件還可以作為一個簡單的 http 請求工具來使用诺核。如下圖所示。
復制生成 URL久信、復制方法參數(shù)...
這個插件還提供了生成 URL猪瞬、查詢參數(shù)、請求體(RequestBody)等功能入篮。
舉個例子。我們選中 Controller
中的某個請求對應的方法右擊幌甘,你會發(fā)現(xiàn)多了幾個可選項潮售。當你選擇Generate & Copy Full URL
的話痊项,就可以把整個請求的路徑直接復制下來。eg:http://localhost:9333/api/users?pageNum=1&pageSize=1
酥诽。
將Java類轉換為對應的JSON格式
這個插件還為 Java 類上添加了 Convert to JSON 功能 鞍泉。
我們選中的某個類對應的方法然后右擊,你會發(fā)現(xiàn)多了幾個可選項肮帐。
當我們選擇Convert to JSON
的話咖驮,你會得到如下 json 類型的數(shù)據(jù):
{
"username": "demoData",
"password": "demoData",
"rememberMe": true
}
后記
剛剛有小伙伴指出 2020 版本之后的 IDEA 已經(jīng)無法正常使用這個插件了。不過训枢,網(wǎng)上有人開發(fā)了一個替代品 RestfulTool
閑聊
昨晚邊看電視邊把之前寫的一個 RPC 框架給重構了一下托修。我平時經(jīng)常會抽時間重構一下之前寫的東西,對自己負責也對別人負責恒界。
之前說這個框架幫助很多校招的小伙伴找到了大廠Offer睦刃,真的不是我吹牛皮。今年就有很多小伙伴用這個項目當做自己的項目經(jīng)驗十酣。
不過涩拙,我在項目中也說了,你想用我的這個項目充當項目經(jīng)驗的話耸采,一定要自己搞懂項目兴泥,并對其進行簡單的完善。不然的話虾宇,真沒啥用搓彻,就是自己騙自己罷了。
說實話文留,這個項目今年還很好用好唯,畢竟用的人很少。明年的話燥翅,應該也還好骑篙。重要的是自己搞懂其中的思想并進行完善。
項目地址:https://github.com/Snailclimb/guide-rpc-framework
圖解計算機基礎+個人原創(chuàng)的 Java 面試手冊PDF版森书。
微信搜“JavaGuide”回復“計算機基礎”即可獲取圖解計算機基礎+個人原創(chuàng)的 Java 面試手冊靶端。