在盛行分布式、微服務(wù)的移動互聯(lián)網(wǎng)時代，微服務(wù)框架和前后端分離方式已經(jīng)成為項目的主流趨勢。近日有很多小伙伴想了解java統(tǒng)一返回類的設(shè)計，今天小千就為大家?guī)砹岁P(guān)于API接口的設(shè)計內(nèi)容，感興趣的小伙伴快來收藏啦！

　　系統(tǒng)架構(gòu)圖

　　接口交互

　　前端和后端進(jìn)行交互，前端按照約定請求URL路徑，并傳入相關(guān)參數(shù)，后端服務(wù)器接收請求，進(jìn)行業(yè)務(wù)處理，返回數(shù)據(jù)給前端。后端服務(wù)器如何實現(xiàn)把數(shù)據(jù)返回給前端？

　　返回格式

　　后端返回給前端我們一般用JSON體方式，定義如下：

　　CODE狀態(tài)碼

　　code返回狀態(tài)碼，一般小伙伴們是在開發(fā)的時候需要什么，就添加什么。

　　如接口要返回用戶權(quán)限異常，我們加一個狀態(tài)碼為101吧，下一次又要加一個數(shù)據(jù)參數(shù)異常，就加一個102的狀態(tài)碼。這樣雖然能夠照常滿足業(yè)務(wù)，但狀態(tài)碼太凌亂了

　　我們應(yīng)該可以參考HTTP請求返回的狀態(tài)碼

　　我們可以參考這樣的設(shè)計，這樣的好處就把錯誤類型歸類到某個區(qū)間內(nèi)，如果區(qū)間不夠，可以設(shè)計成4位數(shù)。

　　這樣前端開發(fā)人員在得到返回值后，根據(jù)狀態(tài)碼就可以知道，大概什么錯誤，再根據(jù)message相關(guān)的信息描述，可以快速定位。

　　Message

　　這個字段相對理解比較簡單，就是發(fā)生錯誤時，如何友好的進(jìn)行提示。一般的設(shè)計是和code狀態(tài)碼一起設(shè)計，如：

　　再在枚舉中定義，狀態(tài)碼

　　狀態(tài)碼和信息就會一一對應(yīng)，比較好維護(hù)。

　　Data

　　返回數(shù)據(jù)體，JSON格式，根據(jù)不同的業(yè)務(wù)又不同的JSON體。

　　我們要設(shè)計一個返回體類Result

　　控制層Controller

　　我們會在controller層處理業(yè)務(wù)請求，并返回給前端，以order訂單為例

　　我們看到在獲得order對象之后，我們是用的Result構(gòu)造方法進(jìn)行包裝賦值，然后進(jìn)行返回。小伙伴們有沒有發(fā)現(xiàn)，構(gòu)造方法這樣的包裝是不是很麻煩，我們可以優(yōu)化一下。

　　美觀美化

　　我們可以在Result類中，加入靜態(tài)方法，一看就懂

　　那我們來改造一下Controller

　　代碼是不是比較簡潔了，也美觀了。

　　優(yōu)雅優(yōu)化

　　上面我們看到在Result類中增加了靜態(tài)方法，使得業(yè)務(wù)處理代碼簡潔了。但小伙伴們有沒有發(fā)現(xiàn)這樣有幾個問題：

　　每個方法的返回都是Result封裝對象，沒有業(yè)務(wù)含義

　　在業(yè)務(wù)代碼中，成功的時候我們調(diào)用Result.success，異常錯誤調(diào)用Result.failure。是不是很多余

　　上面的代碼，判斷id是否為null，其實我們可以使用hibernate validate做校驗，沒有必要在方法體中做判斷。

　　我們最好的方式直接返回真實業(yè)務(wù)對象，最好不要改變之前的業(yè)務(wù)方式，如下圖：

　　這個和我們平時的代碼是一樣的，非常直觀，直接返回order對象，這樣是不是很完美。那實現(xiàn)方案是什么呢？

　　實現(xiàn)方案

　　小伙伴們怎么去實現(xiàn)是不是有點思路，在這個過程中，我們需要做幾個事情：

　　定義一個注解@ResponseResult，表示這個接口返回的值需要包裝一下

　　攔截請求，判斷此請求是否需要被@ResponseResult注解

　　核心步驟就是實現(xiàn)接口ResponseBodyAdvice和@ControllerAdvice，判斷是否需要包裝返回值，如果需要，就把Controller接口的返回值進(jìn)行重寫。

　　注解類

　　用來標(biāo)記方法的返回值，是否需要包裝

　　攔截器

　　攔截請求，是否此請求返回的值需要包裝，其實就是運行的時候，解析@ResponseResult注解

　　此代碼核心思想，就是獲取此請求，是否需要返回值包裝，設(shè)置一個屬性標(biāo)記。

　　重寫返回體

　　上面代碼就是判斷是否需要返回值包裝，如果需要就直接包裝。

　　這里我們只處理了正常成功的包裝，如果方法體報異常怎么辦？處理異常也比較簡單，只要判斷body是否為異常類。

　　怎么做全局的異常處理，篇幅原因，老顧這里就不做介紹了，只要思路理清楚了，自行改造就行。

　　重寫Controller

　　在控制器類上或者方法體上加上@ResponseResult注解，這樣就ok了，簡單吧。到此返回的設(shè)計思路完成，是不是又簡潔，又優(yōu)雅。

　　這個方案還有沒有別的優(yōu)化空間，當(dāng)然是有的。

　　如：每次請求都要反射一下，獲取請求的方法是否需要包裝，其實可以做個緩存，不需要每次都需要解析。當(dāng)然整體思路了解，小伙伴們就可以在此基礎(chǔ)上面自行擴(kuò)展。

　　注：本文部分文字和圖片來源于網(wǎng)絡(luò)，如有侵權(quán)，請聯(lián)系刪除。版權(quán)歸原作者所有!