修改 Django Rest framework ModelViewSet 的默認返回信息

內(nèi)容簡介:drf API 接口默認返回的只是數(shù)據(jù)的JSON字符串礁扮,不包含其它的接口信息瞬沦,甚至有時候格式也不一致,這對前端不太友好僚焦,所以我希望把這個返回修改一下芳悲,往返回信息里面添加一些額外的信息边坤,如首先茧痒,要知道在哪里修改這個返回,翻一下源碼發(fā)現(xiàn)這些返回信息是寫在知道在哪里改后惹苗,接著就是改這些方法的返回信息了耸峭,我希望給前端返回這樣格式的信息:

本文轉(zhuǎn)載自:https://juejin.im/post/5d172420e51d4555fc1accea劳闹,本站轉(zhuǎn)載出于傳遞更多信息之目的洽瞬,版權(quán)歸原作者或者來源機構(gòu)所有伙窃。

drf API 接口默認返回的只是數(shù)據(jù)的?JSON?字符串为障,不包含其它的接口信息鳍怨,甚至有時候格式也不一致,這對前端不太友好鞋喇,所以我希望把這個返回修改一下侦香,往返回信息里面添加一些額外的信息纽疟,如?狀態(tài)?仰挣,?說明?等信息

首先膘壶,要知道在哪里修改這個返回,翻一下源碼發(fā)現(xiàn)這些返回信息是寫在?create()?颓芭、?list()?、?retrieve()?官紫、?update()?州藕、?destroy()?這些方法里的床玻,這些信息都放在?Response?對象里面返回到前端頁面去锈死。

知道在哪里改后喇勋,接著就是改這些方法的返回信息了川背,我希望給前端返回這樣格式的信息:

{'code': 1, 'msg': '成功', 'errors': {}, 'data': []} # errors 放具體的錯誤信息睦优,data 放返回去的數(shù)據(jù)

然后用這個 dict 直接替換 Response 里面的信息就行了汗盘,如下:

替換后隐孽,嘗試請求下接口健蕊,默認的返回格式就變成我們定義的樣子了缩功,但是嫡锌,任務(wù)還沒完成势木,在只有一個接口的情況下,這樣改改沒什么溯壶,但是如果有十幾個甫男,幾十個接口的話,這樣一個個接口去改又跛,不但累人還不好維護效扫,所以這里換種方法。

我們通過定義一個繼承于 ModelViewSet 的類浩习,然后所有的接口不再繼承 ModelViewSet 而繼承于這個?CustomViewSet?谱秽,這就不用一個個接口去改了疟赊,還方便維護近哟。

到此為止吉执,任務(wù)依然沒有完成戳玫,成功的返回我們是定義好了咕宿,但是接口發(fā)生異常的時候府阀,返回的信息還是默認的那些信息肌似,因為我們改的只是正常處理完成后的成功返回诉瓦,異常返回我們是沒有處理睬澡,那異常信息的返回應(yīng)該在哪里改煞聪?

一頓調(diào)試后斗躏,我發(fā)現(xiàn)了當(dāng)接口發(fā)生異常后,是由?exception_handler?這個方法去處理的昔脯。這個方法定義在?rest_framework/views.py?里啄糙,因為這個方法是獨立出來的笛臣,不是定義在 ModelViewSet 里面,所以就沒辦法通過重寫的方法來改了隧饼,我們把整個方法復(fù)制出來沈堡,放在?CustomViewSet?下面(當(dāng)然沒有規(guī)定要放在一起,放在哪里都行燕雁,方便管理就行)诞丽。

可以看出,第95行到98行就是我們需要改的地方拐格,調(diào)試看一下這個對象是怎樣的僧免,然后進一步把里面我們需要的信息提取出來,改成這個樣子:

最重要的一步!要在?settings.py?里面的?REST_FRAMEWORK?(自己添加的)里添加多一條這樣的配置:

REST_FRAMEWORK = {? ? ······? ? ······? ?

? ? 'EXCEPTION_HANDLER': 'common.views.exception_handler'}復(fù)制代碼

這里指定了使用哪個方法作為接口異常的處理器谒所,這個設(shè)置成我們剛剛改那個姐军。

PS: 雖然做了上面的修改后,就修改了系統(tǒng)上大部分的返回信息惊暴,但是有時候我們需要定一個接口不是繼承 ModelViewSet 的卫病,這樣這些修改就不能繼承到了,在這樣的情況下幽告,每寫一次接口,都要自己手動敲一遍這些信息,難免會手快敲錯了媒殉,在這里我定義了一個類:

那上面的接口就可以改成這個樣子了桃犬,更加的方便維護:

?著作權(quán)歸作者所有,轉(zhuǎn)載或內(nèi)容合作請聯(lián)系作者
  • 序言:七十年代末,一起剝皮案震驚了整個濱河市,隨后出現(xiàn)的幾起案子,更是在濱河造成了極大的恐慌奸笤,老刑警劉巖魄宏,帶你破解...
    沈念sama閱讀 212,383評論 6 493
  • 序言:濱河連續(xù)發(fā)生了三起死亡事件,死亡現(xiàn)場離奇詭異,居然都是意外死亡垂涯,警方通過查閱死者的電腦和手機操骡,發(fā)現(xiàn)死者居然都...
    沈念sama閱讀 90,522評論 3 385
  • 文/潘曉璐 我一進店門是掰,熙熙樓的掌柜王于貴愁眉苦臉地迎上來,“玉大人乐尊,你說我怎么就攤上這事夺颤。” “怎么了?”我有些...
    開封第一講書人閱讀 157,852評論 0 348
  • 文/不壞的土叔 我叫張陵备畦,是天一觀的道長允粤。 經(jīng)常有香客問我悉患,道長,這世上最難降的妖魔是什么诺擅? 我笑而不...
    開封第一講書人閱讀 56,621評論 1 284
  • 正文 為了忘掉前任蜓肆,我火速辦了婚禮穴豫,結(jié)果婚禮上,老公的妹妹穿的比我還像新娘。我一直安慰自己烈炭,他們只是感情好霹疫,可當(dāng)我...
    茶點故事閱讀 65,741評論 6 386
  • 文/花漫 我一把揭開白布卢厂。 她就那樣靜靜地躺著姥闭,像睡著了一般门怪。 火紅的嫁衣襯著肌膚如雪官地。 梳的紋絲不亂的頭發(fā)上掩缓,一...
    開封第一講書人閱讀 49,929評論 1 290
  • 那天蠢熄,我揣著相機與錄音炉旷,去河邊找鬼但绕。 笑死,一個胖子當(dāng)著我的面吹牛,可吹牛的內(nèi)容都是我干的本今。 我是一名探鬼主播逛艰,決...
    沈念sama閱讀 39,076評論 3 410
  • 文/蒼蘭香墨 我猛地睜開眼杭抠,長吁一口氣:“原來是場噩夢啊……” “哼沿猜!你這毒婦竟也來了?” 一聲冷哼從身側(cè)響起,我...
    開封第一講書人閱讀 37,803評論 0 268
  • 序言:老撾萬榮一對情侶失蹤躺同,失蹤者是張志新(化名)和其女友劉穎阁猜,沒想到半個月后,有當(dāng)?shù)厝嗽跇淞掷锇l(fā)現(xiàn)了一具尸體笋籽,經(jīng)...
    沈念sama閱讀 44,265評論 1 303
  • 正文 獨居荒郊野嶺守林人離奇死亡蹦漠,尸身上長有42處帶血的膿包…… 初始之章·張勛 以下內(nèi)容為張勛視角 年9月15日...
    茶點故事閱讀 36,582評論 2 327
  • 正文 我和宋清朗相戀三年,在試婚紗的時候發(fā)現(xiàn)自己被綠了车海。 大學(xué)時的朋友給我發(fā)了我未婚夫和他白月光在一起吃飯的照片笛园。...
    茶點故事閱讀 38,716評論 1 341
  • 序言:一個原本活蹦亂跳的男人離奇死亡,死狀恐怖侍芝,靈堂內(nèi)的尸體忽然破棺而出研铆,到底是詐尸還是另有隱情,我是刑警寧澤州叠,帶...
    沈念sama閱讀 34,395評論 4 333
  • 正文 年R本政府宣布棵红,位于F島的核電站,受9級特大地震影響咧栗,放射性物質(zhì)發(fā)生泄漏逆甜。R本人自食惡果不足惜虱肄,卻給世界環(huán)境...
    茶點故事閱讀 40,039評論 3 316
  • 文/蒙蒙 一、第九天 我趴在偏房一處隱蔽的房頂上張望交煞。 院中可真熱鬧咏窿,春花似錦、人聲如沸素征。這莊子的主人今日做“春日...
    開封第一講書人閱讀 30,798評論 0 21
  • 文/蒼蘭香墨 我抬頭看了看天上的太陽御毅。三九已至根欧,卻和暖如春,著一層夾襖步出監(jiān)牢的瞬間端蛆,已是汗流浹背凤粗。 一陣腳步聲響...
    開封第一講書人閱讀 32,027評論 1 266
  • 我被黑心中介騙來泰國打工, 沒想到剛下飛機就差點兒被人妖公主榨干…… 1. 我叫王不留欺税,地道東北人侈沪。 一個月前我還...
    沈念sama閱讀 46,488評論 2 361
  • 正文 我出身青樓,卻偏偏與公主長得像晚凿,于是被迫代替她去往敵國和親亭罪。 傳聞我的和親對象是個殘疾皇子,可洞房花燭夜當(dāng)晚...
    茶點故事閱讀 43,612評論 2 350