Python的Django框架中的表單處理示例

更新時(shí)間：2015年07月17日 15:47:20 投稿：goldensun

這篇文章主要介紹了Python的Django框架中的表單處理示例,表單處理是Django中的基礎(chǔ)操作,需要的朋友可以參考下

組建一個(gè)關(guān)于書(shū)籍、作者、出版社的例子：

from django.db import models

class Publisher(models.Model):
  name = models.CharField(max_length=30)
  address = models.CharField(max_length=50)
  city = models.CharField(max_length=60)
  state_province = models.CharField(max_length=30)
  country = models.CharField(max_length=50)
  website = models.URLField()

class Author(models.Model):
  first_name = models.CharField(max_length=30)
  last_name = models.CharField(max_length=40)
  email = models.EmailField()

class Book(models.Model):
  title = models.CharField(max_length=100)
  authors = models.ManyToManyField(Author)
  publisher = models.ForeignKey(Publisher)
  publication_date = models.DateField()

我們現(xiàn)在來(lái)創(chuàng)建一個(gè)簡(jiǎn)單的view函數(shù)以便讓用戶可以通過(guò)書(shū)名從數(shù)據(jù)庫(kù)中查找書(shū)籍。
通常，表單開(kāi)發(fā)分為兩個(gè)部分：前端HTML頁(yè)面用戶接口和后臺(tái)view函數(shù)對(duì)所提交數(shù)據(jù)的處理過(guò)程。第一部分很簡(jiǎn)單；現(xiàn)在我們來(lái)建立個(gè)view來(lái)顯示一個(gè)搜索表單：

from django.shortcuts import render_to_response

def search_form(request):
  return render_to_response('search_form.html')

這個(gè)view函數(shù)可以放到Python的搜索路徑的任何位置。為了便于討論，咱們將它放在 books/views.py 里。

這個(gè) search_form.html 模板，可能看起來(lái)是這樣的：

<html>
<head>
  <title>Search</title>
</head>
<body>
  <form action="/search/" method="get">
    <input type="text" name="q">
    <input type="submit" value="Search">
  </form>
</body>
</html>

而 urls.py 中的 URLpattern 可能是這樣的：

from mysite.books import views

urlpatterns = patterns('',
  # ...
  (r'^search-form/$', views.search_form),
  # ...
)

（注意，我們直接將views模塊import進(jìn)來(lái)了，而不是用類似 from mysite.views import search_form 這樣的語(yǔ)句，因?yàn)榍罢呖雌饋?lái)更簡(jiǎn)潔。）

現(xiàn)在，如果你運(yùn)行 runserver 命令，然后訪問(wèn)http://127.0.0.1:8000/search-form/，你會(huì)看到搜索界面。非常簡(jiǎn)單。

不過(guò)，當(dāng)你通過(guò)這個(gè)form提交數(shù)據(jù)時(shí)，你會(huì)得到一個(gè)Django 404錯(cuò)誤。這個(gè)Form指向的URL /search/ 還沒(méi)有被實(shí)現(xiàn)。讓我們添加第二個(gè)視圖函數(shù)并設(shè)置URL：

# urls.py

urlpatterns = patterns('',
  # ...
  (r'^search-form/$', views.search_form),
  (r'^search/$', views.search),
  # ...
)

# views.py

def search(request):
  if 'q' in request.GET:
    message = 'You searched for: %r' % request.GET['q']
  else:
    message = 'You submitted an empty form.'
  return HttpResponse(message)

暫時(shí)先只顯示用戶搜索的字詞，以確定搜索數(shù)據(jù)被正確地提交給了Django，這樣你就會(huì)知道搜索數(shù)據(jù)是如何在這個(gè)系統(tǒng)中傳遞的。簡(jiǎn)而言之：

在HTML里我們定義了一個(gè)變量q。當(dāng)提交表單時(shí)，變量q的值通過(guò)GET(method=”get”)附加在URL /search/上。

處理/search/（search()）的視圖通過(guò)request.GET來(lái)獲取q的值。

