Django 表单

有时候我们需要在前台用 get 或 post 方法提交一些数据。

HTML表单是网站交互性的经典方式。

本章将介绍如何用 Django 对用户提交的表单数据进行处理

HTTP 请求

HTTP 协议以 请求－回复 的方式工作。

客户发送请求时，可以在请求中附加数据。服务器通过解析请求，就可以获得客户传来的数据，并根据 URL 来提供特定的服务

GET 方法

继续我们之前的 HelloWorld 项目，在项目中创建一个 search.py 文件，用于接收用户的查询请求

/HelloWorld/HelloWorld/search.py

#! /usr/bin/python
# -*- encoding: utf-8 -*-

'''
filename: search.py
author: 简单教程(www.twle.cn)
copyright: Copyright © 2015-2065 www.twle.cn. All rights reserved.
'''

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']
    else:
        message = '你提交了空表单'
    return HttpResponse(message)

然后在添加模板文件 templates/search_form.html

HelloWorld/templates/search_form.html

<!DOCTYPE html>
<html>
<head>
<meta charset="utf-8">
<title>简单编程(twle.cn)</title>
</head>
<body>
    <form action="/search" method="get">
        <input type="text" name="q">
        <input type="submit" value="搜索">
    </form>
</body>
</html>

最后修改 urls.py 添加路由规则

/HelloWorld/HelloWorld/urls.py

#! /usr/bin/python
# -*- encoding: utf-8 -*-

'''
filename: urls.py
author: 简单教程(www.twle.cn)
copyright: Copyright © 2015-2065 www.twle.cn. All rights reserved.
'''


from django.conf.urls import url
from django.contrib import admin

from . import view, sitedata, search


urlpatterns = [
    url(r'^admin/', admin.site.urls),
    url(r'^hello$', view.hello),
    url(r'^demo$', sitedata.sitedata),
    url(r'^search-form$', search.search_form),  # 添加 search 路由规则
    url(r'^search$', search.search),            # 添加 search 表单处理规则
]

访问地址 http://127.0.0.1:8000/search-form 并搜索，结果如下所示:

POST 方法

上面我们使用了 GET 表单传递数据，视图显示和请求处理分成两个函数处理。

提交数据时更常用的是 POST 方法。

接下来我们使用 HTTP POST 方法提交表单，并用一个 URL 和处理函数，同时显示视图和处理请求

1. 首先，创建 `templates/post.html` 表单

HelloWorld/tmplates/post.html

<!DOCTYPE html>
<html>
<head>
<meta charset="utf-8">
<title>POST 表单 | 简单编程(twle.cn) </title>
</head>
<body>
    <form action="/search-post" method="post">
        {% csrf_token %}
        <input type="text" name="q" value="{{ search_q }}">
        <input type="submit" value="提交">
    </form>

    <p>{{ rs }}</p>
</body>
</html>

在模板的末尾，我们增加一个 rs 模板变量，为表格处理结果预留位置

表单中还有一个 {% csrf_token %} 的标签。csrf 全称是 Cross Site Request Forgery。这是 Django 提供的防止伪装提交请求的功能。 Django 中，POST 方法提交的表单，必须有此标签。

2. 其次，新建文件 `HelloWorld/search2.py`

在 search2.py 中使用 search_post 函数来处理 POST 请求

/HelloWorld/HelloWorld/search2.py

#! /usr/bin/python
# -*- encoding: utf-8 -*-

'''
filename: searach.py
author: 简单教程(www.twle.cn)
copyright: Copyright © 2015-2065 www.twle.cn. All rights reserved.
'''

from django.shortcuts import render
from django.views.decorators import csrf

# 接收POST请求数据


def search_post(request):
    ctx = {}
    ctx['search_q'] = ''
    if request.POST:
        ctx['rs'] = request.POST['q']
        ctx['search_q'] = request.POST['q']
    return render(request, "post.html", ctx)

3. 然后修改 `urls.py` 添加路由规则

/HelloWorld/HelloWorld/urls.py

#! /usr/bin/python
# -*- encoding: utf-8 -*-

'''
filename: urls.py
author: 简单教程(www.twle.cn)
copyright: Copyright © 2015-2065 www.twle.cn. All rights reserved.
'''


from django.conf.urls import url
from django.contrib import admin

from . import view, sitedata, search, search2


