Django 表單
HTML表單是網(wǎng)站交互性的經(jīng)典方式。 本章將介紹如何用Django對(duì)用戶(hù)提交的表單數(shù)據(jù)進(jìn)行處理。
HTTP 請(qǐng)求
HTTP協(xié)議以"請(qǐng)求－回復(fù)"的方式工作。客戶(hù)發(fā)送請(qǐng)求時(shí)，可以在請(qǐng)求中附加數(shù)據(jù)。服務(wù)器通過(guò)解析請(qǐng)求，就可以獲得客戶(hù)傳來(lái)的數(shù)據(jù)，并根據(jù)URL來(lái)提供特定的服務(wù)。
GET 方法
我們?cè)谥暗捻?xiàng)目中創(chuàng)建一個(gè) search.py 文件，用于接收用戶(hù)的請(qǐng)求：
# -*- coding: utf-8 -*-
from django.http import HttpResponse
from django.shortcuts import render_to_response
# 表單
def search_form(request):
return render_to_response('search_form.html')
# 接收請(qǐng)求數(shù)據(jù)
def search(request):
request.encoding='utf-8'
if 'q' in request.GET:
message = '你搜索的內(nèi)容為: ' + request.GET['q'].encode('utf-8')
else:
message = '你提交了空表單'
return HttpResponse(message)在模板目錄template中添加 search_form.html 表單：
<html> <head> <meta charset="utf-8" /> <title>Search - w3cschool.cc</title> </head> <body> <form action="/search/" method="get"> <input type="text" name="q"> <input type="submit" value="Search"> </form> </body> </html>
urls.py 規(guī)則修改為如下形式：
from django.conf.urls import *
from HelloWorld.view import hello
from HelloWorld.testdb import testdb
from HelloWorld import search
urlpatterns = patterns("",
('^hello/$', hello),
('^testdb/$', testdb),
(r'^search-form/$', search.search_form),
(r'^search/$', search.search),
)訪(fǎng)問(wèn)地址：http://192.168.45.3:8000/search-form/并搜索，結(jié)果如下所示:
POST 方法
上面我們使用了GET方法。視圖顯示和請(qǐng)求處理分成兩個(gè)函數(shù)處理。
提交數(shù)據(jù)時(shí)更常用POST方法。我們下面使用該方法，并用一個(gè)URL和處理函數(shù)，同時(shí)顯示視圖和處理請(qǐng)求。
我們?cè)趖mplate 創(chuàng)建 post.html：
<html>
<head>
<meta charset="utf-8" />
<title>Search - w3cschool.cc</title>
</head>
<body>
<form action="/search-post/" method="post">
{% csrf_token %}
<input type="text" name="q">
<input type="submit" value="Submit">
</form>
<p>{{ rlt }}</p>
</body>
</html>在模板的末尾，我們?cè)黾右粋€(gè)rlt記號(hào)，為表格處理結(jié)果預(yù)留位置。
表格后面還有一個(gè){% csrf_token %}的標(biāo)簽。csrf全稱(chēng)是Cross Site Request Forgery。這是Django提供的防止偽裝提交請(qǐng)求的功能。POST方法提交的表格，必須有此標(biāo)簽。
在HelloWorld目錄下新建 search2.py 文件并使用 search_post 函數(shù)來(lái)處理 POST 請(qǐng)求：
# -*- coding: utf-8 -*-
from django.shortcuts import render
from django.core.context_processors import csrf
# 接收POST請(qǐng)求數(shù)據(jù)
def search_post(request):
ctx ={}
ctx.update(csrf(request))
if request.POST:
ctx['rlt'] = request.POST['q']
return render(request, "post.html", ctx)urls.py 規(guī)則修改為如下形式：
from django.conf.urls import *
from HelloWorld.view import hello
from HelloWorld.testdb import testdb
from HelloWorld import search
from HelloWorld import search2
urlpatterns = patterns("",
('^hello/$', hello),
('^testdb/$', testdb),
(r'^search-form/$', search.search_form),
(r'^search/$', search.search),
(r'^search-post/$', search2.search_post),
)訪(fǎng)問(wèn) http://192.168.45.3:8000/search-post/ 顯示結(jié)果如下：
完成以上實(shí)例后，我們的目錄結(jié)構(gòu)為：
HelloWorld |-- HelloWorld | |-- __init__.py | |-- __init__.pyc | |-- models.pyc | |-- search.py | |-- search.pyc | |-- search2.py | |-- search2.pyc | |-- settings.py | |-- settings.pyc | |-- testdb.py | |-- testdb.pyc | |-- urls.py | |-- urls.pyc | |-- view.py | |-- view.pyc | |-- wsgi.py | `-- wsgi.pyc |-- TestModel | |-- __init__.py | |-- __init__.pyc | |-- admin.py | |-- models.py | |-- models.pyc | |-- tests.py | `-- views.py |-- manage.py `-- templates |-- base.html |-- hello.html |-- post.html `-- search_form.html 3 directories, 29 files
Request 對(duì)象
每個(gè)view函數(shù)的第一個(gè)參數(shù)是一個(gè)HttpRequest對(duì)象，就像下面這個(gè)hello()函數(shù):
from django.http import HttpResponse
def hello(request):
return HttpResponse("Hello world")HttpRequest對(duì)象包含當(dāng)前請(qǐng)求URL的一些信息：
屬性 | 描述 |
path | 請(qǐng)求頁(yè)面的全路徑,不包括域名—例如, "/hello/"。 |
method | 請(qǐng)求中使用的HTTP方法的字符串表示。全大寫(xiě)表示。例如: if request.method == 'GET': |
GET | 包含所有HTTP GET參數(shù)的類(lèi)字典對(duì)象。參見(jiàn)QueryDict 文檔。 |
POST | 包含所有HTTP POST參數(shù)的類(lèi)字典對(duì)象。參見(jiàn)QueryDict 文檔。 服務(wù)器收到空的POST請(qǐng)求的情況也是有可能發(fā)生的。也就是說(shuō)，表單form通過(guò)HTTP POST方法提交請(qǐng)求，但是表單中可以沒(méi)有數(shù)據(jù)。因此，不能使用語(yǔ)句if request.POST來(lái)判斷是否使用HTTP POST方法；應(yīng)該使用if request.method == "POST" (參見(jiàn)本表的method屬性)。 注意: POST不包括file-upload信息。參見(jiàn)FILES屬性。 |
REQUEST | 為了方便，該屬性是POST和GET屬性的集合體，但是有特殊性，先查找POST屬性，然后再查找GET屬性。借鑒PHP's $_REQUEST。 例如，如果GET = {"name": "john"} 和POST = {"age": '34'},則 REQUEST["name"] 的值是"john", REQUEST["age"]的值是"34". 強(qiáng)烈建議使用GET and POST,因?yàn)檫@兩個(gè)屬性更加顯式化，寫(xiě)出的代碼也更易理解。 |
COOKIES | 包含所有cookies的標(biāo)準(zhǔn)Python字典對(duì)象。Keys和values都是字符串。參見(jiàn)第12章，有關(guān)于cookies更詳細(xì)的講解。 |
FILES | 包含所有上傳文件的類(lèi)字典對(duì)象。FILES中的每個(gè)Key都是<input type="file" name="" />標(biāo)簽中name屬性的值. FILES中的每個(gè)value 同時(shí)也是一個(gè)標(biāo)準(zhǔn)Python字典對(duì)象，包含下面三個(gè)Keys:
注意：只有在請(qǐng)求方法是POST，并且請(qǐng)求頁(yè)面中<form>有enctype="multipart/form-data"屬性時(shí)FILES才擁有數(shù)據(jù)。否則，F(xiàn)ILES 是一個(gè)空字典。 |
META | 包含所有可用HTTP頭部信息的字典。 例如:
META 中這些頭加上前綴HTTP_最為Key, 例如:
|
user | 是一個(gè)django.contrib.auth.models.User 對(duì)象，代表當(dāng)前登錄的用戶(hù)。 如果訪(fǎng)問(wèn)用戶(hù)當(dāng)前沒(méi)有登錄，user將被初始化為django.contrib.auth.models.AnonymousUser的實(shí)例。 你可以通過(guò)user的is_authenticated()方法來(lái)辨別用戶(hù)是否登錄： if request.user.is_authenticated(): # Do something for logged-in users. else: # Do something for anonymous users. 只有激活Django中的AuthenticationMiddleware時(shí)該屬性才可用 |
session | 唯一可讀寫(xiě)的屬性，代表當(dāng)前會(huì)話(huà)的字典對(duì)象。只有激活Django中的session支持時(shí)該屬性才可用。 參見(jiàn)第12章。 |
raw_post_data | 原始HTTP POST數(shù)據(jù)，未解析過(guò)。 高級(jí)處理時(shí)會(huì)有用處。 |
Request對(duì)象也有一些有用的方法：
| 方法 | 描述 |
|---|---|
| __getitem__(key) | 返回GET/POST的鍵值,先取POST,后取GET。如果鍵不存在拋出 KeyError。 這是我們可以使用字典語(yǔ)法訪(fǎng)問(wèn)HttpRequest對(duì)象。 例如,request["foo"]等同于先request.POST["foo"] 然后 request.GET["foo"]的操作。 |
| has_key() | 檢查request.GET or request.POST中是否包含參數(shù)指定的Key。 |
| get_full_path() | 返回包含查詢(xún)字符串的請(qǐng)求路徑。例如， "/music/bands/the_beatles/?print=true" |
| is_secure() | 如果請(qǐng)求是安全的，返回True，就是說(shuō)，發(fā)出的是HTTPS請(qǐng)求。 |
QueryDict對(duì)象
在HttpRequest對(duì)象中, GET和POST屬性是django.http.QueryDict類(lèi)的實(shí)例。
QueryDict類(lèi)似字典的自定義類(lèi)，用來(lái)處理單鍵對(duì)應(yīng)多值的情況。
QueryDict實(shí)現(xiàn)所有標(biāo)準(zhǔn)的詞典方法。還包括一些特有的方法：
| 方法 | 描述 |
|---|---|
__getitem__ | 和標(biāo)準(zhǔn)字典的處理有一點(diǎn)不同，就是，如果Key對(duì)應(yīng)多個(gè)Value，__getitem__()返回最后一個(gè)value。 |
__setitem__ | 設(shè)置參數(shù)指定key的value列表(一個(gè)Python list)。注意：它只能在一個(gè)mutable QueryDict 對(duì)象上被調(diào)用(就是通過(guò)copy()產(chǎn)生的一個(gè)QueryDict對(duì)象的拷貝). |
get() | 如果key對(duì)應(yīng)多個(gè)value，get()返回最后一個(gè)value。 |
update() | 參數(shù)可以是QueryDict，也可以是標(biāo)準(zhǔn)字典。和標(biāo)準(zhǔn)字典的update方法不同，該方法添加字典 items，而不是替換它們: >>> q = QueryDict('a=1')
>>> q = q.copy() # to make it mutable
>>> q.update({'a': '2'})
>>> q.getlist('a')
['1', '2']
>>> q['a'] # returns the last
['2'] |
items() | 和標(biāo)準(zhǔn)字典的items()方法有一點(diǎn)不同,該方法使用單值邏輯的__getitem__(): >>> q = QueryDict('a=1&a=2&a=3')
>>> q.items()
[('a', '3')] |
values() | 和標(biāo)準(zhǔn)字典的values()方法有一點(diǎn)不同,該方法使用單值邏輯的__getitem__(): |
此外, QueryDict也有一些方法，如下表：
| 方法 | 描述 |
|---|---|
copy() | 返回對(duì)象的拷貝，內(nèi)部實(shí)現(xiàn)是用Python標(biāo)準(zhǔn)庫(kù)的copy.deepcopy()。該拷貝是mutable(可更改的) — 就是說(shuō)，可以更改該拷貝的值。 |
getlist(key) | 返回和參數(shù)key對(duì)應(yīng)的所有值，作為一個(gè)Python list返回。如果key不存在，則返回空l(shuí)ist。 It's guaranteed to return a list of some sort.. |
setlist(key,list_) | 設(shè)置key的值為list_ (unlike __setitem__()). |
appendlist(key,item) | 添加item到和key關(guān)聯(lián)的內(nèi)部list. |
setlistdefault(key,list) | 和setdefault有一點(diǎn)不同，它接受list而不是單個(gè)value作為參數(shù)。 |
lists() | 和items()有一點(diǎn)不同, 它會(huì)返回key的所有值，作為一個(gè)list, 例如: >>> q = QueryDict('a=1&a=2&a=3')
>>> q.lists()
[('a', ['1', '2', '3'])] |
urlencode() | 返回一個(gè)以查詢(xún)字符串格式進(jìn)行格式化后的字符串(e.g., "a=2&b=3&b=5"). |