需要注意的是在這里明確地判斷q是否包含在request.GET中。就像上面request.META小節(jié)里面提到，對(duì)于用戶提交過(guò)來(lái)的數(shù)據(jù)，甚至是正確的數(shù)據(jù)，都需要進(jìn)行過(guò)濾。在這里若沒(méi)有進(jìn)行檢測(cè)，那么用戶提交一個(gè)空的表單將引發(fā)KeyError異常：

# BAD!
def bad_search(request):
  # The following line will raise KeyError if 'q' hasn't
  # been submitted!
  message = 'You searched for: %r' % request.GET['q']
  return HttpResponse(message)

查詢字符串參數(shù)

因?yàn)槭褂肎ET方法的數(shù)據(jù)是通過(guò)查詢字符串的方式傳遞的（例如/search/?q=django），所以我們可以使用requet.GET來(lái)獲取這些數(shù)據(jù)。我們知道在視圖里可以使用request.GET來(lái)獲取傳統(tǒng)URL里的查詢字符串（例如hours=3）。

獲取使用POST方法的數(shù)據(jù)與GET的相似，只是使用request.POST代替了request.GET。那么，POST與GET之間有什么不同？當(dāng)我們提交表單僅僅需要獲取數(shù)據(jù)時(shí)就可以用GET；而當(dāng)我們提交表單時(shí)需要更改服務(wù)器數(shù)據(jù)的狀態(tài)，或者說(shuō)發(fā)送e-mail，或者其他不僅僅是獲取并顯示數(shù)據(jù)的時(shí)候就使用POST。在這個(gè)搜索書(shū)籍的例子里，我們使用GET，因?yàn)檫@個(gè)查詢不會(huì)更改服務(wù)器數(shù)據(jù)的狀態(tài)。 (如果你有興趣了解更多關(guān)于GET和POST的知識(shí)，可以參見(jiàn)http://www.w3.org/2001/tag/doc/whenToUseGet.html。)

既然已經(jīng)確認(rèn)用戶所提交的數(shù)據(jù)是有效的，那么接下來(lái)就可以從數(shù)據(jù)庫(kù)中查詢這個(gè)有效的數(shù)據(jù)（同樣，在views.py里操作）：

from django.http import HttpResponse
from django.shortcuts import render_to_response
from mysite.books.models import Book

def search(request):
  if 'q' in request.GET and request.GET['q']:
    q = request.GET['q']
    books = Book.objects.filter(title__icontains=q)
    return render_to_response('search_results.html',
      {'books': books, 'query': q})
  else:
    return HttpResponse('Please submit a search term.')

讓我們來(lái)分析一下上面的代碼：

除了檢查q是否存在于request.GET之外，我們還檢查來(lái)reuqest.GET[‘q']的值是否為空。
我們使用Book.objects.filter(title__icontains=q)獲取數(shù)據(jù)庫(kù)中標(biāo)題包含q的書(shū)籍。 icontains是一個(gè)查詢關(guān)鍵字。這個(gè)語(yǔ)句可以理解為獲取標(biāo)題里包含q的書(shū)籍，不區(qū)分大小寫(xiě)。
這是實(shí)現(xiàn)書(shū)籍查詢的一個(gè)很簡(jiǎn)單的方法。我們不推薦在一個(gè)包含大量產(chǎn)品的數(shù)據(jù)庫(kù)中使用icontains查詢，因?yàn)槟菚?huì)很慢。（在真實(shí)的案例中，我們可以使用以某種分類的自定義查詢系統(tǒng)。在網(wǎng)上搜索“開(kāi)源全文搜索”看看是否有好的方法）

最后，我們給模板傳遞來(lái)books，一個(gè)包含Book對(duì)象的列表。查詢結(jié)果的顯示模板search_results.html如下所示：

<p>You searched for: <strong>{{ query }}</strong></p>

{% if books %}
  <p>Found {{ books|length }} book{{ books|pluralize }}.</p>
  <ul>
    {% for book in books %}
    <li>{{ book.title }}</li>
    {% endfor %}
  </ul>
{% else %}
  <p>No books matched your search criteria.</p>
{% endif %}

注意這里pluralize的使用，這個(gè)過(guò)濾器在適當(dāng)?shù)臅r(shí)候會(huì)輸出s（例如找到多本書(shū)籍）。

您可能感興趣的文章: