1. REST介紹

REpresentational State Transfer (REST)是一種架構(gòu)原則懦冰，其中將web服務(wù)視為資源资锰，可以由其URL唯一標(biāo)識堕花。

RESTful Web服務(wù)的關(guān)鍵特點(diǎn)是明確使用HTTP方法來表示不同的操作的調(diào)用吏口。

REST的基本設(shè)計(jì)原則對典型CRUD操作使用HTTP協(xié)議方法：

POST -創(chuàng)建資源

GET -檢索資源

PUT–更新資源

DELETE -刪除資源

REST服務(wù)的主要優(yōu)勢在于：

它們是跨平臺(Java蝠咆、.net、PHP等）高度可重用的贰健，因?yàn)樗鼈兌家蕾嚮綡TTP協(xié)議胞四。

它們使用基本的XML，而不是復(fù)雜的SOAP XML伶椿，使用非常方便辜伟。

基于REST的web服務(wù)日益成為后端企業(yè)服務(wù)集成的首選方法。與基于SOAP的web服務(wù)相比脊另，它的編程模型簡單导狡，而本機(jī)XML（而不是SOAP）的使用減少了序列化和反序列化過程的復(fù)雜性，并且不再需要其他作用相同的第三方庫偎痛。

2. 編寫目的

編寫本文的目的是為了將系統(tǒng)功能進(jìn)行模塊化旱捧、服務(wù)化，將用戶的操作以服務(wù)的方式提供踩麦。系統(tǒng)與系統(tǒng)之間遵循服務(wù)規(guī)范枚赡，將系統(tǒng)與系統(tǒng)之間的交互轉(zhuǎn)為定制化服務(wù)交互，以實(shí)現(xiàn)系統(tǒng)與系統(tǒng)之間的集成

3. 編寫原則

可尋址性（Addressability）

REST 中的所有東西都基于資源 的概念谓谦。資源與 OOP 中的對象或其他名詞不同贫橙，它是一種抽象，必須可以通過 URI 尋址或訪問茁计。

接口一致性（Interface uniformity）

與SOAP或其他標(biāo)準(zhǔn)不同料皇，REST要求用來操縱資源的方法或動詞不是任意的。這意味著RESTful服務(wù)的開發(fā)人員只能使用HTTP支持的方法星压，比如GET践剂、PUT、POST娜膘、DELETE等等逊脯。因此不需要使用WSDL等服務(wù)描述語言

無狀態(tài)（Statelessness）

為了增強(qiáng)可伸縮性，服務(wù)器端不存儲客戶機(jī)的狀態(tài)信息竣贪。這使服務(wù)器不與特定的客戶機(jī)相綁定军洼，負(fù)載平衡變得簡單多了巩螃。這還讓服務(wù)器更容易監(jiān)視、更可靠

具象（Representational）

客戶機(jī)總是與資源的某種具象交互匕争，絕不會直接與資源本身交互避乏。同一資源還可以有多個具象。理論上說甘桑，持有資源的具象的任何客戶機(jī)應(yīng)該有操縱底層資源的足夠信息拍皮。

連通性（Connectedness）

任何基于REST的系統(tǒng)都應(yīng)該預(yù)見到客戶機(jī)需要訪問相關(guān)的資源，應(yīng)該在返回的資源具象中包含這些資源跑杭。例如铆帽，可以以超鏈接的形式包含特定RESTful服務(wù)的操作序列中的相關(guān)步驟，讓客戶機(jī)可以根據(jù)需要訪問它們德谅。

4. 服務(wù)使用說明

1) 當(dāng)前系統(tǒng)已經(jīng)提供的服務(wù)

2)? GET方式調(diào)用服務(wù)

說明：

1.請求方式包括：GET (這里以area服務(wù)為實(shí)例爹橱，GET對應(yīng)每一個服務(wù)Resource中的@RequestMapping(value = "treeData",method = RequestMethod.GET))

2.請求URL：rest服務(wù)請求地址,對應(yīng)XXXServiceResource.java的mapping配置中的value

@RequestMapping(value = "treeData", method = RequestMethod.GET))

3.其中GET請求只包含了請求方式和請求的URL，返回的結(jié)果以json格式返回給客戶端

3) POST窄做、DELETE愧驱、UPDATE方式調(diào)用服務(wù)

說明：

1.請求方式選擇POST、DELETE椭盏、UPDATE(這里以保存收藏功能為例（PUT請求）冯键，對應(yīng)每一個服Resource中的@RequestMapping(value = "save",method = RequestMethod.PUT))

2.Json參數(shù)： 其中POST、DELETE庸汗、UPDATE可能傳遞參數(shù)通過json，也可能通過路徑直接拼接參數(shù)手报，這邊以傳遞json到服務(wù)端為實(shí)例蚯舱，對應(yīng)服務(wù)端代碼：

public JSONObject save(@RequestBody JSONObject obj,BookmarkTag bookmarkTag) {

3.請求URL：rest服務(wù)請求地址,對應(yīng)XXXServiceResource.java的mapping配置中的value

@RequestMapping(value = " save",method = RequestMethod.PUT))

4.返回的結(jié)果以json格式返回給客戶端

5.? 服務(wù)列表（僅僅列舉實(shí)例）

1)添加標(biāo)簽

2)刪除標(biāo)簽

3)更新標(biāo)簽

4)獲取標(biāo)簽列表

歡迎大家一起學(xué)習(xí)研究相關(guān)技術(shù)，源碼獲取來源：http://minglisoft.cn/technology