摘要: RESTful Web 服務的關鍵特點是明確使用 HTTP 方法來表示不同的操作的調用旦事。 REST 的基本設計?...
1. REST介紹
REpresentational State Transfer (REST)?是一種架構原則,其中將?web?服務視為資源捏境,可以由其?URL?唯一標識孽尽。
RESTful Web?服務的關鍵特點是明確使用?HTTP?方法來表示不同的操作的調用窖壕。
REST?的基本設計原則對典型?CRUD?操作使用?HTTP?協(xié)議方法:
POST -?創(chuàng)建資源
GET -?檢索資源
PUT?–?更新資源
DELETE -?刪除資源
REST?服務的主要優(yōu)勢在于:
它們是跨平臺?(Java、.net杉女、PHP?等)高度可重用的瞻讽,因為它們都依賴基本?HTTP?協(xié)議。
它們使用基本的?XML熏挎,而不是復雜的?SOAP XML速勇,使用非常方便。
基于?REST?的?web?服務日益成為后端企業(yè)服務集成的首選方法坎拐。與基于?SOAP?的?web?服務相比烦磁,它的編程模型簡單,而本機?XML(而不是?SOAP?)的使用減少了序列化和反序列化過程的復雜性哼勇,并且不再需要其他作用相同的第三方庫都伪。
2. 編寫目的
編寫本文的目的是為了將系統(tǒng)功能進行模塊化、服務化积担,將用戶的操作以服務的方式提供陨晶。系統(tǒng)與系統(tǒng)之間遵循服務規(guī)范,將系統(tǒng)與系統(tǒng)之間的交互轉為定制化服務交互帝璧,以實現(xiàn)系統(tǒng)與系統(tǒng)之間的集成
3. 編寫原則
可尋址性(Addressability)
REST 中的所有東西都基于資源 的概念先誉。資源與 OOP 中的對象或其他名詞不同,它是一種抽象的烁,必須可以通過 URI 尋址或訪問褐耳。
接口一致性(Interface uniformity)
與?SOAP?或其他標準不同,REST?要求用來操縱資源的方法或動詞不是任意的撮躁。這意味著?RESTful?服務的開發(fā)人員只能使用?HTTP?支持的方法漱病,比如GET、PUT把曼、POST、DELETE等等漓穿。因此不需要使用?WSDL?等服務描述語言
無狀態(tài)(Statelessness)
為了增強可伸縮性嗤军,服務器端不存儲客戶機的狀態(tài)信息。這使服務器不與特定的客戶機相綁定晃危,負載平衡變得簡單多了叙赚。這還讓服務器更容易監(jiān)視老客、更可靠
具象(Representational)
客戶機總是與資源的某種具象交互,絕不會直接與資源本身交互震叮。同一資源還可以有多個具象胧砰。理論上說,持有資源的具象的任何客戶機應該有操縱底層資源的足夠信息苇瓣。
連通性(Connectedness)
任何基于?REST?的系統(tǒng)都應該預見到客戶機需要訪問相關的資源尉间,應該在返回的資源具象中包含這些資源。例如击罪,可以以超鏈接的形式包含特定?RESTful?服務的操作序列中的相關步驟哲嘲,讓客戶機可以根據需要訪問它們。
4. 服務使用說明
1) 當前系統(tǒng)已經提供的服務
2)? GET方式調用服務
說明:
1.請求方式包括:GET (這里以area服務為實例媳禁,GET對應每一個服務Resource中的@RequestMapping(value = "treeData",method = RequestMethod.GET))
2.請求URL:rest服務請求地址,對應XXXServiceResource.java的mapping配置中的value
@RequestMapping(value = "treeData", method = RequestMethod.GET))
3.其中GET請求只包含了請求方式和請求的URL眠副,返回的結果以json格式返回給客戶端
3) POST、DELETE竣稽、UPDATE方式調用服務
說明:
1.請求方式選擇POST囱怕、DELETE、UPDATE(這里以保存收藏功能為例(PUT請求)毫别,對應每一個服Resource中的@RequestMapping(value = "save",method = RequestMethod.PUT))
2.Json參數(shù): 其中POST光涂、DELETE、UPDATE可能傳遞參數(shù)通過json拧烦,也可能通過路徑直接拼接參數(shù)忘闻,這邊以傳遞json到服務端為實例,對應服務端代碼:
public JSONObject save(@RequestBody JSONObject obj,BookmarkTag bookmarkTag) {
3.請求URL:rest服務請求地址,對應XXXServiceResource.java的mapping配置中的value
@RequestMapping(value = " save",method = RequestMethod.PUT))
4.返回的結果以json格式返回給客戶端
5.? 服務列表(僅僅列舉實例)
1)添加標簽
2)刪除標簽
3)更新標簽
4)獲取標簽列表
歡迎大家一起學習研究相關技術愿意了解框架技術或者源碼的朋友直接加求求(企鵝):2042849237
更多詳細源碼參考來源:http://minglisoft.cn/technology