首页
所有分类
TAGS
文字工具 EMOJI BIBLE
编程 Python

在Django框架中编写Contact表单的教程

Posted in Python onJuly 17, 2015

虽然我们一直使用书籍搜索的示例表单，并将起改进的很完美，但是这还是相当的简陋： 只包含一个字段，q。这简单的例子，我们不需要使用Django表单库来处理。 但是复杂一点的表单就需要多方面的处理，我们现在来一下一个较为复杂的例子： 站点联系表单。

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

我们从contact_form.html模板入手：

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

  {% if errors %}
    <ul>
      {% for error in errors %}
      <li>{{ error }}</li>
      {% endfor %}
    </ul>
  {% endif %}

  <form action="/contact/" method="post">
    <p>Subject: <input type="text" name="subject"></p>
    <p>Your e-mail (optional): <input type="text" name="email"></p>
    <p>Message: <textarea name="message" rows="10" cols="50"></textarea></p>
    <input type="submit" value="Submit">
  </form>
</body>
</html>

我们定义了三个字段： 主题，e-mail和反馈信息。 除了e-mail字段为可选，其他两个字段都是必填项。 注意，这里我们使用method=”post”而非method=”get”，因为这个表单会有一个服务器端的操作：发送一封e-mail。 并且，我们复制了前一个模板search_form.html中错误信息显示的代码。

如果我们顺着上一节编写search()视图的思路，那么一个contact()视图代码应该像这样：

from django.core.mail import send_mail
from django.http import HttpResponseRedirect
from django.shortcuts import render_to_response

def contact(request):
  errors = []
  if request.method == 'POST':
    if not request.POST.get('subject', ''):
      errors.append('Enter a subject.')
    if not request.POST.get('message', ''):
      errors.append('Enter a message.')
    if request.POST.get('email') and '@' not in request.POST['email']:
      errors.append('Enter a valid e-mail address.')
    if not errors:
      send_mail(
        request.POST['subject'],
        request.POST['message'],
        request.POST.get('email', 'noreply@example.com'),
        ['siteowner@example.com'],
      )
      return HttpResponseRedirect('/contact/thanks/')
  return render_to_response('contact_form.html',
    {'errors': errors})

（如果按照书中的示例做下来，这这里可能乎产生一个疑问：contact()视图是否要放在books/views.py这个文件里。 但是contact()视图与books应用没有任何关联，那么这个视图应该可以放在别的地方？ 这毫无紧要，只要在URLconf里正确设置URL与视图之间的映射，Django会正确处理的。 笔者个人喜欢创建一个contact的文件夹，与books文件夹同级。这个文件夹中包括空的__init__.py和views.py两个文件。

现在来分析一下以上的代码：

    确认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里的各字段来填充原来的值。

# views.py

