如何設計API接口實現(xiàn)統(tǒng)一格式返回-創(chuàng)新互聯(lián)

這篇文章給大家介紹如何設計API接口實現(xiàn)統(tǒng)一格式返回，內(nèi)容非常詳細，感興趣的小伙伴們可以參考借鑒，希望對大家能有所幫助。

成都創(chuàng)新互聯(lián)公司服務項目包括大冶網(wǎng)站建設、大冶網(wǎng)站制作、大冶網(wǎng)頁制作以及大冶網(wǎng)絡營銷策劃等。多年來，我們專注于互聯(lián)網(wǎng)行業(yè)，利用自身積累的技術優(yōu)勢、行業(yè)經(jīng)驗、深度合作伙伴關系等，向廣大中小型企業(yè)、政府機構(gòu)等提供互聯(lián)網(wǎng)行業(yè)的解決方案，大冶網(wǎng)站推廣取得了明顯的社會效益與經(jīng)濟效益。目前，我們服務的客戶以成都為中心已經(jīng)輻射到大冶省份的部分城市，未來相信會繼續(xù)擴大服務區(qū)域并繼續(xù)獲得客戶的支持與信任！

前言

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

一般系統(tǒng)的大致整體架構(gòu)圖如下：

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

接口 交互

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

針對URL路徑的restful風格，以及傳入?yún)?shù)的公共請求頭的要求（如：app_version,api_version,device等），老顧這里就不介紹了，小伙伴們可以自行去了解，也比較簡單。

老顧注重介紹一下后端服務器如何實現(xiàn)把數(shù)據(jù)返回給前端？

返回格式

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

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

CODE狀態(tài)碼

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

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

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

：下面是常見的HTTP狀態(tài)碼：

200 - 請求成功

301 - 資源（網(wǎng)頁等）被永久轉(zhuǎn)移到其它URL

404 - 請求的資源（網(wǎng)頁等）不存在

500 - 內(nèi)部服務器錯誤

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

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

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

Message

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

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

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

Data

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

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

控制層Controller

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

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

美觀優(yōu)化

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

那我們來改造一下Controller

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

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

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

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

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

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

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

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

實現(xiàn)方案

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

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

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

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

注解類

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

攔截器

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

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

重寫返回體

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

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

重新Controller

在控制器類上或者方法體上加上@ResponseResult注解，這樣就ok了，簡單吧。

關于如何設計API接口實現(xiàn)統(tǒng)一格式返回就分享到這里了，希望以上內(nèi)容可以對大家有一定的幫助，可以學到更多知識。如果覺得文章不錯，可以把它分享出去讓更多的人看到。

當前文章：如何設計API接口實現(xiàn)統(tǒng)一格式返回-創(chuàng)新互聯(lián)
網(wǎng)頁網(wǎng)址：http://muchs.cn/article14/ceecde.html

成都網(wǎng)站建設公司_創(chuàng)新互聯(lián)，為您提供手機網(wǎng)站建設、App開發(fā)、域名注冊、網(wǎng)頁設計公司、外貿(mào)網(wǎng)站建設、網(wǎng)站導航

廣告

聲明：本網(wǎng)站發(fā)布的內(nèi)容（圖片、視頻和文字）以用戶投稿、用戶轉(zhuǎn)載內(nèi)容為主，如果涉及侵權(quán)請盡快告知，我們將會在第一時間刪除。文章觀點不代表本網(wǎng)站立場，如需處理請聯(lián)系客服。電話：028-86922220；郵箱：631063699@qq.com。內(nèi)容未經(jīng)允許不得轉(zhuǎn)載，或轉(zhuǎn)載時需注明來源： 創(chuàng)新互聯(lián)