您好,登錄后才能下訂單哦!
前言
我們在django-rest-framework 自定義swagger 文章中編寫了接口, 調(diào)通了接口文檔. 接口文檔可以直接填寫參數(shù)進(jìn)行請求, 接下來的問題是如何接受參數(shù), 由于請求方式與參數(shù)序列化形式的不同, 接收參數(shù)的方式也有不同.
前提條件
服務(wù)端我們使用django-rest-framework編寫接口.
class ReturnJson(APIView): coreapi_fields=( DocParam("token"), ) def get(self, request, *args, **kwargs): return JsonResponse("Hello world!!!!!!!!++++++中文測試")
這是一個(gè)簡單接口, ReturnJson繼承自APIView
而APIView 來自from rest_framework.views import APIView
以下 def get, def post等等的前提條件都是接口類繼承自APIView.
當(dāng)然還可以繼承自其它的類例如.
from rest_framework import viewsets, generics
class ReturnJson(generics.ListCreateAPIView) class ReturnJson(viewsets.ModelViewSet)
他們的用法各有特點(diǎn), 詳情查看
django-rest-framework如何編寫一個(gè)接口.
class ReturnJson(APIView): coreapi_fields=( DocParam("token"), ) def get(self, request, *args, **kwargs): return JsonResponse("Hello world!!!!!!!!++++++中文測試") def post(self, request, *args, **kwargs): return JsonResponse(data={}) def put(self, request, *args, **kwargs): return JsonResponse(data={})
對一個(gè)APIView的子類, 重寫get, post, put等方法就相當(dāng)于解析這個(gè)路徑的get, post, put請求,
請求對象就是request對象, http header body 的內(nèi)容都被包含在request對象中.
request對象的類來自from rest_framework.request import Request
判斷對象是否是某個(gè)類實(shí)例化而來
from rest_framework.request import Request if isinstance(request, Request)
下面分別分析不同情況的參數(shù)位置和類型, 最終寫出一個(gè)方法能夠?qū)⑷魏晤愋偷恼埱髤?shù)統(tǒng)一轉(zhuǎn)換為dict方便之后的邏輯編寫.
GET
get請求中參數(shù)都會(huì)以http://xxx.com/api/getjson?param1=asdf¶m2=123
這樣的形式拼接在url后面.
在request對象中
POST
post 請求參數(shù)都在請求體中, 但是其實(shí)你的url可以寫成get的形式, 最終結(jié)果, 參數(shù)會(huì)有兩部分組成, 一部分在url中, 一部分在http body 中, 但是非常不建議這樣做.
接下來的代碼編寫也不會(huì)考慮這樣的情況, post 僅考慮所有參數(shù)都在http body 中的情況.
提交類型 | 參數(shù)位置 | 參數(shù)類型 |
---|---|---|
form-data提交, | 參數(shù)在data中, | 類型為QueryDict |
application/json提交 | 參數(shù)在data中 | 類型為dict |
(swagger)使用接口文檔提交, 由于使用curl提交, 雖然是post 但是參數(shù)依然被類似get的形式拼接到了url之后, | 此時(shí) 參數(shù)在query_params 中 | 類型為 QueryDict |
x-www-form-urlencoded | 參數(shù)在data中 | 類型為 QueryDict |
PUT
提交類型 | 參數(shù)位置 | 參數(shù)類型 |
---|---|---|
form-data | request.data | QueryDict |
application/json | request.data | dict |
x-www-form-urlencoded | request.data | QueryDict |
(swagger) | request.data | dict |
PATCH
提交類型 | 參數(shù)位置 | 參數(shù)類型 |
---|---|---|
form-data | request.data | QueryDict |
application/json | request.data | dict |
x-www-form-urlencoded | request.data | QueryDict |
(swagger) | request.data | dict |
DELETE
提交類型 | 參數(shù)位置 | 參數(shù)類型 |
---|---|---|
form-data | request.data | QueryDict |
application/json | request.data | dict |
x-www-form-urlencoded | request.data | QueryDict |
(swagger) | request.query_params | QueryDict |
iOS端提交和get情況一樣 | request.query_params | QueryDict |
編寫參數(shù)統(tǒng)一處理的方法
總結(jié)一下, 當(dāng)url有?param=1¶m=2這樣的參數(shù)時(shí)忽略body中的參數(shù), 例如get,delete提交,如果query_params有內(nèi)容, 則忽略body內(nèi)容. 將QueryDict轉(zhuǎn)為dict返回, 再判斷request.data中是否有內(nèi)容, 類型如何.
from django.http import QueryDict from rest_framework.request import Request def get_parameter_dic(request, *args, **kwargs): if isinstance(request, Request) == False: return {} query_params = request.query_params if isinstance(query_params, QueryDict): query_params = query_params.dict() result_data = request.data if isinstance(result_data, QueryDict): result_data = result_data.dict() if query_params != {}: return query_params else: return result_data
使用方法
class ReturnJson(APIView): coreapi_fields=( DocParam("token"), ) def get(self, request, *args, **kwargs): params=get_parameter_dic(request) return JsonResponse(data=params) def post(self, request, *args, **kwargs): params=get_parameter_dic(request) return JsonResponse(data=params) def put(self, request, *args, **kwargs): params=get_parameter_dic(request) return JsonResponse(data=params)
最后的效果
以上就是本文的全部內(nèi)容,希望對大家的學(xué)習(xí)有所幫助,也希望大家多多支持億速云。
免責(zé)聲明:本站發(fā)布的內(nèi)容(圖片、視頻和文字)以原創(chuàng)、轉(zhuǎn)載和分享為主,文章觀點(diǎn)不代表本網(wǎng)站立場,如果涉及侵權(quán)請聯(lián)系站長郵箱:is@yisu.com進(jìn)行舉報(bào),并提供相關(guān)證據(jù),一經(jīng)查實(shí),將立刻刪除涉嫌侵權(quán)內(nèi)容。