[Django Rest framework文檔翻譯]-Request

REST framework的Request類擴(kuò)展自標(biāo)準(zhǔn)的HttpRequest，增加了REST framework靈活的請(qǐng)求解析和請(qǐng)求驗(yàn)證支持。

請(qǐng)求解析

REST framework的Request對(duì)象提供了靈活的請(qǐng)求解析，讓你可以像一般處理普通form數(shù)據(jù)一樣處理帶JSON數(shù)據(jù)或者媒體類型的request。

.data

request.data返回request body解析后的內(nèi)容。這類似于標(biāo)準(zhǔn)的request.POST和request.FILES屬性除了下面幾個(gè)區(qū)別：

• 它包含了所有解析后的內(nèi)容，包括文件類型和非文件類型的輸入
• 它支持除了POST類型以外的其他HTTP方法的內(nèi)容解析，意味著你可以訪問(wèn)PUT和PATCH類型reqeust的內(nèi)容。
• 它提供REST framework靈活的請(qǐng)求解析，而不單單支持from數(shù)據(jù)。舉例說(shuō)你可以像處理form數(shù)據(jù)一樣處理JSON數(shù)據(jù)。
  詳細(xì)信息，參考parsers documentation

.query_params

request.query_params?是比request.GET更貼切的一個(gè)同義詞
為了清楚起見(jiàn)，在你的代碼里，我們推薦你使用request.query_params來(lái)代替Django’s標(biāo)準(zhǔn)request.GET。這樣做可以讓你的代碼更準(zhǔn)確和明了-任何HTTP方法類型都可能包含查詢信息，不緊緊是GET請(qǐng)求。

.parsers

APIView類或者@api_view?裝飾器將保證這個(gè)屬性會(huì)被自動(dòng)賦予一系列的Parser實(shí)例，基于這個(gè)view的parser_class集合或者基于DEFAULT_PARSER_CLASSES設(shè)置
你一般不會(huì)訪問(wèn)這個(gè)屬性

---

如果一個(gè)客戶端發(fā)送了有缺陷的內(nèi)容，那么訪問(wèn)request.data也許會(huì)引起ParseError。默認(rèn)情況下REST framework的APIView類或者@api_view裝飾器將會(huì)捕獲這個(gè)錯(cuò)誤然后返回400 Bad Request的response

如果一個(gè)客戶端發(fā)送了一個(gè)包含有不能解析的content-type那么將會(huì)引起一個(gè)UnsupportedMediaType異常，這個(gè)異常將會(huì)被捕獲并且返回一個(gè)415 Unsupported Media Type response。

---

內(nèi)容協(xié)商

request暴漏了一些屬性是允許你去判斷內(nèi)容協(xié)商階段的結(jié)果。這將允許你去實(shí)現(xiàn)一些行為比如給不同的媒體類型選擇一個(gè)不同的序列化方案

.accepted_renderer

內(nèi)容協(xié)商階段選出來(lái)的渲染器實(shí)例

.accepted_media_type

是一個(gè)字符串用來(lái)表明內(nèi)容協(xié)商階段接受的媒體類型

---

驗(yàn)證

REST framework提供了靈活的，針對(duì)每一個(gè)請(qǐng)求的驗(yàn)證，可以給你的這樣的能力：

• 不同部分的API使用不同的驗(yàn)證策略
• 支持使用多個(gè)驗(yàn)證策略
• 同時(shí)提供即將到來(lái)的request相關(guān)的user和token信息

.user

request.user一般返回django.contrib.auth.models.User的一個(gè)實(shí)例，盡管它的行為取決于你使用的驗(yàn)證策略。
如果request沒(méi)有驗(yàn)證,那么request.user的默認(rèn)值的jdango.contrib.auth.models.AnonymousUser。
更多信息，查看authentication documentation

.auth

request.auth返回任何額外的授權(quán)上下文。reqeust.auth的具體行為取決于使用的認(rèn)證策略，但一般來(lái)說(shuō)它會(huì)是reqeuset請(qǐng)求授權(quán)得到token的實(shí)例。
更多詳細(xì)信息請(qǐng)看?authentication documentation

.authenticators

APIView類或者@api_view裝飾器將會(huì)保證這個(gè)屬性被自動(dòng)設(shè)置為一列Authentication的實(shí)例，基于authentication_classes集合或者基于DEFAULT_AUTHENTICATORS設(shè)置。
你一般不需要訪問(wèn)這個(gè)屬性

---

瀏覽器增強(qiáng)

REST framework支持一些瀏覽器增強(qiáng)比如說(shuō)是基于瀏覽器的PUT，PATCH和DELETE表單

.method

request.method返回請(qǐng)求的HTTP方法大寫(xiě)的字符串表達(dá)。
基于瀏覽器PUT，PATCH，DELETE表單被支持

.content_type

request.content_type，返回一個(gè)代表HTTP請(qǐng)求body媒體類型的字符串對(duì)象，或者一個(gè)空串如果沒(méi)有媒體類型提供的話。你一般不需要直接訪問(wèn)請(qǐng)求的內(nèi)容類型，因?yàn)橐话銇?lái)說(shuō)你會(huì)基于REST框架的默認(rèn)解析行為
如果你確實(shí)需要訪問(wèn)request的媒體類型，你應(yīng)該使用.content_type屬性優(yōu)先于使用request.META.get('HTTP_CONTENT_TYPE')，因?yàn)樗峁┗跒g覽器的非form內(nèi)容。

.stream

request.stream返回request body的流的展現(xiàn)方式
你一般不會(huì)直接訪問(wèn)request的內(nèi)容，因?yàn)槟阋话銜?huì)基于REST 框架的默認(rèn)請(qǐng)求解析實(shí)現(xiàn)

---

標(biāo)準(zhǔn)HttpRequest屬性

因?yàn)镽EST framework的Request類擴(kuò)展自Django’s的HttpRequest，所有其他的標(biāo)準(zhǔn)的屬性和方法都是可用的。舉例來(lái)說(shuō)request.META和request.session字典都和之前一樣
注意因?yàn)閷?shí)現(xiàn)的原因，Request類不是直接繼承子HttpRequest類，而是使用組合擴(kuò)展了它

.version

返會(huì)版本

創(chuàng)作挑戰(zhàn)賽新人創(chuàng)作獎(jiǎng)勵(lì)來(lái)咯，堅(jiān)持創(chuàng)作打卡瓜分現(xiàn)金大獎(jiǎng)

總結(jié)

以上是生活随笔為你收集整理的Django Rest framework Request的全部?jī)?nèi)容，希望文章能夠幫你解決所遇到的問(wèn)題。

如果覺(jué)得生活随笔網(wǎng)站內(nèi)容還不錯(cuò)，歡迎將生活随笔推薦給好友。