表单Form对象的使用及如何构建复杂的QuerySet

本篇文章为大家展示了表单Form对象的使用及如何构建复杂的QuerySet，内容简明扼要并且容易理解，绝对能使你眼前一亮，通过这篇文章的详细介绍希望你能有所收获。

员工经过长期磨合与沉淀，具备了协作精神，得以通过团队的力量开发出优质的产品。创新互联坚持“专注、创新、易用”的产品理念，因为“专注所以专业、创新互联网站所以易用所以简单”。公司专注于为企业提供成都网站设计、成都网站建设、微信公众号开发、电商网站开发，小程序设计，软件按需定制网站等一站式互联网企业服务。

一、利用Django创建表单

Django包含两个基类可构建表单，如下所示：

1. Form可构建标准的表单

2. ModelForm可构建与模型实例相关联的表单

1. 标准表单Form

首先在应用程序目录中创建 forms.py 文件，代码如下：

from django import forms

class EmailPostForm(forms.Form):
    name = forms.CharField(max_length=25)
    email = forms.EmailField()
    to = forms.EmailField()
    comments = forms.CharField(required=False, widget=forms.Textarea)

• CharField 该字段类型显示为

• widget 为字段所使用的插件，在 comments 字段中使用了 Textarea 插件

• EmailField 需要使用有效的电子邮件地址；否则，字段验证将抛出 forms.ValidationError 异常

• required 表示该字段是否必填项

有效的表单字段列表请参照：点击此处

接下来在 views.py 中使用 Form表单对象

from .forms import EmailPostForm

def post_share(request, post_id):
    post = get_object_or_404(Post, id=post_id, status='published')
    if request.method == 'POST':
        form = EmailPostForm(request.POST)
        if form.is_valid():
            cd = form.cleaned_data
            # ...
    else:
        form = EmailPostForm()
    return render(request, 'blog/post/share.html', {'post': post, 'form': form})

上述视图工作方式如下：

• 定义了 post_share 视图，并接收 request 对象和 post_id 变量作为参数

• 采用 get_object_or_404 快捷方式，并通过 ID 检索帖子，以确保检索的状态为 published

• 根据 request.method == 'POST' 方法区分 POST 请求还是 GET 请求

表单处理流程如下：

1. 当视图为 GET请求时，创建一个新的 form 实例，并用于显示模板中的空表单： form = EmailPostForm()

2. 当为 POST请求时，通过包含于 request.POST 中的提交数据生成一个表单实例：form = EmailPostForm(request.POST)

3. 利用表单 is_valid() 方法验证所提交的数据。如果作一字段包含了无效数据，将返回 False。通过访问 form.errors 可查看验证错误列表

4. 若表单正确，通过访问 form.cleaned_data 将对验证后的数据进行检索。该属性表示为表单字段及其对应值的字典。

最后在HTML模板中使用 Form 对象：

{% extends "blog/base.html" %}

{% block title %}Share a post{% endblock %}

{% block content %}
    {% if sent %}
        
E-mail successfully sent
        

            "{{ post.title }}" was successfully sent to {{ form.cleaned_data.to }}.
        
    {% else %}
        
Share "{{ post.title }}" by e-mail
        
            {{ form.as_p }}
            {% csrf_token %}
            
        
    {% endif %}
{% endblock %}

此处通知Django利用 as_p 方法将字段显示为

中的字段。除此之外，还可利用 as_ul 作为无序列表显示表单；或者利用 as_table 作为表予以显示。如果需要显示每个字段，可遍历相关字段，如下所示：

{% for field in form%}

 {{ field.errors }}
 {{ field.label_tag }} {{ field }}

{% endfor %}

2. 模型表单ModelForm

首先创建用于评论帖子的模型：

class Comment(models.Model):
    post = models.ForeignKey(Post, on_delete=models.CASCADE, related_name='comments')
    name = models.CharField(max_length=80)
    email = models.EmailField()
    body = models.TextField()
    created = models.DateTimeField(auto_now_add=True)
    updated = models.DateTimeField(auto_now=True)
    active = models.BooleanField(default=True)

    class Meta:
        ordering = ('created',)

    def __str__(self):
        return 'Comment by {} on {}'.format(self.name, self.post)

• ForeignKey 以外键关联帖子

• related_name 可对对应关系表进行跨表查询。定义完毕后，可通过 comment.post 检索评论对象的帖子，也可采用 post.comments.all() 检索某个帖子的全部评论；如果没有定义该值，Django将使用 模型名称_set (如 comment_set )这一形式命名相关的对象管理器

关于多对一关系，可点击此处了解更多内容

接着创建模型中的表单，编辑 应用程序 目录下的 forms.py 文件，添加如下代码：

from .models import Comment

class CommentForm(forms.ModelForm):
    class Meta:
        model = Comment
        fields = ('name', 'email', 'body')

• model 指定使用哪一个模型创建表单

• fields 显式地通知当前框架希望在表单中包含哪些字段；或者采用 exclude 定义希望排除的字段。

然后在视图View中使用ModelForms，修改 views.py 文件的 post_detail() 方法如下：

from .models import Post, Comment
from .forms import EmailPostForm, CommentForm

def post_detail(request, year, month, day, post):
    post = get_object_or_404(Post, slug=post, status='published', publish__year=year, publish__month=month,
                             publish__day=day)

    # 通过post对象查找关联的comment对象
    comments = post.comments.filter(active=True)
    new_comment = None

    if request.method == 'POST':
        comment_form = CommentForm(data=request.POST)
        if comment_form.is_valid():
            new_comment = comment_form.save(commit=False)
            new_comment.post = post
            new_comment.save()
    else:
        comment_form = CommentForm()

    return render(request, 'blog/post/detail.html',
                  {'post': post, 'comments': comments, 'new_comment': new_comment, 'comment_form': comment_form})

• comments = post.comments.filter(active=True) 使用了 post_detail 视图显示帖子及其评论内容，并针对该帖子加入了QuerySet以过滤检索评论

• new_comment = comment_form.save(commit=False) 创建表单所链接的模型实例。如果采用 commit=False 则会创建模型实例，但不会将其保存至数据库中

• new_comment.post = post 修改ModelForms的属性值

• new_comment.save() 保存至数据库中

最后在HTML模板中显示：

    
    {% with comments.count as total_comments %}
        

            {{ total_comments }} comment{{ total_comments|pluralize }}
        
    {% endwith %}

    
    {% for comment in comments %}
        
            
                Comment {{ forloop.counter }} by {{ comment.name }}
                {{ comment.created }}
            

            {{ comment.body|linebreaks }}