JAX-RS 2.0:自定义内容处理
我試圖想到一個更好的標(biāo)題,但未能拿出一個! 請多多包涵……。
JAX-RS 2.0規(guī)范允許我們無縫地將JAXB對象編組到HTTP請求/響應(yīng)主體/從HTTP請求/響應(yīng)主體中解組。 簡而言之,我們可以使用域?qū)ο?#xff0c;而不必?fù)?dān)心基于JAX-RS的解決方案中的低級XML序列化。
在開始之前, 這是指向下面引用的源代碼的GitHub鏈接 –數(shù)量不多,但是以防萬一,您需要窺視一下。
開發(fā)環(huán)境
- Java EE 7(當(dāng)然!)
- JDK 8-不要激動,到目前為止還沒有l(wèi)ambda!
- Netbeans 8
- Wildfly 8和GlassFish 4(是的,已經(jīng)在兩臺服務(wù)器上都進行了測試)–它僅用于在Netbeans中切換服務(wù)器,并且花費大約15-30秒的黑白時間。 因此,這沒什么大不了的!
首先,讓我們看一下用例,這些用例演示了JAX-RS實現(xiàn)的開箱即用功能,以便通過網(wǎng)絡(luò)處理帶有JAXB注釋的實體/域?qū)ο蟆?
這是一個簡單的示例,其中我們嘗試“ 獲取 ”域?qū)ο蟮谋硎?#xff0c;該對象恰好是JAXB 注釋的 POJO
當(dāng)我們觸發(fā)GET HTTP請求時,將獲得以下JSON響應(yīng) 。 這里使用的工具是郵遞員
同樣,也可以通過簡單地切換“ 接受”來觀察XML響應(yīng)。 ? HTTP標(biāo)頭到application / xml
讓我們看一下一種情況,其中我們嘗試通過網(wǎng)絡(luò)“ 發(fā)布 ”域?qū)ο?#xff08;XML / JSON)的表示形式
通過郵遞員啟動POST請求
服務(wù)器日志中STDOUT的代碼段(按照上面的代碼)
因此,我們剛剛看到,在JAXRS中,裝飾有JAXB批注的域?qū)ο罂梢栽诰W(wǎng)上交換XML和JSON格式而不會費勁!
考慮一個場景,在該場景中我們已經(jīng)可以使用豐富的域Java對象。 但
- 我們無權(quán)訪問源代碼
- 我們無法真正使用JAXB批注對其進行批注
- 域?qū)嶓w是不兼容JAXB的舊式POJO。
在這里,我們可以利用JAX-RS 2.0中提供的自定義內(nèi)容處理功能 。 MessageBodyWriter和MessageBodyReader接口為我們提供了一種插入自定義編組/解組機制的方式,并允許JAX-RS運行時處理其余工作!
- 下面的示例主要處理XML和JSON格式,但是請注意,這些接口可用于“任何”數(shù)據(jù)格式-互聯(lián)網(wǎng)上到處都是數(shù)百種,每天都有新的接口出現(xiàn)!
讓我們看一些代碼。 。 。 。 再次…..
首先,為了模擬get場景,讓我們僅從JAXRS資源方法返回Legacy POJO類的實例 。 它與JAXB不兼容 /我們沒有通過JAXB批注裝飾它的源代碼
您如何看待這將通過網(wǎng)絡(luò)串行化為XML ? 我們對javax.ws.rs.ext.MessageBodyWriter接口的定制實現(xiàn)將有助于實現(xiàn)這一點。
此接口具有3個抽象方法,一個需要實現(xiàn)。 該片段展示了writeTo()方法,該方法包含大部分轉(zhuǎn)換邏輯。
- 您可以在Java EE 7 javadocs中進一步了解它
因此,和往常一樣,我們要求郵遞員為我們驗證事情,這就是他不得不說的。 不用麻煩! 想象一下,如果直接從持久性(DB)存儲中獲取舊版POJO表示形式–您需要做的就是將其返回,因為在線表示形式已得到處理。
現(xiàn)在,相反的情況–從我們的客戶端層發(fā)布 XML表示,并觀察它被序列化到Legacy POJO實例中。 想堅持嗎? 當(dāng)然,繼續(xù)執(zhí)行并解雇實體管理器! (不要忘記@ javax.ejb.Stateless !)
您如何看待客戶端發(fā)送的XML有效負(fù)載通過網(wǎng)絡(luò)轉(zhuǎn)換為我們的Leagcy POJO 實例 ? 我們對javax.ws.rs.ext.MessageBodyReader接口的自定義實現(xiàn)將使這種情況發(fā)生。
呼叫Postman,通過網(wǎng)絡(luò)發(fā)布 XML表示,然后查看結(jié)果
只是為了確保我們的舊版POJO確實已序列化– 通過服務(wù)器STDOUT日志進行了確認(rèn)
因此,在一個簡單的示例的幫助下,我們看到了在基于JAXRS的實現(xiàn)中定義用于處理自定義域?qū)ο?實體/ POJO的 自定義轉(zhuǎn)換/類包裝邏輯的簡便性。
簽字之前的幾點觀察
- GlassFish4 中的 JAXRS實現(xiàn)不支持通過裝飾有JAXB的POJO進行無縫JSON序列化/反序列化 。 Wildfly 8的魅力十足 ! 榮譽!
- 在將marshall / unmarshall流程委派給實體攔截器(讀取器/寫入器實現(xiàn))后,無縫JSON支持停止工作(在GlassFish和Wildfly中均是如此)。 不知道為什么。 我猜想JAXRS實現(xiàn)是直接從/分別將有效負(fù)載取回/將有效負(fù)載寫入到輸入/輸出流,并且某種程度上沒有中間層可用于內(nèi)容協(xié)商
我希望我不會在這里錯過任何把戲! 如果您這樣認(rèn)為,請足夠熱情地通知我!
好吧,僅此而已! 編碼愉快…………!
翻譯自: https://www.javacodegeeks.com/2014/04/jax-rs-2-0-custom-content-handling.html
總結(jié)
以上是生活随笔為你收集整理的JAX-RS 2.0:自定义内容处理的全部內(nèi)容,希望文章能夠幫你解決所遇到的問題。
- 上一篇: 安卓版的梦幻花园怎么在苹果下载(安卓版的
- 下一篇: 正确设置JUnit测试名称