www.久久久久|狼友网站av天堂|精品国产无码a片|一级av色欲av|91在线播放视频|亚洲无码主播在线|国产精品草久在线|明星AV网站在线|污污内射久久一区|婷婷综合视频网站

當前位置:首頁 > > 架構師社區(qū)
[導讀]在移動互聯網,分布式、微服務盛行的今天,現在項目絕大部分都采用的微服務框架,前后端分離方式,(題外話:前后端的工作職責越來越明確,現在的前端都稱之為大前端,技術棧以及生態(tài)圈都已經非常成熟;以前后端人員瞧不起前端人員,那現在后端人員要重新認識一下前端,前端已經很成體系了)。

作者:里奧ii
來源:r6d.cn/tEvn

在移動互聯網,分布式、微服務盛行的今天,現在項目絕大部分都采用的微服務框架,前后端分離方式,(題外話:前后端的工作職責越來越明確,現在的前端都稱之為大前端,技術棧以及生態(tài)圈都已經非常成熟;以前后端人員瞧不起前端人員,那現在后端人員要重新認識一下前端,前端已經很成體系了)。

一般系統的大致整體架構圖如下:

看看人家那后端API接口寫得,那叫一個優(yōu)雅!

需要說明的是,有些小伙伴會回復說,這個架構太簡單了吧,太low了,什么網關啊,緩存啊,消息中間件啊,都沒有。因為老顧這篇主要介紹的是API接口,所以我們聚焦點,其他的模塊小伙伴們自行去補充。

接口交互

前端和后端進行交互,前端按照約定請求URL路徑,并傳入相關參數,后端服務器接收請求,進行業(yè)務處理,返回數據給前端。

針對URL路徑的restful風格,以及傳入參數的公共請求頭的要求(如:app_version,api_version,device等),老顧這里就不介紹了,小伙伴們可以自行去了解,也比較簡單。

著重介紹一下后端服務器如何實現把數據返回給前端?

返回格式

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

{??
?#返回狀態(tài)碼??
?code:integer,????
?#返回信息描述??
?message:string,??
?#返回值??
?data:object??
}

CODE狀態(tài)碼

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

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

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

:下面是常見的HTTP狀態(tài)碼:??
200?-?請求成功??
301?-?資源(網頁等)被永久轉移到其它URL??
404?-?請求的資源(網頁等)不存在??
500?-?內部服務器錯誤
看看人家那后端API接口寫得,那叫一個優(yōu)雅!

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

#1000~1999?區(qū)間表示參數錯誤??
#2000~2999?區(qū)間表示用戶錯誤??
#3000~3999?區(qū)間表示接口異常??
?

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

Message

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

看看人家那后端API接口寫得,那叫一個優(yōu)雅!

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

看看人家那后端API接口寫得,那叫一個優(yōu)雅!

狀態(tài)碼和信息就會一一對應,比較好維護。

Data

返回數據體,JSON格式,根據不同的業(yè)務又不同的JSON體。

我們要設計一個返回體類Result

看看人家那后端API接口寫得,那叫一個優(yōu)雅!

控制層Controller


我們會在controller層處理業(yè)務請求,并返回給前端,以order訂單為例 看看人家那后端API接口寫得,那叫一個優(yōu)雅!

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

美觀優(yōu)化

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

看看人家那后端API接口寫得,那叫一個優(yōu)雅!

那我們來改造一下Controller

看看人家那后端API接口寫得,那叫一個優(yōu)雅!

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

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

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

1、每個方法的返回都是Result封裝對象,沒有業(yè)務含義
2、在業(yè)務代碼中,成功的時候我們調用Result.success,異常錯誤調用Result.failure。是不是很多余
3、上面的代碼,判斷id是否為null,其實我們可以使用hibernate validate做校驗,沒有必要在方法體中做判斷。

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

看看人家那后端API接口寫得,那叫一個優(yōu)雅!

這個和我們平時的代碼是一樣的,非常直觀,直接返回order對象,這樣是不是很完美。

那實現方案是什么呢?

實現方案

小伙伴們怎么去實現是不是有點思路,在這個過程中,我們需要做幾個事情

1、定義一個注解@ResponseResult,表示這個接口返回的值需要包裝一下
2、攔截請求,判斷此請求是否需要被@ResponseResult注解
3、核心步驟就是實現接口ResponseBodyAdvice和@ControllerAdvice,判斷是否需要包裝返回值,如果需要,就把Controller接口的返回值進行重寫。

注解類

用來標記方法的返回值,是否需要包裝

看看人家那后端API接口寫得,那叫一個優(yōu)雅!

攔截器

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

看看人家那后端API接口寫得,那叫一個優(yōu)雅!

此代碼核心思想,就是獲取此請求,是否需要返回值包裝,設置一個屬性標記。

重寫返回體

看看人家那后端API接口寫得,那叫一個優(yōu)雅!