urlpatterns = [
    url(r'^admin/', admin.site.urls),
    url(r'^hello$', view.hello),
    url(r'^demo$', sitedata.sitedata),
    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 显示结果如下：

完成以上开发后，我们的目录结果为：

[root@localhost HelloWorld] tree .
HelloWorld
├── DemoModel
│   ├── __init__.py
│   ├── __pycache__
│   │   ├── __init__.cpython-35.pyc
│   │   ├── admin.cpython-35.pyc
│   │   └── models.cpython-35.pyc
│   ├── admin.py
│   ├── apps.py
│   ├── migrations
│   │   ├── 0001_initial.py
│   │   ├── __init__.py
│   │   └── __pycache__
│   │       ├── 0001_initial.cpython-35.pyc
│   │       └── __init__.cpython-35.pyc
│   ├── models.py
│   ├── tests.py
│   └── views.py
├── HelloWorld
│   ├── __init__.py
│   ├── __pycache__
│   │   ├── __init__.cpython-35.pyc
│   │   ├── search.cpython-35.pyc
│   │   ├── search2.cpython-35.pyc
│   │   ├── settings.cpython-35.pyc
│   │   ├── sitedata.cpython-35.pyc
│   │   ├── urls.cpython-35.pyc
│   │   ├── view.cpython-35.pyc
│   │   └── wsgi.cpython-35.pyc
│   ├── search.py
│   ├── search2.py
│   ├── settings.py
│   ├── sitedata.py
│   ├── urls.py
│   ├── view.py
│   └── wsgi.py
├── db.sqlite3
├── manage.py
└── templates
    ├── base.html
    ├── hello.html
    ├── post.html
    └── search_form.html

7 directories, 35 files

Request 对象

每个 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': do_something()elif request.method == 'POST': do_something_else()
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 =
COOKIES	包含所有cookies的标准Python字典对象。Keys和values都是字符串。参见第12章，有关于cookies更详细的讲解。
FILES	包含所有上传文件的类字典对象。FILES中的每个Key都是 <input type="file" name="" />标签中 name 属性的值. FILES中的每个value 同时也是一个标准Python字典对象，包含下面三个Keys:filename: 上传文件名,用Python字符串表示content-type: 上传文件的Content typecontent: 上传文件的原始内容注意：只有在请求方法是POST，并且请求页面中 <form> 有 enctype="multipart/form-data" 属性时 FILES 才拥有数据。否则，FILES 是一个空字典
META	包含所有可用HTTP头部信息的字典。例如:CONTENT_LENGTHCONTENT_TYPEQUERY_STRING: 未解析的原始查询字符串REMOTE_ADDR: 客户端IP地址REMOTE_HOST: 客户端主机名SERVER_NAME: 服务器主机名SERVER_PORT: 服务器端口META 中这些头加上前缀HTTP_最为Key, 例如:HTTP_ACCEPT_ENCODINGHTTP_ACCEPT_LANGUAGEHTTP_HOST: 客户发送的HTTP主机头信息HTTP_REFERER: referring页HTTP_USER_AGENT: 客户端的 user-agent 字符串HTTP_X_BENDER: X-Bender头信息
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请求。

QueryDict对象

在 HttpRequest 对象中, GET 和POST 属性是 django.http.QueryDict 类的实例

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() >>> 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
setlist(key,list_)	设置key的值为list_
appendlist(key,item)	添加item到和key关联的内部list.
setlistdefault(key,list)	和setdefault有一点不同，它接受list而不是单个value作为参数。
lists()	返回所有 key 组成的列表(list) 例如： >>> q = QueryDict('a=1&a=2&a=3') >>> q.lists() [('a', ['1', '2', '3'])]
urlencode()	返回一个以查询字符串格式进行格式化后的字符串例如: a=2&b=3&b=5

HTTP 请求

GET 方法

/HelloWorld/HelloWorld/search.py

HelloWorld/templates/search_form.html

/HelloWorld/HelloWorld/urls.py

POST 方法

1. 首先，创建 templates/post.html 表单

HelloWorld/tmplates/post.html

2. 其次，新建文件 HelloWorld/search2.py

/HelloWorld/HelloWorld/search2.py

3. 然后修改 urls.py 添加路由规则

/HelloWorld/HelloWorld/urls.py

Request 对象

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

QueryDict对象

QueryDict 还包括一些特有的方法

下表列出了 QueryDict 的常用方法：

Django Web 框架

1. 首先，创建 `templates/post.html` 表单

2. 其次，新建文件 `HelloWorld/search2.py`

3. 然后修改 `urls.py` 添加路由规则