當一個頁面被請示時，Django建立一個包含請求元資料的 HttpRequest 物件。然後Django調入合適的檢視，把 HttpRequest 作為檢視的函式的第一個引數傳入。每個檢視要負責返回一個 HttpResponse 物件。

我們在書中已經使用過這些物件了；這篇附錄說明了 HttpRequest 和 HttpResponse 的全部API。

HttpRequest物件

HttpRequest 表示來自某客戶端的一個單獨的HTTP請求。

HttpRequest例項的屬性包含了關於此次請求的大多數重要資訊

Request物件同樣包含了一些有用的方法，見表H-2。

QueryDict 物件

在一個 HttpRequest 物件中， GET 和 POST 屬性都是 django.http.QueryDict 的例項。 QueryDict 是一個類似於字典的類，專門用來處理用一個鍵的多值。當處理一些HTML表單中的元素，特別是 <select multiple="multiple"> 之類傳遞同一key的多值的元素時，就需要這個類了。

QueryDict 例項是不可變的，除非建立了一個 copy() 副本。也就是說不能直接更改 request.POST 和 request.GET 的屬性。

QueryDict 實現了所有標準的字典的方法，因為它正是字典的一個子類。與其不同的東西都已在表H-3中列出。

另外， QueryDict 還有在表H-4中列出的方法。

一個完整的例子

例如, 給定這個HTML表單:

<form action="/foo/bar/" method="post">

<input type="text" name="your_name" />

<select multiple="multiple" name="bands">

    <option value="beatles">The Beatles</option>

    <option value="who">The Who</option>

    <option value="zombies">The Zombies</option>

</select>

<input type="submit" />

</form>

如果使用者在 your_name 中輸入 "John Smith" ，並且在多選框中同時選擇了The Beatles和The Zombies，那麼以下就是Django的request物件所擁有的：

>>> request.GET

{}

>>> request.POST

{'your_name': ['John Smith'], 'bands': ['beatles', 'zombies']}

>>> request.POST['your_name']

'John Smith'

>>> request.POST['bands']

'zombies'

>>> request.POST.getlist('bands')

['beatles', 'zombies']

>>> request.POST.get('your_name', 'Adrian')

'John Smith'

>>> request.POST.get('nonexistent_field', 'Nowhere Man')

'Nowhere Man'

使用時請注意:

GET , POST , COOKIES , FILES , META , REQUEST , raw_post_data 和 user 這些屬性都是延遲載入的。 也就是說除非程式碼中訪問它們，否則Django並不會花費資源來計算這些屬性值。

HttpResponse

與Django自動建立的 HttpRequest 物件相比， HttpResponse 物件則是由你建立的。你建立的每個檢視都需要例項化，處理和返回一個 HttpResponse 物件。

HttpResponse 類存在於 django.http.HttpResponse 。

構造HttpResponse

一般情況下，你建立一個 HttpResponse 時，以字串的形式來傳遞頁面的內容給 HttpResponse 的建構函式：

>>> response = HttpResponse("Here's the text of the Web page.")

>>> response = HttpResponse("Text only, please.", mimetype="text/plain")

但是如果希望逐漸增加內容，則可以把 response 當作一個類檔案物件使用：

>>> response = HttpResponse()

>>> response.write("<p>Here's the text of the Web page.</p>")

>>> response.write("<p>Here's another paragraph.</p>")

你可以將一個迭代器傳遞給 HttpResponse ，而不是固定的字串。如果你要這樣做的話，請遵循以下規則：

迭代器應返回字串。

若一個 HttpResponse 已經通過例項化，並以一個迭代器作為其內容，就不能以一個類檔案物件使用 HttpResponse 例項。這樣做的話，會導致一個 Exception 。

最後，注意 HttpResponse 實現了一個 write() 方法，使其可以在任何可以使用類檔案物件的地方使用。這方面的例子見第11章。

設定 Headers

您可以使用字典一樣地新增和刪除頭資訊。

>>> response = HttpResponse()

>>> response['X-DJANGO'] = "It's the best."

>>> del response['X-PHP']

>>> response['X-DJANGO']

