1、什么是REST？

REST（RepresentationalState Transfer）是Roy Fielding 提出的一個描述互聯(lián)系統(tǒng)架構(gòu)風(fēng)格的名詞。REST定義了一組體系架構(gòu)原則，您可以根據(jù)這些原則設(shè)計以系統(tǒng)資源為中心的Web 服務(wù)，包括使用不同語言編寫的客戶端如何通過 HTTP處理和傳輸資源狀態(tài)。

為什么稱為 REST？Web本質(zhì)上由各種各樣的資源組成，資源由URI 唯一標(biāo)識。瀏覽器（或者任何其它類似于瀏覽器的應(yīng)用程序）將展示出該資源的一種表現(xiàn)方式，或者一種表現(xiàn)狀態(tài)。如果用戶在該頁面中定向到指向其它資源的鏈接，則將訪問該資源，并表現(xiàn)出它的狀態(tài)。這意味著客戶端應(yīng)用程序隨著每個資源表現(xiàn)狀態(tài)的不同而發(fā)生狀態(tài)轉(zhuǎn)移，也即所謂REST。

2、REST成熟度的四個層次

第一個層次（Level0）的Web 服務(wù)只是使用 HTTP 作為傳輸方式，實(shí)際上只是遠(yuǎn)程方法調(diào)用（RPC）的一種具體形 式。SOAP和 XML-RPC都屬于此類。

第二個層次（Level1）的Web 服務(wù)引入了資源的概念。每個資源有對應(yīng)的標(biāo)識符和表達(dá)。

第三個層次（Level2）的Web 服務(wù)使用不同的 HTTP 方法來進(jìn)行不同的操作，并且使用HTTP 狀態(tài)碼來表示不同的結(jié)果。如 HTTPGET 方法來獲取資源，HTTPDELETE 方法來刪除資源。

第四個層次（Level3）的Web 服務(wù)使用 HATEOAS。在資源的表達(dá)中包含了鏈接信息。客戶端可以根據(jù)鏈接來發(fā)現(xiàn)可以執(zhí)行的動作。

其中第三個層次建立了創(chuàng)建、讀取、更新和刪除（create,read, update, and delete，CRUD）操作與 HTTP方法之間的一對一映射。根據(jù)此映射：

（1）若要在服務(wù)器上創(chuàng)建資源，應(yīng)該使用POST 方法。

（2）若要檢索某個資源，應(yīng)該使用GET 方法。

（3）若要更改資源狀態(tài)或?qū)ζ溥M(jìn)行更新，應(yīng)該使用PUT 方法。

（4）若要刪除某個資源，應(yīng)該使用DELETE 方法。

3、HTTP請求的方法

（1）GET：通過請求URI得到資源
（2）POST：用于添加新的內(nèi)容
（3）PUT：用于修改某個內(nèi)容，若不存在則添加
（4）DELETE：刪除某個內(nèi)容
（5）OPTIONS ：詢問可以執(zhí)行哪些方法
（6）HEAD ：類似于GET, 但是不返回body信息，用于檢查對象是否存在，以及得到對象的元數(shù)據(jù)
（7）CONNECT ：用于代理進(jìn)行傳輸，如使用SSL
（8）TRACE：用于遠(yuǎn)程診斷服務(wù)器

4、HTTP請求的狀態(tài)碼

（1）成功Successful2xx：此類狀態(tài)碼標(biāo)識客戶端的請求被成功接收、理解并接受。常見如200（OK）、204（NoContent）。
（2）重定向Redirection3xx：這個類別的狀態(tài)碼標(biāo)識用戶代理要做出進(jìn)一步的動作來完成請求。常見如301（MovedPermanently）、302（MovedTemprarily）。
（3）客戶端錯誤Client Error 4xx：4xx類別的狀態(tài)碼是當(dāng)客戶端象是出錯的時使用的。常見如400（BadRequest）、401（Unauthorized）、403（Forbidden）、404（NotFound)。
（4）服務(wù)器錯誤Server Error 5xx：響應(yīng)狀態(tài)碼以5開頭表示服務(wù)器知道自己出錯或者沒有能力執(zhí)行請求。常見如500（InternalServer Error）、502（BadGateway）、504（GatewayTimeout）。

