首页 > 代码库 > Python框架之Django学习笔记（十七）
Python框架之Django学习笔记（十七）
Django框架之表单（续二）
PS:本博客欢迎转发，但请注明博客地址及作者~
博客地址：http://www.cnblogs.com/voidy/
<。)#)))≦
今天的这篇博客将是Django学习笔记博客的最后一篇，基本每周最少一篇的Django框架学习，坚持到今天也实属不易，当然了，这个框架的学习仅仅是Django框架的基础部分了，不过也够我们平时搭个简易的网站或者个人博客什么的。希望通过这一系列的博文，让大家也从中体会到Django框架的魅力所在，如果很不幸，你没有体会到，只能说明我水平有限，无法将如此美丽的事物展示与你，闲话少说，下面开始继续学习表单的相关知识。
编写Contact表单
这个表单包括用户提交的反馈信息，一个可选的e-mail回信地址。 当这个表单提交并且数据通过验证后，系统将自动发送一封包含题用户提交的信息的e-mail给站点工作人员。
1 <html> 2 <head> 3 <title>Contact us</title> 4 </head> 5 <body> 6 <h1>Contact us</h1> 7 8 {% if errors %} 9 <ul>10 {% for error in errors %}11 <li>{{ error }}</li>12 {% endfor %}13 </ul>14 {% endif %}15 16 <form action="/contact/" method="post">17 <p>Subject: <input type="text" name="subject"></p>18 <p>Your e-mail (optional): <input type="text" name="email"></p>19 <p>Message: <textarea name="message" rows="10" cols="50"></textarea></p>20 <input type="submit" value=http://www.mamicode.com/"Submit">21 </form>22 </body>23 </html>
我们定义了三个字段： 主题，e-mail和反馈信息。 除了e-mail字段为可选，其他两个字段都是必填项。 注意，这里我们使用method=”post”而非method=”get”，因为这个表单会有一个服务器端的操作：发送一封e-mail。 并且，我们复制了前一个模板search_form.html中错误信息显示的代码。
如果我们顺着上一节编写search()视图的思路，那么一个contact()视图代码应该像这样：
1 from django.core.mail import send_mail 2 from django.http import HttpResponseRedirect 3 from django.shortcuts import render_to_response 4 5 def contact(request): 6 errors = [] 7 if request.method == ‘POST‘: 8 if not request.POST.get(‘subject‘, ‘‘): 9 errors.append(‘Enter a subject.‘)10 if not request.POST.get(‘message‘, ‘‘):11 errors.append(‘Enter a message.‘)12 if request.POST.get(‘email‘) and ‘@‘ not in request.POST[‘email‘]:13 errors.append(‘Enter a valid e-mail address.‘)14 if not errors:15 send_mail(16 request.POST[‘subject‘],17 request.POST[‘message‘],18 request.POST.get(‘email‘, ‘noreply@example.com‘),19 [‘siteowner@example.com‘],20 )21 return HttpResponseRedirect(‘/contact/thanks/‘)22 return render_to_response(‘contact_form.html‘,23 {‘errors‘: errors})
现在来分析一下以上的代码：
- 确认request.method的值是’POST’。用户浏览表单时这个值并不存在，当且仅当表单被提交时这个值才出现。 （在后面的例子中，request.method将会设置为’GET’，因为在普通的网页浏览中，浏览器都使用GET，而非POST）。判断request.method的值很好地帮助我们将表单显示与表单处理隔离开来。
- 我们使用request.POST代替request.GET来获取提交过来的数据。 这是必须的，因为contact_form.html里表单使用的是method=”post”。如果在视图里通过POST获取数据，那么request.GET将为空。
- 这里，有两个必填项，subject 和 message，所以需要对这两个进行验证。 注意，我们使用request.POST.get()方法，并提供一个空的字符串作为默认值；这个方法很好的解决了键丢失与空数据问题。
- 虽然email非必填项，但如果有提交她的值则我们也需进行验证。 我们的验证算法相当的薄弱，仅验证值是否包含@字符。 在实际应用中，需要更为健壮的验证机制（Django提供这些验证机制，稍候我们就会看到）。
- 我们使用了django.core.mail.send_mail函数来发送e-mail。 这个函数有四个必选参数： 主题，正文，寄信人和收件人列表。 send_mail是Django的EmailMessage类的一个方便的包装，EmailMessage类提供了更高级的方法，比如附件，多部分邮件，以及对于邮件头部的完整控制。
- 注意，若要使用send_mail()函数来发送邮件，那么服务器需要配置成能够对外发送邮件，并且在Django中设置出站服务器地址。参见规范：http://docs.djangoproject.com/en/dev/topics/email/
- 当邮件发送成功之后，我们使用HttpResponseRedirect对象将网页重定向至一个包含成功信息的页面。 包含成功信息的页面这里留给读者去编写（很简单 一个视图/URL映射/一份模板即可），但是我们要解释一下为何重定向至新的页面，而不是在模板中直接调用render_to_response()来输出。
- 原因就是： 若用户刷新一个包含POST表单的页面，那么请求将会重新发送造成重复。 这通常会造成非期望的结果，比如说重复的数据库记录；在我们的例子中，将导致发送两封同样的邮件。 如果用户在POST表单之后被重定向至另外的页面，就不会造成重复的请求了。
- 我们应每次都给成功的POST请求做重定向。 这就是web开发的最佳实践。
contact()视图可以正常工作，但是她的验证功能有些复杂。 想象一下假如一个表单包含一打字段，我们真的将必须去编写每个域对应的if判断语句？
另外一个问题是表单的重新显示。若数据验证失败后，返回客户端的表单中各字段最好是填有原来提交的数据，以便用户查看哪里出现错误（用户也不需再次填写正确的字段值）。 我们可以手动地将原来的提交数据返回给模板，并且必须编辑HTML里的各字段来填充原来的值。
1 # views.py 2 3 def contact(request): 4 errors = [] 5 if request.method == ‘POST‘: 6 if not request.POST.get(‘subject‘, ‘‘): 7 errors.append(‘Enter a subject.‘) 8 if not request.POST.get(‘message‘, ‘‘): 9 errors.append(‘Enter a message.‘)10 if request.POST.get(‘email‘) and ‘@‘ not in request.POST[‘email‘]:11 errors.append(‘Enter a valid e-mail address.‘)12 if not errors:13 send_mail(14 request.POST[‘subject‘],15 request.POST[‘message‘],16 request.POST.get(‘email‘, `‘noreply@example.com`_‘),17 [`‘siteowner@example.com`_‘],18 )19 return HttpResponseRedirect(‘/contact/thanks/‘)20 return render_to_response(‘contact_form.html‘, {21 ‘errors‘: errors,22 **‘subject‘: request.POST.get(‘subject‘, ‘‘),**23 **‘message‘: request.POST.get(‘message‘, ‘‘),**24 **‘email‘: request.POST.get(‘email‘, ‘‘),**25 })26 27 # contact_form.html28 29 <html>30 <head>31 <title>Contact us</title>32 </head>33 <body>34 <h1>Contact us</h1>35 36 {% if errors %}37 <ul>38 {% for error in errors %}39 <li>{{ error }}</li>40 {% endfor %}41 </ul>42 {% endif %}43 44 <form action="/contact/" method="post">45 <p>Subject: <input type="text" name="subject" **value=http://www.mamicode.com/"{{ subject }}"** ></p>46 <p>Your e-mail (optional): <input type="text" name="email" **value=http://www.mamicode.com/"{{ email }}"** ></p>47 <p>Message: <textarea name="message" rows="10" cols="50">**{{ message }}**</textarea></p>48 <input type="submit" value=http://www.mamicode.com/"Submit">49 </form>50 </body>51 </html>
在视图中使用Form类
Django带有一个form库，称为django.forms，这个库可以处理我们本章所提到的包括HTML表单显示以及验证。 接下来我们来深入了解一下form库，并使用它来重写contact表单应用。
1 from django import forms2 3 class ContactForm(forms.Form):4 subject = forms.CharField()5 email = forms.EmailField(required=False)6 message = forms.CharField()
这看上去简单易懂，并且很像在模块中使用的语法。 表单中的每一个字段（域）作为Form类的属性，被展现成Field类。这里只用到CharField和EmailField类型。 每一个字段都默认是必填。要使email成为可选项，我们需要指定required=False。
接下来，我们在使用它重写contact表单应用：
1 # views.py 2 3 from django.shortcuts import render_to_response 4 from mysite.contact.forms import ContactForm 5 6 def contact(request): 7 if request.method == ‘POST‘: 8 form = ContactForm(request.POST) 9 if form.is_valid():10 cd = form.cleaned_data11 send_mail(12 cd[‘subject‘],13 cd[‘message‘],14 cd.get(‘email‘, ‘noreply@example.com‘),15 [‘siteowner@example.com‘],16 )17 return HttpResponseRedirect(‘/contact/thanks/‘)18 else:19 form = ContactForm()20 return render_to_response(‘contact_form.html‘, {‘form‘: form})21 22 # contact_form.html23 24 <html>25 <head>26 <title>Contact us</title>27 </head>28 <body>29 <h1>Contact us</h1>30 31 {% if form.errors %}32 <p style="color: red;">33 Please correct the error{{ form.errors|pluralize }} below.34 </p>35 {% endif %}36 37 <form action="" method="post">38 <table>39 {{ form.as_table }}40 </table>41 <input type="submit" value=http://www.mamicode.com/"Submit">42 </form>43 </body>44 </html>
看看，我们能移除这么多不整齐的代码！ Django的forms框架处理HTML显示、数据校验、数据清理和表单错误重现。
私人定制Form设计
修改form的显示的最快捷的方式是使用CSS。 尤其是错误列表，可以增强视觉效果。自动生成的错误列表精确的使用“<ul class=”errorlist”>”，这样，我们就可以针对它们使用CSS。 下面的CSS让错误更加醒目了：
1 <style type="text/css"> 2 ul.errorlist { 3 margin: 0; 4 padding: 0; 5 } 6 .errorlist li { 7 background-color: red; 8 color: white; 9 display: block;10 font-size: 10px;11 margin: 0 0 3px;12 padding: 4px 5px;13 }14 </style>
虽然，自动生成HTML是很方便的，但是在某些时候，你会想覆盖默认的显示。 {{form.as_table}}和其它的方法在开发的时候是一个快捷的方式，form的显示方式也可以在form中被方便地重写。
1 <html> 2 <head> 3 <title>Contact us</title> 4 </head> 5 <body> 6 <h1>Contact us</h1> 7 8 {% if form.errors %} 9 <p style="color: red;">10 Please correct the error{{ form.errors|pluralize }} below.11 </p>12 {% endif %}13 14 <form action="" method="post">15 <div class="field">16 {{ form.subject.errors }}17 <label for="id_subject">Subject:</label>18 {{ form.subject }}19 </div>20 <div class="field">21 {{ form.email.errors }}22 <label for="id_email">Your e-mail address:</label>23 {{ form.email }}24 </div>25 <div class="field">26 {{ form.message.errors }}27 <label for="id_message">Message:</label>28 {{ form.message }}29 </div>30 <input type="submit" value=http://www.mamicode.com/"Submit">31 </form>32 </body>33 </html>
{{ form.message.errors }} 会在 <ul class="errorlist"> 里面显示，如果字段是合法的，或者form没有被绑定，就显示一个空字符串。 我们还可以把 form.message.errors 当作一个布尔值或者当它是list在上面做迭代， 例如：
1 <div class="field{% if form.message.errors %} errors{% endif %}"> 2 {% if form.message.errors %} 3 <ul> 4 {% for error in form.message.errors %} 5 <li><strong>{{ error }}</strong></li> 6 {% endfor %} 7 </ul> 8 {% endif %} 9 <label for="id_message">Message:</label>10 {{ form.message }}11 </div>
在校验失败的情况下, 这段代码会在包含错误字段的div的class属性中增加一个”errors”，在一个有序列表中显示错误信息。
好了，Django的学习笔记到此就正式结束了，基本的网站搭建管理这点点知识已经足以，恩，基本情况就是酱紫了。
Python框架之Django学习笔记（十七）