SpringBoot Rest API

REST代表Representational State Transfer. 是一種架構風格,設計風格而不是標準,可用於設計Web服務,可以從各種客戶端使用.

基於REST的基本設計,其是根據一組動詞來控制的操作

  • 創建操作:應使用HTTP POST

  • 查詢操作:應使用HTTP GET

  • 更新操作:應使用HTTP PUT

  • 刪除操作:應使用HTTP DELETE

作爲REST服務開發人員或客戶端,您應該遵守上述標準。

項目的環境工具

  • SpringBoot 2.0.1.RELEASE

  • Gradle 4.7

  • IDEA 2018.2

  • MySQL5.7

項目結構圖

3.開始

下面基於一種方式講解Restful

  • 對於/user/api HTTP GET來請求獲取全部用戶

  • 對於/user/api HTTP POST來創建用戶

  • 對於/user/api/1 HTTP GET請求來獲取id爲1的用戶

  • 對於/user/api/1 HTTP PUT請求來更新

  • 對於/user/api/1 HTTP DELETE請求來刪除id爲1的用戶

HTTP GET請求/user/api 查詢全部

URL:http://localhost:8080/user/api

TTP GET請求/user/api/65 跟據id查詢

URL:http://localhost:8080/user/api/65

HTTP POST請求/user/api 創建用戶

URL:http://localhost:8080/user/api

HTTP PUT請求/user/api/65 來更新用戶信息

URL:http://localhost:8080/user/api/65

HTTP DELETE請求/user/api/85 來刪除id爲85的用戶

URL:http://localhost:8080/user/api/85

4.業務層及dao層代碼

UserService.java 接口

PageResultBean和ResultBean的代碼在GitHub

https://github.com/cuifuan/springboot-demo

通過上面的編碼,如果你已經走通了上面的代碼,相信你已經對REST有了大致的掌握,時今當下的前端Client層出不窮,後端接口或許來自不同平臺,這時候需要請求一批接口,而RESTful風格的api,使人從請求方式和地址一看就知道是要做什麼操作,根據返回code狀態就知道結果如何

使用RESTful直接帶來的便利:

之前的接口

  • 刪除 /user/delete

  • 添加 /user/create

  • 單個查詢 /user/queryById

  • 查詢全部 /user/queryAll

  • 更新 /user/update

採用RESTful設計API之後 /user/api一個URL地址解決,再也不用跟前端廢舌頭了,同時GET請求是冪等的,什麼是冪等?簡單通俗的說就是多次請求返回的效果都是相同的,例如GET去請求一個資源,無論請求多少次,都不會對數據造成創建修改等操作,PUT用來更新數據也是,無論執行多次的都是最終一樣的效果

問題:使用PUT改變學生年齡並且這樣做10次和做了一次,學生的年齡是相同的,是冪等的,那麼如果POST做相同操作,那麼它是如何不是冪等的?

答:因爲POST請求會在服務端創建與請求次數相同的服務,假如服務端每次請求服務會存在一個密鑰,那麼這個POST請求就可能不是冪等的,也或許是冪等的,所以POST不是冪等的。

因爲PUT請求URL到客戶端定義的URL處完整地創建或替換資源,所以PUT是冪等的。 DELETE請求也是冪等的,用來刪除操作,其實REST就是相當於一個風格規範。

注意了,GET請求請不要用在delete操作上,你要問我爲啥不行,你偏要那麼做,其實,整個CRUD操作你也都可以用GET來完成,哈哈,這個只是一個開發的設計風格。

發表評論
所有評論
還沒有人評論,想成為第一個評論的人麼? 請在上方評論欄輸入並且點擊發布.
相關文章