5、RestTemplate

5.1 簡介

Spring'scentral class for synchronous client-side HTTP access.It simplifies communication with HTTPservers, and enforces RESTful principles. Ithandles HTTP connections, leaving application code to provide URLs(with possible template variables) andextract results.

簡單說就是：簡化了發(fā)起HTTP請求以及處理響應(yīng)的過程，并且支持REST。為什么說簡化了呢？

來看兩種實(shí)現(xiàn)方式

（1）使用java.net包下的URLConnection建立連接

String result= ""; 
  BufferedReaderin = null; 
  try { 
   String urlNameString= url +"?" + param; 
   URL realUrl= new URL(urlNameString); 
   // 打開和URL之間的連接 
   URLConnectionconnection = realUrlopenConnection(); 
   // 設(shè)置通用的請求屬性 
   connectionsetRequestProperty("accept","*/*"); 
   connectionsetRequestProperty("connection","Keep-Alive"); 
   connectionsetRequestProperty("user-agent", 
     "Mozilla/0(compatible; MSIE 0; Windows NT 1;SV1)"); 
   // 建立實(shí)際的連接 
   connectionconnect(); 
   // 獲取所有響應(yīng)頭字段 
   Map<String,List<String>> map = connectiongetHeaderFields(); 
   // 遍歷所有的響應(yīng)頭字段 
   for(String key : mapkeySet()) { 
    Systemoutprintln(key+ "--->" + mapget(key)); 
   } 
   // 定義 BufferedReader輸入流來讀取URL的響應(yīng) 
   in =new BufferedReader(newInputStreamReader( 
     connectiongetInputStream())); 
   String line; 
   while ((line = inreadLine())!= null) { 
    result += line; 
   } 
  } catch (Exception e) { 
   … 
  } 
  // 使用finally塊來關(guān)閉輸入流 
  finally{ 
   // 關(guān)閉流 
  } 

（2）使用RestTempalte

ResponseEntity<SsoUrlPrm>result = restTemplate.getForEntity(requestPathUrl,SsoUrlPrm.class); 

5.2 對外開放的接口

（1）

（2）每一個小類又分三種，這三種有什么區(qū)別？* 第一種和第二種的首個參數(shù)都是用String表示一個URI。但它們的最后一個參數(shù)分別是Object[]和Map* 第三種的首個參數(shù)使用java.net.URI表示一個URI。且只有兩個參數(shù)

這是因?yàn)?，String類型的URI支持占位符。比如：

restTemplate.getForObject("http://example.com/hotels/{hotel}/bookings/{booking}",String.class,"42", "21");

那么最終訪問的URI為：http://example.com/hotels/42/bookings/21

但是String有一個小缺陷：String形式的URI會被URL編碼兩次（URL encode請自行百度），這就要求服務(wù)器在獲取URI中的參數(shù)時主動進(jìn)行一次解碼，但如果服務(wù)的提供者不這么做呢？

這時就需要使用不會使用任何編碼的java.net.URI

PS：參數(shù)‘Class<T>responseType'定義了返回數(shù)據(jù)的類型。

（3）Exchange與其它接口的不同：

>允許調(diào)用者指定HTTP請求的方法（GET,POST,PUT等）

>可以在請求中增加body以及頭信息，其內(nèi)容通過參數(shù)‘HttpEntity<?>requestEntity'描述

>exchange支持‘含參數(shù)的類型'（即泛型類）作為返回類型，該特性通過‘ParameterizedTypeReference<T>responseType'描述。比如：

List<String> a = new ArrayList<String>(); 
System.out.println(a.getClass()); 
System.out.println(a.getClass().getGenericSuperclass()); 
ParameterizedTypeReference pt = new ParameterizedTypeReference<ArrayList<String>>() {}; 
System.out.println(pt.getType()); 

得到的結(jié)果是：

class java.util.ArrayList 
java.util.AbstractList<E> 
java.util.ArrayList<java.lang.String> 

