Django框架之表单（续二）

　　今天的这篇博客将是Django学习笔记博客的最后一篇，基本每周最少一篇的Django框架学习，坚持到今天也实属不易，当然了，这个框架的学习仅仅是Django框架的基础部分了，不过也够我们平时搭个简易的网站或者个人博客什么的。希望通过这一系列的博文，让大家也从中体会到Django框架的魅力所在，如果很不幸，你没有体会到，只能说明我水平有限，无法将如此美丽的事物展示与你，闲话少说，下面开始继续学习表单的相关知识。

编写Contact表单

　　这个表单包括用户提交的反馈信息，一个可选的e-mail回信地址。 当这个表单提交并且数据通过验证后，系统将自动发送一封包含题用户提交的信息的e-mail给站点工作人员。

 　　我们从contact_form.html模板入手：
  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="" cols=""></textarea></p>
  20.          <input type="submit" value="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.html
  28.  
  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="{{ subject }}"** ></p>
  46.          <p>Your e-mail (optional): <input type="text" name="email" **value="{{ email }}"** ></p>
  47.          <p>Message: <textarea name="message" rows="" cols="">**{{ message }}**</textarea></p>
  48.          <input type="submit" value="Submit">
  49.      </form>
  50.  </body>
  51.  </html>

在视图中使用Form类

　　Django带有一个form库，称为django.forms，这个库可以处理我们本章所提到的包括HTML表单显示以及验证。 接下来我们来深入了解一下form库，并使用它来重写contact表单应用。

 　　表单框架最主要的用法是，为每一个将要处理的HTML的“<Form>"定义一个Form类。 在这个例子中，我们只有一个" <Form>"，因此我们只需定义一个Form类。 这个类可以存在于任何地方，甚至直接写在"views.py"文件里也行，但是社区的惯例是把Form类都放到一个文件中：forms.py。在存放" views.py" 的目录中，创建这个文件，然后输入：　

  1.  from django import forms
  2.  
  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_data
  11.              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.html
  23.  
  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="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中被方便地重写。

 　　每一个字段部件(<input type=”text”>, <select>, <textarea>, 或者类似)都可以通过访问{{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="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的学习笔记到此就正式结束了，基本的网站搭建管理这点点知识已经足以，恩，基本情况就是酱紫了。

　　

　　PS:本博客欢迎转发，但请注明博客地址及作者~

　　博客地址：http://www.cnblogs.com/voidy/

　　<。)#)))≦

Python框架之Django学习笔记（十七）的更多相关文章

  1. Python框架之Django学习笔记（十一）

    话说上次说到数据库的基本访问,而数据库我们主要进行的操作就是CRUD,也即是做计算处理时的增加(Create).读取(Retrieve)(重新得到数据).更新(Update)和删除(Delete),俗 ...

  2. Python框架之Django学习笔记（十二）

    Django站点管理 十一转眼结束,说好的充电没能顺利开展,反而悠闲的看了电视剧以及去影院看了新上映的<心花路放>.<亲爱的>以及<黄金时代>,说好的劳逸结合现在回 ...

  3. Python框架之Django学习笔记（十）

    又是一周周末,如约学习Django框架.在上一次,介绍了MVC开发模式以及Django自己的MVT开发模式,此次,就从数据处理层Model谈起. 数据库配置 首先,我们需要做些初始配置:我们需要告诉D ...

  4. Python框架之Django学习笔记（六）

    模板 上篇博文学习了动态视图,但是,视图中返回文本的方式有点特别. 也就是说,HTML被直接硬编码在 Python 代码之中. def current_datetime(request): now = ...

  5. Python框架之Django学习笔记（十六）

    Django框架之表单(续) 今天简直无力吐槽了,去了香山,结果和网上看到的简直是天壤之别啊,说好的香山的枫树呢?说好的香山的红叶呢?说好的漫山遍野一片红呢?本以为在山上,一口气爬上去,沿路基本都是翠 ...

  6. Python框架之Django学习笔记（十五）

    表单 从Google的简朴的单个搜索框,到常见的Blog评论提交表单,再到复杂的自定义数据输入接口,HTML表单一直是交互性网站的支柱.本次内容将介绍如何用Django对用户通过表单提交的数据进行访问 ...

  7. Python框架之Django学习笔记（九）

    模型 之前,我们用 Django 建造网站的基本途径: 建立视图和 URLConf . 正如我们所阐述的,视图负责处理一些主观逻辑,然后返回响应结果. 作为例子之一,我们的主观逻辑是要计算当前的日期和 ...

  8. Python框架之Django学习笔记（五）

    第一个Django网页小结 进来的请求转入/hello/. Django通过在ROOT_URLCONF配置来决定根URLconf. Django在URLconf中的所有URL模式中,查找第一个匹配/h ...

  9. Python框架之Django学习笔记（一）

    Django历史: Django 是从真实世界的应用中成长起来的,它是由 堪萨斯(Kansas)州 Lawrence 城中的一个 网络开发小组编写的. 它诞生于 2003 年秋天,那时 Lawrenc ...

随机推荐

  1. 【Android开发笔记】程序崩溃异常总结

    广播注册相关(broadcastReceiver) 没有注册广播就注销广播 注册广播但未注销广播 注册广播后重复注销广播 解决办法: 添加一个布尔变量,注册广播后为true,若为true在执行注销,注 ...

  2. python3爬虫03（find_all用法等）

    #read1.html文件# <html><head><title>The Dormouse's story</title></head># ...

  3. java Vamei快速教程22 内存管理和垃圾回收

    作者:Vamei 出处:http://www.cnblogs.com/vamei 欢迎转载,也请保留这段声明.谢谢! 整个教程中已经不时的出现一些内存管理和垃圾回收的相关知识.这里进行一个小小的总结. ...

  4. 地理位置索引 2d索引

    地址位置索引:将一些点的位置存储在mongodb中,创建索引后,可以按照位置来查找其他点 子分类: .2d索引:平面地理位置索引,用于存储和查找平面上的点. .2dsphere索引:球面地理位置索引, ...

  5. mac 下删除非空文件夹

    Linux中rmdir命令是用来删除空的目录.使用方式: rmdir [-p] dirName 参数: -p 是当子目录被删除后使它也成为空目录的话,则顺便一并删除. 举例说明:rmdir folde ...

  6. 使用webpack从零开始搭建react项目

    webpack中文文档 webpack的安装 yarn add webpack@3.10.1 --dev 需要处理的文件类型 webpack常用模块 webpack-dev-server yarn a ...

  7. 安装Ubuntu桌面环境后只能Guest登录的解决办法

    1.安装Ubuntu桌面环境后,登录界面只显示了Guest 2.在登录界面按住crtl+shift+F1,进入tty模式 3.输入sudo -s进入root模式 4.输入vi /etc/lightdm ...

  8. Linux yum安装

    一．安装Apache软件步骤:1.安装 yum install httpd 2.启动,关闭 重启等命令systemctl start httpd.service(启动)systemctl restar ...

  9. 线程池是什么？Java四种线程池的使用介绍

    使用线程池的好处有很多,比如节省系统资源的开销,节省创建和销毁线程的时间等,当我们需要处理的任务较多时,就可以使用线程池,可能还有很多用户不知道Java线程池如何使用?下面小编给大家分享Java四种线 ...

  10. 正则表达式通用匹配ip地址及主机检测

    在使用正则表达式匹配ip地址时如果不限定ip正确格式,一些场景下可能会产生不一样的结果,比如ip数值超范围,ip段超范围等,在使用正则表达式匹配ip地址时要注意几点: 1,字符界定:使用  \< ...