def contact(request):
  errors = []
  if request.method == 'POST':
    if not request.POST.get('subject', ''):
      errors.append('Enter a subject.')
    if not request.POST.get('message', ''):
      errors.append('Enter a message.')
    if request.POST.get('email') and '@' not in request.POST['email']:
      errors.append('Enter a valid e-mail address.')
    if not errors:
      send_mail(
        request.POST['subject'],
        request.POST['message'],
        request.POST.get('email', `'noreply@example.com`_'),
        [`'siteowner@example.com`_'],
      )
      return HttpResponseRedirect('/contact/thanks/')
  return render_to_response('contact_form.html', {
    'errors': errors,
    **'subject': request.POST.get('subject', ''),**
    **'message': request.POST.get('message', ''),**
    **'email': request.POST.get('email', ''),**
  })

# contact_form.html

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

  {% if errors %}
    <ul>
      {% for error in errors %}
      <li>{{ error }}</li>
      {% endfor %}
    </ul>
  {% endif %}

  <form action="/contact/" method="post">
    <p>Subject: <input type="text" name="subject" **value="{{ subject }}"** ></p>
    <p>Your e-mail (optional): <input type="text" name="email" **value="{{ email }}"** ></p>
    <p>Message: <textarea name="message" rows="10" cols="50">**{{ message }}**</textarea></p>
    <input type="submit" value="Submit">
  </form>
</body>
</html>

这看起来杂乱，且写的时候容易出错。 希望你开始明白使用高级库的用意——负责处理表单及相关校验任务。

在Django框架中编写Contact表单的教程

- Author -

goldensun

声明：登载此文出于传递更多信息之目的，并不意味着赞同其观点或证实其描述。

Python 相关文章推荐
python生成随机验证码(中文验证码)示例
Apr 03 Python
Python中的is和id用法分析
Jan 26 Python
python制作爬虫爬取京东商品评论教程
Dec 16 Python
浅谈Scrapy网络爬虫框架的工作原理和数据采集
Feb 07 Python
python实现字符串加密 生成唯一固定长度字符串
Mar 22 Python
tornado+celery的简单使用详解
Dec 21 Python
Python3如何在Windows和Linux上打包
Feb 25 Python
Python unittest 自动识别并执行测试用例方式
Mar 09 Python
Django使用rest_framework写出API
May 21 Python
详解pycharm2020.1.1专业版安装指南(推荐)
Aug 07 Python
通过Python pyecharts输出保存图片代码实例
Nov 25 Python
python3 通过 pybind11 使用Eigen加速代码的步骤详解
Dec 07 Python
简单解析Django框架中的表单验证
Jul 17 #Python
改进Django中的表单的简单方法
Jul 17 #Python
Python的Django框架中的表单处理示例
Jul 17 #Python
Python中max函数用法实例分析
Jul 17 #Python
详解Django中Request对象的相关用法
Jul 17 #Python
Python实现SVN的目录周期性备份实例
Jul 17 #Python
Python的Django框架中设置日期和字段可选的方法
Jul 17 #Python
说明书(38) 意向书(73) 检举信(8) 公证书(45) 协议书(568) 标语(336) 担保书(46) 委托书(259) 任命书(51) 竞聘书(31)
You might like
转PHP手册及PHP编程标准
2006/12/17 PHP
PHP stream_context_create()函数的使用示例
2015/05/12 PHP
PHP中子类重载父类的方法【parent::方法名】
2016/05/06 PHP
PHP中header函数的用法及其注意事项详解
2016/06/13 PHP
PHP实现动态创建XML文档的方法
2018/03/30 PHP
PHP 7.4 新语法之箭头函数实例详解
2019/05/09 PHP
JavaScript 原型与继承说明
2010/06/09 Javascript
js 中{},[]中括号,大括号使用详解
2011/05/12 Javascript
javascript弹出层输入框(示例代码)
2013/12/11 Javascript
js 事件截取enter按键页面提交事件示例代码
2014/03/04 Javascript
jQuery中live()方法用法实例
2015/01/19 Javascript
JQuery中extend的用法实例分析
2015/02/08 Javascript
JavaScript返回网页中锚点数目的方法
2015/04/03 Javascript
jQuery实现垂直半透明手风琴特效代码分享
2015/08/21 Javascript
win7下安装配置node.js+express开发环境
2015/12/06 Javascript
利用Vue-draggable组件实现Vue项目中表格内容的拖拽排序
2019/06/07 Javascript
Node 模块原理与用法详解
2020/05/13 Javascript
JS+Canvas实现五子棋游戏
2020/08/26 Javascript
python 截取 取出一部分的字符串方法
2017/03/01 Python
django文档学习之applications使用详解
2018/01/29 Python
如何使用VSCode愉快的写Python于调试配置步骤
2018/04/06 Python
将 Ubuntu 16 和 18 上的 python 升级到最新 python3.8 的方法教程
2020/03/11 Python
Django更新models数据库结构步骤
2020/04/01 Python
Python操作word文档插入图片和表格的实例演示
2020/10/25 Python
用纯css3和html制作泡沫对话框实现代码
2013/03/21 HTML / CSS
HTML5在canvas中绘制复杂形状附效果截图
2014/06/23 HTML / CSS
美国狗旅行和户外用品领先供应商：kurgo
2020/08/18 全球购物
艺术爱好者的自我评价分享
2013/10/08 职场文书
数学专业毕业生自荐信
2013/11/10 职场文书
会计系个人求职信范文分享
2013/12/20 职场文书
八年级生物教学反思
2014/01/22 职场文书
推广普通话标语
2014/06/27 职场文书
初级党校心得体会
2014/09/11 职场文书
团组织推荐意见
2015/06/05 职场文书
100句人生哲理语录集锦：强者征服今天，懒汉坐等明天
2019/10/18 职场文书
教你怎么用Python实现多路径迷宫
2021/04/29 Python