HTML表單是網站交互性的經典方式。 本章將介紹如何用Django對用戶提交的表單數據進行處理。html
HTTP協議以"請求-回覆"的方式工做。客戶發送請求時,能夠在請求中附加數據。服務器經過解析請求,就能夠得到客戶傳來的數據,並根據URL來提供特定的服務。sql
咱們在以前的項目中建立一個 search.py 文件,用於接收用戶的請求:django
# -*- 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') # 接收請求數據 def search(request): request.encoding='utf-8' if 'q' in request.GET: message = '你搜索的內容爲: ' + request.GET['q'].encode('utf-8') else: message = '你提交了空表單' return HttpResponse(message)安全
在模板目錄 templates 中添加 search_form.html 表單:服務器
<!DOCTYPE html> <html> <head> <meta charset="utf-8"> <title>菜鳥教程(runoob.com)</title> </head> <body> <form action="/search" method="get"> <input type="text" name="q"> <input type="submit" value="搜索"> </form> </body> </html>cookie
urls.py 規則修改成以下形式:session
from django.conf.urls import url from . import view,testdb,search urlpatterns = [ url(r'^hello$', view.hello), url(r'^testdb$', testdb.testdb), url(r'^search-form$', search.search_form), url(r'^search$', search.search), ]app
訪問地址 http://127.0.0.1:8000/search-form 並搜索,結果以下所示:函數
上面咱們使用了GET方法。視圖顯示和請求處理分紅兩個函數處理。post
提交數據時更經常使用POST方法。咱們下面使用該方法,並用一個URL和處理函數,同時顯示視圖和處理請求。
咱們在tmplate 建立 post.html:
<!DOCTYPE html> <html> <head> <meta charset="utf-8"> <title>菜鳥教程(runoob.com)</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>
在模板的末尾,咱們增長一個 rlt 記號,爲表格處理結果預留位置。
表格後面還有一個{% csrf_token %}的標籤。csrf 全稱是 Cross Site Request Forgery。這是Django提供的防止假裝提交請求的功能。POST 方法提交的表格,必須有此標籤。
在HelloWorld目錄下新建 search2.py 文件並使用 search_post 函數來處理 POST 請求:
# -*- coding: utf-8 -*- from django.shortcuts import render from django.views.decorators import csrf # 接收POST請求數據 def search_post(request): ctx ={} if request.POST: ctx['rlt'] = request.POST['q'] return render(request, "post.html", ctx)
urls.py 規則修改成以下形式:
from django.conf.urls import url from . import view,testdb,search,search2 urlpatterns = [ url(r'^hello$', view.hello), url(r'^testdb$', testdb.testdb), url(r'^search-form$', search.search_form), url(r'^search$', search.search), url(r'^search-post$', search2.search_post), ]
訪問 http://127.0.0.1:8000/search-post 顯示結果以下:
完成以上實例後,咱們的目錄結構爲:
HelloWorld |-- HelloWorld | |-- __init__.py | |-- __init__.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 | |-- admin.pyc | |-- apps.py | |-- migrations | | |-- 0001_initial.py | | |-- 0001_initial.pyc | | |-- __init__.py | | `-- __init__.pyc | |-- models.py | |-- models.pyc | |-- tests.py | `-- views.py |-- db.sqlite3 |-- manage.py `-- templates |-- base.html |-- hello.html |-- post.html `-- search_form.html
每一個 view 函數的第一個參數是一個 HttpRequest 對象,就像下面這個 hello() 函數:
from django.http import HttpResponse def hello(request): return HttpResponse("Hello world")
HttpRequest對象包含當前請求URL的一些信息:
屬性 |
描述 |
path |
請求頁面的全路徑,不包括域名—例如, "/hello/"。 |
method |
請求中使用的HTTP方法的字符串表示。全大寫表示。例如: if request.method == 'GET': |
GET |
包含全部HTTP GET參數的類字典對象。參見QueryDict 文檔。 |
POST |
包含全部HTTP POST參數的類字典對象。參見QueryDict 文檔。 服務器收到空的POST請求的狀況也是有可能發生的。也就是說,表單form經過HTTP POST方法提交請求,可是表單中能夠沒有數據。所以,不能使用語句if request.POST來判斷是否使用HTTP POST方法;應該使用if request.method == "POST" (參見本表的method屬性)。 注意: POST不包括file-upload信息。參見FILES屬性。 |
REQUEST |
爲了方便,該屬性是POST和GET屬性的集合體,可是有特殊性,先查找POST屬性,而後再查找GET屬性。借鑑PHP's $_REQUEST。 例如,若是GET = {"name": "john"} 和POST = {"age": '34'},則 REQUEST["name"] 的值是"john", REQUEST["age"]的值是"34". 強烈建議使用GET and POST,由於這兩個屬性更加顯式化,寫出的代碼也更易理解。 |
COOKIES |
包含全部cookies的標準Python字典對象。Keys和values都是字符串。參見第12章,有關於cookies更詳細的講解。 |
FILES |
包含全部上傳文件的類字典對象。FILES中的每一個Key都是<input type="file" name="" />標籤中name屬性的值. FILES中的每一個value 同時也是一個標準Python字典對象,包含下面三個Keys:
注意:只有在請求方法是POST,而且請求頁面中<form>有enctype="multipart/form-data"屬性時FILES才擁有數據。不然,FILES 是一個空字典。 |
META |
包含全部可用HTTP頭部信息的字典。 例如:
META 中這些頭加上前綴HTTP_最爲Key, 例如:
|
user |
是一個django.contrib.auth.models.User 對象,表明當前登陸的用戶。 若是訪問用戶當前沒有登陸,user將被初始化爲django.contrib.auth.models.AnonymousUser的實例。 你能夠經過user的is_authenticated()方法來辨別用戶是否登陸:
if request.user.is_authenticated(): # Do something for logged-in users. else: # Do something for anonymous users. 只有激活Django中的AuthenticationMiddleware時該屬性纔可用 |
session |
惟一可讀寫的屬性,表明當前會話的字典對象。只有激活Django中的session支持時該屬性纔可用。 參見第12章。 |
raw_post_data |
原始HTTP POST數據,未解析過。 高級處理時會有用處。 |
Request對象也有一些有用的方法:
方法 | 描述 |
---|---|
__getitem__(key) | 返回GET/POST的鍵值,先取POST,後取GET。若是鍵不存在拋出 KeyError。 這是咱們可使用字典語法訪問HttpRequest對象。 例如,request["foo"]等同於先request.POST["foo"] 而後 request.GET["foo"]的操做。 |
has_key() | 檢查request.GET or request.POST中是否包含參數指定的Key。 |
get_full_path() | 返回包含查詢字符串的請求路徑。例如, "/music/bands/the_beatles/?print=true" |
is_secure() | 若是請求是安全的,返回True,就是說,發出的是HTTPS請求。 |
在HttpRequest對象中, GET和POST屬性是django.http.QueryDict類的實例。
QueryDict相似字典的自定義類,用來處理單鍵對應多值的狀況。
QueryDict實現全部標準的詞典方法。還包括一些特有的方法:
方法 | 描述 |
---|---|
__getitem__ |
和標準字典的處理有一點不一樣,就是,若是Key對應多個Value,__getitem__()返回最後一個value。 |
__setitem__ |
設置參數指定key的value列表(一個Python list)。注意:它只能在一個mutable QueryDict 對象上被調用(就是經過copy()產生的一個QueryDict對象的拷貝). |
get() |
若是key對應多個value,get()返回最後一個value。 |
update() |
參數能夠是QueryDict,也能夠是標準字典。和標準字典的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() |
和標準字典的items()方法有一點不一樣,該方法使用單值邏輯的__getitem__(): >>> q = QueryDict('a=1&a=2&a=3') >>> q.items() [('a', '3')] |
values() |
和標準字典的values()方法有一點不一樣,該方法使用單值邏輯的__getitem__(): |
此外, QueryDict也有一些方法,以下表:
方法 | 描述 |
---|---|
copy() |
返回對象的拷貝,內部實現是用Python標準庫的copy.deepcopy()。該拷貝是mutable(可更改的) — 就是說,能夠更改該拷貝的值。 |
getlist(key) |
返回和參數key對應的全部值,做爲一個Python list返回。若是key不存在,則返回空list。 It's guaranteed to return a list of some sort.. |
setlist(key,list_) |
設置key的值爲list_ (unlike __setitem__()). |
appendlist(key,item) |
添加item到和key關聯的內部list. |
setlistdefault(key,list) |
和setdefault有一點不一樣,它接受list而不是單個value做爲參數。 |
lists() |
和items()有一點不一樣, 它會返回key的全部值,做爲一個list, 例如: >>> q = QueryDict('a=1&a=2&a=3') >>> q.lists() [('a', ['1', '2', '3'])]
|
urlencode() |
返回一個以查詢字符串格式進行格式化後的字符串(e.g., "a=2&b=3&b=5"). |