Django請求響應物件

發表於2016-03-08
Django物件

請求與響應物件

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

TemplateResponse

相關文章