JEESZ RestFul服務(wù)介紹

1. REST介紹

REpresentational State Transfer (REST)?是一種架構(gòu)原則闪朱,其中將?web?服務(wù)視為資源,可以由其?URL?唯一標(biāo)識法梯。

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

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

POST -?創(chuàng)建資源

GET -?檢索資源

PUT?–?更新資源

DELETE -?刪除資源

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

它們是跨平臺?(Java、.net埠忘、PHP?等)高度可重用的脾拆,因為它們都依賴基本?HTTP?協(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ù)交互倦青,以實現(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)

為了增強可伸縮性,服務(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ù)為實例,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ù)端為實例,對應(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ù)列表(僅僅列舉實例)

1)添加標(biāo)簽


2)刪除標(biāo)簽


3)更新標(biāo)簽


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


歡迎大家一起學(xué)習(xí)研究相關(guān)技術(shù)

愿意了解框架技術(shù)或者源碼的朋友直接求求交流分享技術(shù):2042849237

更多詳細(xì)源碼參考來源:http://minglisoft.cn/technology

最后編輯于
?著作權(quán)歸作者所有,轉(zhuǎn)載或內(nèi)容合作請聯(lián)系作者
  • 序言:七十年代末衷佃,一起剝皮案震驚了整個濱河市趟卸,隨后出現(xiàn)的幾起案子,更是在濱河造成了極大的恐慌,老刑警劉巖锄列,帶你破解...
    沈念sama閱讀 216,919評論 6 502
  • 序言:濱河連續(xù)發(fā)生了三起死亡事件图云,死亡現(xiàn)場離奇詭異,居然都是意外死亡邻邮,警方通過查閱死者的電腦和手機(jī)竣况,發(fā)現(xiàn)死者居然都...
    沈念sama閱讀 92,567評論 3 392
  • 文/潘曉璐 我一進(jìn)店門,熙熙樓的掌柜王于貴愁眉苦臉地迎上來筒严,“玉大人丹泉,你說我怎么就攤上這事⊙纪埽” “怎么了摹恨?”我有些...
    開封第一講書人閱讀 163,316評論 0 353
  • 文/不壞的土叔 我叫張陵,是天一觀的道長规惰。 經(jīng)常有香客問我睬塌,道長,這世上最難降的妖魔是什么歇万? 我笑而不...
    開封第一講書人閱讀 58,294評論 1 292
  • 正文 為了忘掉前任揩晴,我火速辦了婚禮,結(jié)果婚禮上贪磺,老公的妹妹穿的比我還像新娘硫兰。我一直安慰自己,他們只是感情好寒锚,可當(dāng)我...
    茶點故事閱讀 67,318評論 6 390
  • 文/花漫 我一把揭開白布劫映。 她就那樣靜靜地躺著,像睡著了一般刹前。 火紅的嫁衣襯著肌膚如雪泳赋。 梳的紋絲不亂的頭發(fā)上,一...
    開封第一講書人閱讀 51,245評論 1 299
  • 那天喇喉,我揣著相機(jī)與錄音祖今,去河邊找鬼。 笑死拣技,一個胖子當(dāng)著我的面吹牛千诬,可吹牛的內(nèi)容都是我干的。 我是一名探鬼主播膏斤,決...
    沈念sama閱讀 40,120評論 3 418
  • 文/蒼蘭香墨 我猛地睜開眼徐绑,長吁一口氣:“原來是場噩夢啊……” “哼!你這毒婦竟也來了莫辨?” 一聲冷哼從身側(cè)響起傲茄,我...
    開封第一講書人閱讀 38,964評論 0 275
  • 序言:老撾萬榮一對情侶失蹤毅访,失蹤者是張志新(化名)和其女友劉穎,沒想到半個月后烫幕,有當(dāng)?shù)厝嗽跇淞掷锇l(fā)現(xiàn)了一具尸體俺抽,經(jīng)...
    沈念sama閱讀 45,376評論 1 313
  • 正文 獨居荒郊野嶺守林人離奇死亡,尸身上長有42處帶血的膿包…… 初始之章·張勛 以下內(nèi)容為張勛視角 年9月15日...
    茶點故事閱讀 37,592評論 2 333
  • 正文 我和宋清朗相戀三年较曼,在試婚紗的時候發(fā)現(xiàn)自己被綠了磷斧。 大學(xué)時的朋友給我發(fā)了我未婚夫和他白月光在一起吃飯的照片。...
    茶點故事閱讀 39,764評論 1 348
  • 序言:一個原本活蹦亂跳的男人離奇死亡捷犹,死狀恐怖弛饭,靈堂內(nèi)的尸體忽然破棺而出,到底是詐尸還是另有隱情萍歉,我是刑警寧澤侣颂,帶...
    沈念sama閱讀 35,460評論 5 344
  • 正文 年R本政府宣布,位于F島的核電站枪孩,受9級特大地震影響憔晒,放射性物質(zhì)發(fā)生泄漏。R本人自食惡果不足惜蔑舞,卻給世界環(huán)境...
    茶點故事閱讀 41,070評論 3 327
  • 文/蒙蒙 一拒担、第九天 我趴在偏房一處隱蔽的房頂上張望。 院中可真熱鬧攻询,春花似錦从撼、人聲如沸。這莊子的主人今日做“春日...
    開封第一講書人閱讀 31,697評論 0 22
  • 文/蒼蘭香墨 我抬頭看了看天上的太陽。三九已至拯杠,卻和暖如春掏婶,著一層夾襖步出監(jiān)牢的瞬間,已是汗流浹背潭陪。 一陣腳步聲響...
    開封第一講書人閱讀 32,846評論 1 269
  • 我被黑心中介騙來泰國打工雄妥, 沒想到剛下飛機(jī)就差點兒被人妖公主榨干…… 1. 我叫王不留,地道東北人畔咧。 一個月前我還...
    沈念sama閱讀 47,819評論 2 370
  • 正文 我出身青樓茎芭,卻偏偏與公主長得像揖膜,于是被迫代替她去往敵國和親誓沸。 傳聞我的和親對象是個殘疾皇子,可洞房花燭夜當(dāng)晚...
    茶點故事閱讀 44,665評論 2 354

推薦閱讀更多精彩內(nèi)容

  • 摘要: RESTful Web 服務(wù)的關(guān)鍵特點是明確使用 HTTP 方法來表示不同的操作的調(diào)用壹粟。 REST 的基本...
    ITsupuerlady閱讀 489評論 0 0
  • 摘要: RESTful Web 服務(wù)的關(guān)鍵特點是明確使用 HTTP 方法來表示不同的操作的調(diào)用拜隧。 REST 的基本...
    ITsupuerlady閱讀 118評論 0 0
  • 1. REST介紹 REpresentational State Transfer (REST)是一種架構(gòu)原則宿百,其...
    ITsupuerlady閱讀 232評論 0 0
  • 1. REST介紹 REpresentational State Transfer (REST)是一種架構(gòu)原則,其...
    ITsupuerlady閱讀 235評論 0 0
  • Spring Cloud為開發(fā)人員提供了快速構(gòu)建分布式系統(tǒng)中一些常見模式的工具(例如配置管理洪添,服務(wù)發(fā)現(xiàn)垦页,斷路器,智...
    卡卡羅2017閱讀 134,654評論 18 139