Django Study Note By Btcg

Django框架学习-Forms篇
http://www.cnblogs.com/btchenguang/archive/2012/08/27/2658598.html

Forms
HTML form是交互网页的支柱。下面来学习一下有关使用Django处理用户提交的表单数据,验证等功能。
我们将讨论HttpRequest和Form对象。
request中包含的信息
在views.py中的每一个用于显示页面的函数都需要以request作为第一个函数参数。request包含了一些有用
的信息,如:
request.path 除去了域名和端口的访问路径,
request.get_host 域名+端口信息
request.get_full_path() 所有路径,包含传递的参数
requets.is_secure() 是否使用https进行链接

还有一个特别的属性request.META,它是一个dict类型,包含了所有HTTP header信息,不过也要根据用户
的实际环境来决定。如
HTTP_REFERER
HTTP_USER_AGENT 用户使用的浏览器信息
REMOTE_ADDR 用户的IP,如果使用代理,也可以显示出来
(有很多属性,只是截图了一些)

并不是每一个用户提交的头信息都相同,所以在读取的时候,要考虑一些异常情况,比如取不到相应的值的情况。
可以使用try…except,也可以使用dict.get(key, default)中默认返回为预设值的方法。
def ua_display_good1(request):
try:
ua = request.META['HTTP_USER_AGENT']
except KeyError:
ua = 'unknown'
return HttpResponse("Your browser is %s" % ua)

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

除了以上的这些元数据的信息,HttpRequest对象还包括两个属性包括了用户提交的数据:
request.GET和request.POST。它们都是dictionary-like对象。意思就是说可以像dict那样
操作,但不是dict,还有一些dict没有的操作。

下面构造一个用于用户搜索的简单form例子。
#template/search_form.html
<form action="/search/" method="get">
<input type="text" name="q">
<input type="submit" value="Search">
</form>
#template/search_results.html
<p>Your searched for ' query '
{% if books %}
{% for book in books %}
<li> book.title </li>
{% endfor %}
{% else %}
<p>No books found.
{% endif %}

  1. urls.py

from django.conf.urls import patterns, include, url
from books.views import hello, search_form, search
urlpatterns = patterns('',
url(r'^search-form/$', search_form),
url(r'^search/$', search),
)
#views.py
from django.http import HttpResponse
from django.shortcuts import render_to_response
from books.models import Book

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

def search(request):
if 'q' in request.GET:#GET是一个dict,使用文本框的name作为key
#在这里需要做一个判断,是否存在提交数据,以免报错
q = request.GET['q']
#使用lookup后缀,意思为书名不区分大小写,包含q就可以
books = Book.objects.filter(title__icontains=q)
return render_to_response('search_results.html', {'books' : books, 'query':q})
else:
message = 'You submitted an empty form.'
#只是简单的返回一个response对象,因为没有使用模块,所以也不用渲染数据Context
return HttpResponse(message)

还有一点,form中的action属性如果为空的,代表提交数据到当前页面。

关于表单验证
可以在server端进行,有时会加重server负担,也可以使用Javascript在client端进行。有一点需要注意的是,
即使你使用了javascript在client进行了验证,还是需要在server端对用户提交的数据进行审查,比如有些人
会在浏览器中禁用javascript,也有些人会来搞注入攻击。总之,不能相信用户提交的提交,进行防御性编码。

关于使用重定向
你应当总是在一个成功处理POST请求之后进行redirect,这样可以避免用户多次点击提交按钮带来的二次请求
问题,有时会造成不好的后果,如向数据库插入重复记录等。
from django.http import HttpResponseRedirect
return HttpResponseRedirect('/success/')
使用Django的form system来简化表单工作
在app文件夹下创建forms.py,其实在哪里创建都可以:
from django import forms

class ContactForm(forms.Form):
subject = forms.CharField()
email = forms.EmailField(required=False)
message = forms.CharField()
form的定义和model类的定义很像。我们可以使用python manage.py shell来查看form类的信息。

可以看到打印出来的f的信息其实是网页格式的。
也可以改变默认表格的格式。

这里的<table>,<ul>都没有包含在输出里,所以可以自由地添加行等。
除了打印出整个form的HTML内容,还可以打印出局的字段的内容。

还可以使用form类进行验证,使用dict对form类进行初始化。

f = ContactForm({'subject': 'Hello', 'email': 'moc.elpmaxe|nairda#moc.elpmaxe|nairda', 'message': 'Nice'})
f.is_bound #是否绑定表单类

True

f.is_valid() #数据内容是否合法

True
当数据全部合法时,可以使用clean_data这个属性,用来得到经过'clean'格式化的数据,会所提交过
来的数据转化成合适的Python的类型。

如何在view中使用form类

  1. views.py

from django.shortcuts import render_to_response
from mysite.contact.forms import ContactForm

def contact(request):
#可以不写,因为python中if中定义的变量,也可以在整个函数中可见
form = None
if request.method == 'POST':
form = ContactForm(request.POST)
if form.is_valid():
cd = form.cleaned_data
send_mail(
cd['subject'],
cd['message'],
cd.get('email', 'moc.elpmaxe|ylperon#moc.elpmaxe|ylperon'),
['moc.elpmaxe|renwoetis#moc.elpmaxe|renwoetis'],
)
return HttpResponseRedirect('/contact/thanks/')#需要在urls.py中配置路径
else:
form = ContactForm()
return render_to_response('contact_form.html', {'form': form})

  1. contact_form.html

<html>
<head>
<title>Contact us</title>
</head>
<body>
<h1>Contact us</h1>

{% if form.errors %}
<p style="color: red;">
{# pulralize 是filter,用来判断是否为添加's'来表示单词的复数形式#}
Please correct the error form.errors|pluralize below.
</p>
{% endif %}

<form action="" method="post">
<table>
{# 可以使用as_ul, as_p来改变格式 #}
form.as_table
</table>
<input type="submit" value="Submit">
</form>
</body>
</html>

在构造form的时候,还可以改变字段的构造参数
class ContactForm(forms.Form):
subject = forms.CharField(max_length=100)
email = forms.EmailField(required=False)
message = forms.CharField(widget=forms.Textarea)
还可以给form类添加默认值
form = ContactForm(
initial={'subject': 'I love your site!'}
)

给form类自定义验证规则,如果想要重用验证机制,可以单独创建新的字段类,重新写它的验证方法。
一般的可以直接在form类加入clean_字段名的方法,Django会自动查找以clean_开头的函数名,并会在
验证该字段的时候,运行这个函数。
from django import forms

class ContactForm(forms.Form):
subject = forms.CharField(max_length=100)
email = forms.EmailField(required=False)
message = forms.CharField(widget=forms.Textarea)

def clean_message(self):
message = self.cleaned_data['message']
num_words = len(message.split())
if num_words < 4:
raise forms.ValidationError("Not enough words!")
return message
在自定义的验证函数中,我们必须显示的返回字段名的内容,否则会带来表单数据丢失。

可以改变字段的label显示的名称
email = forms.EmailField(required=False, label='Your e-mail address')