請求與響應對象
HttpRequest
HttpRequest存儲了客戶請求的相關參數和一些查詢方法。
- path
請求頁面的全路徑,不包括域名—例如, "/hello/"。
- method
Http請求方法,包括'GET','POST'。
- GET
QueryDict類實例,包含所有HTTP GET參數的字典對象。
- POST
QueryDict類實例,包含所有HTTP POST參數的字典對象。
- REQUEST
為了方便,該屬性是POST和GET屬性的集合。
- COOKIES
包含所有Cookies的標准Python字典對象,Keys和Values都是字符串。
HttpRequest.get_signed_cookie(key, default=RAISE_ERROR, salt='', max_age=None)
返回簽名過的Cookie 對應的值,如果簽名不再合法則返回django.core.signing.BadSignature。如果提供default 參數,將不會引發異常並返回default 的值。
可選參數salt可以用來對安全密鑰強力攻擊提供額外的保護。
max_age參數用於檢查Cookie 對應的時間戳以確保Cookie 的時間不會超過max_age秒。
HttpRequest.session.set_test_cookie()
設置測試cookie,檢驗客戶端是否支持cookie
HttpRequest.session.test_cookie_worked()
檢測測試cookie,客戶端支持時返回True。
在set_test_cookie
的同一次請求-響應中test_cookie_worked
的結果是不可靠的。
- FILES
包含所有上傳文件的類字典對象。
FILES中的每個Key都是<input type="file" name="" />
標簽中name屬性的值,FILES中的每個value 同時也是一個標准Python字典對象,包含3個Key:
"filename"
"content-type"
"content"
- META
包含所有可用HTTP頭信息的字典,其中的Key包括:
HTTP_ACCEPT_ENCODING
HTTP_ACCEPT_LANGUAGE
HTTP_HOST
: 客戶發送的HTTP主機頭信息
HTTP_REFERER
: referring頁
HTTP_USER_AGENT
: 客戶端的user-agent字符串
HTTP_X_BENDER
: X-Bender頭信息
- session
可讀寫的session對象
- raw_post_data
原始的POST數據
- 其它
HttpRequest.is_secure()
請求是否由Https協議發起
HttpRequest.is_ajax()
請求是否由Ajax協議發起
QueryDict
HttpRequest中的GET和POST屬性都是django.http.QueryDict類的實例,它是dict派生類。提供了對一鍵多值的支持和相關操作方法。
HttpResponse
- content
HttpResponsee.content是存儲響應內容的字符串,
- item
HttpResponse.__setitem__(header, value)
設置響應頭屬性
HttpResponse.__delitem__(header)
刪除響應頭屬性
HttpResponse.__getitem__(header)
訪問響應頭屬性
HttpResponse.has_header(header)
檢查是否存在響應頭屬性
- cookie
HttpResponse.set_cookie(key, value='', max_age=None, expires=None, path='/', domain=None, secure=None, httponly=False)
設置cookie
HttpResponse.delete_cookie(key, path='/', domain=None)
刪除cookie
HttpResponse.set_signed_cookie(key, value, salt='', max_age=None, expires=None, path='/', domain=None, secure=None, httponly=True)
使用帶有密鑰簽名的數據
JsonResponse
JsonResponse是HttpResponse的子類,用於生成一個Json格式而非html/xml的響應。
JsonResponse.__init__(data, encoder=DjangoJSONEncoder, safe=True, **kwargs)
在safe參數為True時,只接受dict對象作為參數,並將Dict作為Json字符串;在safe=False時使用ncoder=django.core.serializers.json.DjangoJSONEncoder
參數指定的encoder。
from django.http import JsonResponse
def test_json(request):
response = JsonResponse({'foo': 'bar'})
return response