第七章:表单

  • 格式:pdf
  • 大小:485.76 KB
  • 文档页数:18

The Django Book| 上一章 | 目 录 | 下一章 | 翻译 |

About | Comment help | Contact us | Errata | Buy the print version on Amazon.com

第7章 表单从Google的简朴的单个搜索框,到常见的Blog评论提交表单,再到复杂的自定义数据输入接口,HTML表单一直是交互性网站的支柱。 本章介绍如何用Django对用户通过表单提交的数据进行访问、有效性检查以及其它处理。 与此同时,我们将介绍HttpRequest对象和Form对象。

从Request对象中获取数据我们在第三章讲述View的函数时已经介绍过HttpRequest对象了,但当时并没有讲太多。 让我们回忆下:每个view函数的第一个参数是一个HttpRequest对象,就像下面这个hello()函数:

from django.http import HttpResponsedef hello(request): return HttpResponse("Hello world")

HttpRequest对象,比如上面代码里的request变量,会有一些有趣的、你必须让自己熟悉的属性和方法,以

便知道能拿它们来做些什么。 在view函数的执行过程中,你可以用这些属性来获取当前request的一些信息(比如,你正在加载这个页面的用户是谁,或者用的是什么浏览器)。

URL相关信息

HttpRequest对象包含当前请求URL的一些信息:

属性/方法说明举例request.path除域名以外的请求路径,以正斜杠开头"/hello/"request.get_host()主机名(比如,通常所说的域名)"127.0.0.1:8000" or

"www.example.com"

request.get_full_path()请求路径,可能包含查询字符串"/hello/?print=true"request.is_secure()如果通过HTTPS访问,则此方法返回True, 否则返回FalseTrue 或者 False

在view函数里,要始终用这个属性或方法来得到URL,而不要手动输入。 这会使得代码更加灵活,以便在其它地方重用。 下面是一个简单的例子:

# BAD!def current_url_view_bad(request): return HttpResponse("Welcome to the page at /current/")

# GOODdef current_url_view_good(request): return HttpResponse("Welcome to the page at %s" % request.path)

有关request的其它信息request.META 是一个Python字典,包含了所有本次HTTP请求的Header信息,比如用户IP地址和用户

Agent(通常是浏览器的名称和版本号)。 注意,Header信息的完整列表取决于用户所发送的Header信息和服务器端设置的Header信息。 这个字典中几个常见的键值有:

11

2010-10-19第七章:表单

djangobook.py3k.cn/2.0/chapter07/1/18HTTP_REFERER,进站前链接网页,如果有的话。 (请注意,它是REFERRER的笔误。)

HTTP_USER_AGENT,用户浏览器的user-agent字符串,如果有的话。 例如:"Mozilla/5.0 (X11; U; Linux i686; fr‐FR; rv:1.8.1.17) Gecko/20080829 Firefox/2.0.0.17" .

REMOTE_ADDR 客户端IP,如:"12.345.67.89" 。(如果申请是经过代理服务器的话,那么它可能是以逗号分割的多个IP地址,如:"12.345.67.89,23.456.78.90" 。)

注意,因为 request.META 是一个普通的Python字典,因此当你试图访问一个不存在的键时,会触发一个KeyError异常。 (HTTP header信息是由用户的浏览器所提交的、不应该给予信任的“额外”数据,因此你总

是应该好好设计你的应用以便当一个特定的Header数据不存在时,给出一个优雅的回应。)你应该用try/except 语句,或者用Python字典的 get() 方法来处理这些“可能不存在的键”:

# BAD!def ua_display_bad(request): ua = request.META['HTTP_USER_AGENT'] # Might raise KeyError! return HttpResponse("Your browser is %s" % ua)

# GOOD (VERSION 1)def ua_display_good1(request): try: ua = request.META['HTTP_USER_AGENT'] except KeyError: ua = 'unknown' return HttpResponse("Your browser is %s" % ua)

# GOOD (VERSION 2)def ua_display_good2(request): ua = request.META.get('HTTP_USER_AGENT', 'unknown') return HttpResponse("Your browser is %s" % ua)

我们鼓励你动手写一个简单的view函数来显示 request.META 的所有数据,这样你就知道里面有什么了。 这个view函数可能是这样的:

def display_meta(request): values = request.META.items() values.sort() html = [] for k, v in values: html.append('%s%s' % (k, v)) return HttpResponse('

做为一个练习,看你自己能不能把上面这个view函数改用Django模板系统来实现,而不是上面这样来手动输入HTML代码。 也可以试着把前面提到的 request.path 方法或 HttpRequest 对象的其它方法加进去。

提交的数据信息除了基本的元数据,HttpRequest对象还有两个属性包含了用户所提交的信息: request.GET 和request.POST。二者都是类字典对象,你可以通过它们来访问GET和POST数据。

类字典对象我们说“request.GET和request.POST是类字典对象”,意思是他们的行为像Python里标准的字典对象,但在

技术底层上他们不是标准字典对象。 比如说,request.GET和request.POST都有get()、keys()和values()

方法,你可以用用 for key in request.GET 获取所有的键。

12010-10-19第七章:表单djangobook.py3k.cn/2.0/chapter07/2/18那到底有什么区别呢? 因为request.GET和request.POST拥有一些普通的字典对象所没有的方法。 我们会稍后讲到。

你可能以前遇到过相似的名字:类文件对象,这些Python对象有一些基本的方法,如read(),用来做真正的Python文件对象的代用品。

POST数据是来自HTML中的〈form〉标签提交的,而GET数据可能来自〈form〉提交也可能是URL中的查询字符串(the query string)。

一个简单的表单处理示例继续本书一直进行的关于书籍、作者、出版社的例子,我们现在来创建一个简单的view函数以便让用户可以通过书名从数据库中查找书籍。

通常,表单开发分为两个部分: 前端HTML页面用户接口和后台view函数对所提交数据的处理过程。 第一部分很简单;现在我们来建立个view来显示一个搜索表单:

from django.shortcuts import render_to_responsedef search_form(request): return render_to_response('search_form.html')

在第三章已经学过,这个view函数可以放到Python的搜索路径的任何位置。 为了便于讨论,咱们将它放在books/views.py 里。

这个 search_form.html 模板,可能看起来是这样的: Search

而 urls.py 中的 URLpattern 可能是这样的:from mysite.books import viewsurlpatterns = patterns('', # ... (r'^search‐form/$', views.search_form), # ...)

(注意,我们直接将views模块import进来了,而不是用类似 from mysite.views import search_form 这样的语句,因为前者看起来更简洁。 我们将在第8章讲述更多的关于import的用法。)

现在,如果你运行 runserver 命令,然后访问http://127.0.0.1:8000/search‐form/,你会看到搜索界面。 非

常简单。

不过,当你通过这个form提交数据时,你会得到一个Django 404错误。 这个Form指向的URL /search/ 还没有被实现。 让我们添加第二个视图函数并设置URL:

323

2010-10-19第七章:表单

djangobook.py3k.cn/2.0/chapter07/3/18