JAX-RS(JSR 311 - Java™ API for RESTful Web Services,用于 REST 風(fēng)格的 Web 服務(wù)的 Java™ API)是 Java EE 6 規(guī)范的一部分,其目標(biāo)在于簡化和標(biāo)準(zhǔn)化用 Java 開發(fā) REST 風(fēng)格的 Web 服務(wù)。雖然 Java EE 6 剛出爐的時候,樓主也從頭到尾看過這份規(guī)范,但苦于沒有實際的項目練手,看過又忘了,現(xiàn)在最多算達到大成傻逼的境界。這次邊看邊寫,期望完成后至少能破入小成牛逼。先從 REST 本身開始。
REST(REpresentational State Transfer,代表性狀態(tài)傳輸)自稱是一種風(fēng)格而非標(biāo)準(zhǔn),這在樓主看來有炒作的嫌疑。如果僅僅是一種風(fēng)格,那么不同的框架如何兼容?所以才有 JAX-RS 的誕生。REST 最大的貢獻是帶來了 HTTP 協(xié)議的復(fù)興。為什么叫復(fù)興呢?本來 HTTP 的功能挺豐富的,可惜長期以來只被用作傳輸數(shù)據(jù),大好青年被埋沒了。樓主記得剛開始學(xué) Servlet 的時候,一向是把 doGet
和 doPost
兩個方法一視同仁的,因為書上這么教,很多 Web 框架也這么搞,以至于弄了很久才搞清楚 GET
和 POST
是兩種不同的請求?,F(xiàn)在 REST 拍磚說道,HTTP 早就定義好了一堆操作,以前一直被混淆使用,現(xiàn)在應(yīng)該重新賦予它們本來的意義了,而且如果充分發(fā)揮 HTTP 的功能,完全能夠勝任分布式應(yīng)用的開發(fā)(傳說中的 SOA)。
SOA 的理念在于將系統(tǒng)設(shè)計為一系列可重用的、解耦的、分布式的服務(wù)。這也不是新鮮玩意兒了,早期有 CORBA,稍晚有 SOAP 等等。REST 作為后起之秀,能夠快速崛起,也必有其非同尋常的特色。下面一一列舉。
可尋址性(Addressability)
系統(tǒng)中的每個資源都可以通過唯一標(biāo)識符來訪問。小插一句,“標(biāo)識”的正確讀音是 biāozhì。REST 使用 URI(統(tǒng)一資源標(biāo)識符)管理資源的地址。URI 的概念不解釋。一個 URI 可以指向一個或者多個資源。
統(tǒng)一的受限接口(The Uniform, Constrained Interface)
實際上強調(diào)了 HTTP 操作的原意。REST 主要使用了 GET、PUT、DELETE、POST、HEAD 和 OPTIONS 這 6 種操作。此處有兩個曾經(jīng)被忽略的 HTTP 概念:冪等(idempotent)和安全(safe)。冪等應(yīng)該是 HTTP 從數(shù)學(xué)借來的一個術(shù)語(原始的數(shù)學(xué)意義樓主也不懂),意味著若干次請求的副作用與單次請求相同,或者根本沒有副作用。GET、PUT、DELETE、HEAD 和 OPTIONS 都是冪等的:GET、HEAD 和 OPTIONS 都是讀操作,容易理解;PUT 用于創(chuàng)建或更新已知 URI 的資源,多次創(chuàng)建或更新同一個資源顯然和一次的效果相同;DELETE 刪除資源,亦然。安全表示操作不會影響服務(wù)器的狀態(tài)。GET、HEAD 和 OPTIONS 是安全的。POST 既不冪等又不安全,因為和 PUT 不同,POST 創(chuàng)建資源的時候并不知道資源的 URI,所以多個 POST 請求將會創(chuàng)建多個資源。
面向表象(Representation-Oriented)
表象這個詞有點拗口,傳聞在一個 REST 風(fēng)格的系統(tǒng)中,服務(wù)端和客戶端之間傳輸?shù)倪诉司褪潜硐蟆硐罂梢允羌兾谋?、XML、JSON……或者自編的山寨格式。唉,不就是數(shù)據(jù)么?只不過可以用任意的格式來傳輸,因為 HTTP 正文里面啥都能放。Content-Type
頭用來聲明格式,一般是 MIME(多用途因特網(wǎng)郵件擴展),像 text/plain
、text/html
、application/pdf
這些。MIME 可以帶屬性,例如 text/html; charset=UTF-8
。
無態(tài)通信(Communicate Statelessly)
REST 服務(wù)器只管理資源,而不會像 Web 服務(wù)器一樣記錄客戶的會話狀態(tài),這些應(yīng)該由客戶端來管理,如此就能增強 REST 服務(wù)器的伸縮性。此處的客戶端可以是客戶端程序、瀏覽器,甚至一個 Web 應(yīng)用。總之,REST 只負責(zé)庫管啦!
HATEOAS
猛詞砸來了!HATEOAS = Hypermedia As The Engine Of Application State,超媒體作為應(yīng)用狀態(tài)的引擎,怎么看起來比 SaaS(Software as a Service,軟件作為服務(wù))還要嚇人呢?超文本不過是一只紙老虎,超媒體也瞞不過樓主的天眼:超媒體就是是由文字、圖像、圖形、視頻、音頻……鏈成一體的大雜燴!很簡單的一個例子,有些坑爹的電影網(wǎng)站經(jīng)常發(fā)布一些內(nèi)嵌了廣告的電影,播放的時候會彈出廣告窗口,里面很多鏈接,你去點兩下就中招了:這個電影文件就算是超媒體。
其實這個詞最關(guān)鍵的地方是“狀態(tài)引擎”。例如樓主在去網(wǎng)購,先選了幾個東西,接下來可以干啥呢?可以繼續(xù)選、可以把購物車清空、可以結(jié)賬……樓主可以從現(xiàn)狀“轉(zhuǎn)換”到其他某些狀態(tài),而控制狀態(tài)轉(zhuǎn)換的那個咚咚就被冠名為狀態(tài)引擎。多么聰明的詞匯啊!樓主發(fā)現(xiàn)凡是高手都是造詞磚家呀!用超媒體來控制狀態(tài)轉(zhuǎn)換,就是 HATEOAS:你是要繼續(xù)看電影還是看廣告?看哪個廣告?自己慢慢考慮……
REST 相比 CORBA、SOAP、WS-* 之流確實獨樹一幟,但也難逃玩弄概念的嫌疑。記得大學(xué)里講數(shù)據(jù)庫的老師說過:“你們現(xiàn)在學(xué)了這么多理論,其實以后在工作中未必管用。在大街上隨便找一個軟件培訓(xùn)學(xué)校出來的小伙子,他哪兒懂什么第二第三范式啊?但卻能把數(shù)據(jù)庫玩兒得飛轉(zhuǎn)!”