* 這是因?yàn)镻arameterizedTypeReference<ArrayList<String>>并不根據(jù)實(shí)參而是使用getGenericSuperclass()方法獲取其父類的類型（注意這里的new有花括號，是ParameterizedTypeReference的子類），父類的類型通過java.lang.reflect.Type描述，然后通過Type的getActualTypeArguments()獲得了父類的實(shí)參類型，注意得到的Type類，并不是class類。

（4）excute

所有的get、post、delete、put、options、head、exchange方法最終調(diào)用的都是excute方法。舉個栗子:

@Override 
public <T> T getForObject(String url, Class<T> responseType, Object urlVariables) throws RestClientException { 
 RequestCallback requestCallback =  acceptHeaderRequestCallback(responseType); 
 HttpMessageConverterExtractor<T> responseExtractor = new HttpMessageConverterExtractor<T>(responseType, getMessageConverters(), logger); 
 return execute(url, HttpMethodGET, requestCallback, responseExtractor, urlVariables); 
} 

Excute方法只是將String格式的URI轉(zhuǎn)成了java.net.URI，之后調(diào)用了doExecute方法。整個調(diào)用過程

6.doExcute

6.1 定義

protected <T> T doExecute(URI url, HttpMethod method, RequestCallback requestCallback,ResponseExtractor<T> responseExtractor) throws RestClientException {…} 

這里需要了解兩個類： RequestCallback &ResponseExtractor

6.2RequestCallback

Callback interface for code that operates on a ClientHttpRequest. Allows to manipulate the request headers, and write to the request body.

簡單說：用于操作請求頭和body，在請求發(fā)出前執(zhí)行。

該接口有兩個實(shí)現(xiàn)類：

* DELETE、HEAD、OPTIONS沒有使用這個接口。

6.3 發(fā)起請求

6.4ResponseExtractor

6.4.1 定義

Generic callback interface used by RestTemplate's retrieval methods Implementations of this interface perform the actual work of extracting data from a ClientHttpResponse, but don't need to worry about exception handling or closing resources.

簡單說：解析HTTP響應(yīng)的數(shù)據(jù)，而且不需要擔(dān)心異常和資源的關(guān)閉。

該接口有三個實(shí)現(xiàn)類：

6.4.2 提取響應(yīng)body

提取分三步：

（1）提取器HttpMessageConverterExtractor尋找可用的轉(zhuǎn)化器在默認(rèn)的RestTemplate的構(gòu)造函數(shù)中初始化了轉(zhuǎn)化器集合，包括：

除了前五個，其他的轉(zhuǎn)化器會由classloader嘗試加載某個類來判斷工程是否包含某個包，而后決定是否加入轉(zhuǎn)化器集合。

提取器遍歷轉(zhuǎn)化器集合以查找可用的轉(zhuǎn)化器，其中MappingJackson2HttpMessageConverter總是在最后一個，因?yàn)樵擃悓?shí)現(xiàn)了GenericHttpMessageConverter，算是一個通用轉(zhuǎn)化器，只有在找不到合適的轉(zhuǎn)化器時才輪到它。Spring提供了一個該類的實(shí)現(xiàn)，以保證總是能得到該類。

（2）轉(zhuǎn)化器尋找可用的反序列化器

轉(zhuǎn)化器持有一個反序列化器緩存集合，首先從緩存中尋找

如果已有可用的反序列化器，則直接返回。否則創(chuàng)建一個新的反序列化器。

反序列化器保存著待反序列化類的域、方法、構(gòu)造器等信息，反序列化時就是使用構(gòu)造器創(chuàng)建了一個新的實(shí)例。

以jackson為例，創(chuàng)建反序列化器的過程在jackson-databind-xxx.jar中，有興趣的可以看一下。調(diào)用棧如下(由下往上找)：

BeanDeserializerFactory.addBeanProps/addObjectIdReader/addReferenceProperties/addInjectables
BeanDeserializerFactory.buildBeanDeserializer
BeanDeserializerFactory.createBeanDeserializer

（3）反序列化器執(zhí)行反序列化

調(diào)用棧：

以上就是本文的全部內(nèi)容，希望對大家的學(xué)習(xí)有所幫助，也希望大家多多支持腳本之家。

最新評論