"It's the best."

你也可以使用 has_header(header) 來檢查一個頭資訊項是否存在。

請避免手工設定 Cookie 頭，參見第12章Django中cookie工作原理的說明。

HttpResponse的子類

Django包含許多處理不同型別的HTTP請求的 HttpResponse 子類（見表H-5）。像 HttpResponse 一樣，這些類在 django.http 中。

當然，如果框架不支援一些特性，你也可以定義自己的 HttpResponse 子類來處理不同的請求。

返回錯誤

在Django中返回HTTP錯誤程式碼很容易。我們前面已經提到 HttpResponseNotFound ， HttpResponseForbidden ， HttpResponseServerError ，和其它子類。為了更好地表示一個錯誤，只要返回這些子類之一的一個例項，而不是一個通常的 HttpResponse ，例如：

def my_view(request):

    # ...

    if foo:

        return HttpResponseNotFound('<h1>Page not found</h1>')

    else:

        return HttpResponse('<h1>Page was found</h1>')

至今為止，404錯誤是最常見的HTTP錯誤，有一種更容易的方式來處理。

當返回一個錯誤，比如 HttpResponseNotFound 時，需要定義錯誤頁面的HTML：

return HttpResponseNotFound('<h1>Page not found</h1>')

為了方便，而且定義一個通用的應用於網站的404錯誤頁面也是一個很好的選擇，Django提供了一個 Http404 異常。如果在檢視的任何地方引發 Http404 異常，Django就會捕獲錯誤並返回應用程式的標準錯誤頁面，當然，還有HTTP錯誤程式碼404。

例如：

from django.http import Http404

def detail(request, poll_id):

    try:

        p = Poll.objects.get(pk=poll_id)

    except Poll.DoesNotExist:

        raise Http404

    return render_to_response('polls/detail.html', {'poll': p})

為了完全發揮出 Http404 的功能，應建立一個模板，在404錯誤被引發時顯示。模板的名字應該是 404.html ，而且應該位於模板樹的最高層。

自定義 404 (無法找到) 檢視

當引發 Http404 異常，Django載入一個專門處理404錯誤的檢視。預設情況下，這個檢視是 django.views.defaults.page_not_found ，它會載入並顯示模板 404.html 。

這意味著需要在根模板目錄定義一個 404.html 模板。這個模板會作用於所有404錯誤。

檢視 page_not_found 適用於99%的網站應用程式，但若是希望過載該檢視，可以在URLconf中指定 handler404 ，就像這樣：

from django.conf.urls.defaults import *

urlpatterns = patterns('',

    ...

)

handler404 = 'mysite.views.my_custom_404_view'

後臺執行時，Django以 handler404 來確定404檢視。預設情況下，URLconf包含以下內容：

from django.conf.urls.defaults import *

這句話負責當前模組中的 handler404 設定。正如你所見，在 django/conf/urls/defaults.py 中， handler404 預設被設為 'django.views.defaults.page_not_found' 。

關於404檢視，有三點需要注意：

當Django在URLconf無法找到匹配的正則表示式時，404檢視會顯示。

如果沒有定義自己的404檢視，而只是簡單地使用預設的檢視，此時就需要在模板目錄的根目錄建立一個 404.html 模板。預設的404檢視會對所有404錯誤使用改模板。

若 DEBUG 被設為 True （在settings模組內），則404檢視不會被使用，此時顯示的是跟蹤資訊。

自定義 500 (伺服器錯誤) 檢視

同樣地，若是在試圖程式碼中出現了執行時錯誤，Django會進行特殊情況處理。如果檢視引發了一個異常，Django會預設訪問檢視 django.views.defaults.server_error ，載入並顯示模板 500.html 。

這意味著需要在根模板目錄定義一個 500.html 模板。該模板作用於所有伺服器錯誤。

檢視 server_error 適用於99%的網站應用程式，但若是希望過載該檢視，可以在URLconf中指定 handler500 ，就像這樣：

from django.conf.urls.defaults import *

urlpatterns = patterns('',

    ...

)

handler500 = 'mysite.views.my_custom_error_view'