PUT方法

PUT方法是一種寫操作的HTTP請求,REST使用HTTP的PUT方法更新或添加資源

1、更新資源

REST知識風(fēng)格,不是技術(shù)規(guī)范或者標(biāo)準(zhǔn),所以有些實(shí)現(xiàn)REST的細(xì)節(jié)明確的定義,這對實(shí)踐而言,不可避免會產(chǎn)生某些誤解,比如在創(chuàng)建和更新某個資源的時候,開發(fā)者比較迷茫的是何時該用HTTP的PUT方法,何時使用POST方法,為了解決這一問題,我們首先應(yīng)該知道PUT方法的特性,PUT方法是冪等的,即多次插入或者更新同一份數(shù)據(jù),在服務(wù)器端對資源狀態(tài)所產(chǎn)生的改變是相同的,PUT方法是不安全的,有些動作的HTTP方法都不是安全的。我們知道,由于使用同一份數(shù)據(jù)向服務(wù)器請求更新某一資源,得到的結(jié)果應(yīng)該總是相同的,因此對于更新操作,使用PUT是沒有疑問的。

2、添加資源

創(chuàng)建操作通常每次得到的結(jié)果是不同的,因?yàn)榉?wù)器端的業(yè)務(wù)層邏輯通常要求數(shù)據(jù)的主鍵字段要么來自于業(yè)務(wù)平臺自增一個邏輯值,要么來自于數(shù)據(jù)庫中的主鍵自增,因此,相同的數(shù)據(jù)每一次提交到服務(wù)器端,都會為數(shù)據(jù)添加一個新的主鍵值,也就是創(chuàng)建一個主鍵值不同的新資源（如果沒有業(yè)務(wù)或者外鍵沖突）。所以,創(chuàng)建操作通常應(yīng)當(dāng)設(shè)計為POST方法的API,唯有一種場景應(yīng)當(dāng)使用PUT方法來設(shè)計API,即客戶端在發(fā)起創(chuàng)建請求時候,在同一份數(shù)據(jù)中總可以提供唯一的主鍵值,服務(wù)器不會對其進(jìn)行修改,這樣的創(chuàng)建請求確保了冪等性,不應(yīng)該在使用PUT請求

資源地址設(shè)計

資源地址的設(shè)計對整個REST式的Web服務(wù)至關(guān)重要,設(shè)計系統(tǒng)的可用性和可擴(kuò)展性等諸多方面的表現(xiàn)

1、資源路徑概覽

資源地址的路徑變量使用來表達(dá)邏輯上的層次結(jié)構(gòu)的,資源和子資源的高興事是自左向右、斜杠分隔的名詞。他們的關(guān)系可以是從整體到局部,比如學(xué)校到班級,城市到鄉(xiāng)村.可以是從一般到具體,比如一個生物的“門”、“綱”、“目”、“科”等。。。的資源路徑,資源地址具體的可以分為5個部分,以sehema://host:port/path?queryString為例,如下表格

一個典型的URI如上表所示,包括協(xié)議名稱、主機(jī)名稱、服務(wù)端口、資源地址和查詢字符串5個部分,其中資源地址部分,根據(jù)具體部署的不同或有差別
http://localhost:8080/simple-service-webapp-spring-jpa-jquery/webapi/books/book?id=1

• requestURL
  • http://localhost:8080/simple-service-webapp-spring-jpa-jquery/webapi/books/book?id=1
• ContextPath
  • simple-service-webapp-spring-jpa-jquery
• ServletPath
  • webapi
• PahtInfo
  • books/book

通常使用ContextPath、ServletPaht和PathInfo來細(xì)分資源地址。

• ContextPath: 上下文名稱,通常和部署服務(wù)器的配置或者REST服務(wù)的web.xml配置有關(guān)。
• ServletPath: 是Servlet的名稱,與REST服務(wù)中定義的@ApplicationPath注解或者web.xml的而配置有關(guān)

JAX-RS2定義了@Path注解來定義資源地址

• PathInfo：資源路徑信息,與資源類、子類及勒種的方法蒂尼的@Path注解有關(guān)

2、資源地址和作用域

在路徑變量里面可以使用標(biāo)點(diǎn)符號以輔助增強(qiáng)邏輯清晰性。如下表所示

• 問號(?) 是用來分隔資源路徑地址和查詢字符串,與符號(&)是用來分隔查詢條件的參數(shù),示例代碼如下

GET /books?start=0&size=19

代碼解釋：開始行參數(shù)為0,查詢的條目是19,及從第0行開始查詢?nèi)?9條數(shù)據(jù)

• 逗號(,)是用來分隔有次序的作用域信息,需要注意的是逗號分隔符的邏輯上的順序信息,這種順序可以是約定俗成的,比如先寫經(jīng)度然后緯度;也可以是系統(tǒng)約定的,比如年、月、日、時等。
  舉例來說：按時間區(qū)域查詢圖書,日期信息在資源地址中是采用月、年順序,代碼如下

GET /books/01,2002-12,2014

代碼解釋:查詢2002年1月到2014年12月的這個時間段的圖書,這個例子中還使用到了連字符(-),有時候也可以使用下劃線(_)來做邏輯上的輔助分隔。

• 分號(;)是用來分隔無次序的作用域信息,通常這些信息是邏輯上并列存在的,比如并列的查詢條件,示例代碼如下

GET /books/restful;program=java;type=web

代碼解釋:查詢滿足圖書內(nèi)容為restful的,石宏的編程語言是java的講述的類型是web的圖書列表。