上面代碼就是判斷是否需要返回值包裝,如果需要就直接包裝。這里我們只處理了正常成功的包裝,如果方法體報異常怎么辦?處理異常也比較簡單,只要判斷body是否為異常類。

看看人家那后端API接口寫得,那叫一個優(yōu)雅!

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

重寫Controller

看看人家那后端API接口寫得,那叫一個優(yōu)雅!

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

總結

這個方案還有沒有別的優(yōu)化空間,當然是有的。如:每次請求都要反射一下,獲取請求的方法是否需要包裝,其實可以做個緩存,不需要每次都需要解析。當然整體思路了解,小伙伴們就可以在此基礎上面自行擴展。謝謝?。。?/p>


(完)


特別推薦一個分享架構+算法的優(yōu)質內容,還沒關注的小伙伴,可以長按關注一下:

看看人家那后端API接口寫得,那叫一個優(yōu)雅!

看看人家那后端API接口寫得,那叫一個優(yōu)雅!

看看人家那后端API接口寫得,那叫一個優(yōu)雅!

長按訂閱更多精彩▼

看看人家那后端API接口寫得,那叫一個優(yōu)雅!

如有收獲,點個在看,誠摯感謝

免責聲明:本文內容由21ic獲得授權后發(fā)布,版權歸原作者所有,本平臺僅提供信息存儲服務。文章僅代表作者個人觀點,不代表本平臺立場,如有問題,請聯系我們,謝謝!

本站聲明: 本文章由作者或相關機構授權發(fā)布,目的在于傳遞更多信息,并不代表本站贊同其觀點,本站亦不保證或承諾內容真實性等。需要轉載請聯系該專欄作者,如若文章內容侵犯您的權益,請及時聯系本站刪除。
換一批
延伸閱讀

LED驅動電源的輸入包括高壓工頻交流(即市電)、低壓直流、高壓直流、低壓高頻交流(如電子變壓器的輸出)等。

關鍵字: 驅動電源

在工業(yè)自動化蓬勃發(fā)展的當下,工業(yè)電機作為核心動力設備,其驅動電源的性能直接關系到整個系統的穩(wěn)定性和可靠性。其中,反電動勢抑制與過流保護是驅動電源設計中至關重要的兩個環(huán)節(jié),集成化方案的設計成為提升電機驅動性能的關鍵。

關鍵字: 工業(yè)電機 驅動電源

LED 驅動電源作為 LED 照明系統的 “心臟”,其穩(wěn)定性直接決定了整個照明設備的使用壽命。然而,在實際應用中,LED 驅動電源易損壞的問題卻十分常見,不僅增加了維護成本,還影響了用戶體驗。要解決這一問題,需從設計、生...

關鍵字: 驅動電源 照明系統 散熱

根據LED驅動電源的公式,電感內電流波動大小和電感值成反比,輸出紋波和輸出電容值成反比。所以加大電感值和輸出電容值可以減小紋波。

關鍵字: LED 設計 驅動電源

電動汽車(EV)作為新能源汽車的重要代表,正逐漸成為全球汽車產業(yè)的重要發(fā)展方向。電動汽車的核心技術之一是電機驅動控制系統,而絕緣柵雙極型晶體管(IGBT)作為電機驅動系統中的關鍵元件,其性能直接影響到電動汽車的動力性能和...

關鍵字: 電動汽車 新能源 驅動電源

在現代城市建設中,街道及停車場照明作為基礎設施的重要組成部分,其質量和效率直接關系到城市的公共安全、居民生活質量和能源利用效率。隨著科技的進步,高亮度白光發(fā)光二極管(LED)因其獨特的優(yōu)勢逐漸取代傳統光源,成為大功率區(qū)域...

關鍵字: 發(fā)光二極管 驅動電源 LED

LED通用照明設計工程師會遇到許多挑戰(zhàn),如功率密度、功率因數校正(PFC)、空間受限和可靠性等。

關鍵字: LED 驅動電源 功率因數校正

在LED照明技術日益普及的今天,LED驅動電源的電磁干擾(EMI)問題成為了一個不可忽視的挑戰(zhàn)。電磁干擾不僅會影響LED燈具的正常工作,還可能對周圍電子設備造成不利影響,甚至引發(fā)系統故障。因此,采取有效的硬件措施來解決L...

關鍵字: LED照明技術 電磁干擾 驅動電源

開關電源具有效率高的特性,而且開關電源的變壓器體積比串聯穩(wěn)壓型電源的要小得多,電源電路比較整潔,整機重量也有所下降,所以,現在的LED驅動電源

關鍵字: LED 驅動電源 開關電源

LED驅動電源是把電源供應轉換為特定的電壓電流以驅動LED發(fā)光的電壓轉換器,通常情況下:LED驅動電源的輸入包括高壓工頻交流(即市電)、低壓直流、高壓直流、低壓高頻交流(如電子變壓器的輸出)等。

關鍵字: LED 隧道燈 驅動電源
關閉