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ò)展了它
