Django 1.6 最佳实践: 如何正确使用 CBVs (Class-based views)

在我们的博客中, 记录了我们在开发过程中所使用的技术和遇到的问题, 希望作为其他开发和设计者的一个学习交流平台.

Django 1.6 最佳实践: 如何正确使用 CBVs (Class-based views)


Class-based views是Django为解决建站过程中的常见的呈现模式而建立的. 在这节中, 我们着重讲一下CBVs的使用技巧和一般原则.

1. CBVs的使用原则

  • 代码越少越好
  • 永远不要重复代码
  • View应当只包含呈现逻辑, 不应包括业务逻辑
  • 保持view逻辑清晰简单
  • 不要将CBVs用作403, 404, 500的错误处理程序
  • 保持mixin简单明了

2. 如何使用mixin

在编程中mixin是指为继承它的class提供额外的功能, 但它自身却不能单独使用的类. 在具有多继承能力的编程语言中, mixin可以为类增加额外功能或方法. 在Django中, 我们可以使用mixin为CBVs提供更多的扩展性, 当然在类继承过程中, 我们推荐以下原则:

  • Django自身提供的View永远在最右边
  • mixin依次在以上view的左边
  • mixin永远继承自Python的object类型

在这里顺便推荐一个很好的django库: django-braces. 该库中提供众多django的mixin, 可以方便我们日常使用.

以下是一个简单地例子, TemplateView是django自身提供的基本View, 因此在最右边; FreshFruitMixin则在TemplateView左边; FreshFruitmixin继承自object:

    from django.views.generic import TemplateView

    class FreshFruitMixin(object):

        def get_context_data(self, **kwargs):
            context = super(FreshFruitMixin, self).get_context_data(**kwargs)
            context["has_fresh_fruit"] = True
            return context

    class FruitFlavorView(FreshFruitMixin, TemplateView):
        template_name = "fruit_flavor.html"

3. 如何使用Django自身的CBV

CBVs在功能上的可扩展性, 牺牲的是简单性, 一个CBV最多的时候拥有8个import关系. (如果希望进一步了解这些继承关系, 可以使用Classy Class-Based Views进行查看.) 所以要弄懂那个View最适合当下的场景对于开发人员也是一个挑战. 为了减少CBVs的使用难度, 我们将这些View和基本的用法列在下表中, 为了显示方便, 名字前的django.views.generic前缀皆省去:

名字目的例子
View 基本View, 可以在任何时候使用 见后面详细介绍
RedirectView 重新定向到其他URL 将访问"/log-in/"的用户重新定向到"/login/"
TemplateView 显示Django HTML template 一般网站中使用模板显示的页
ListView 显示对象列表 文章列表页
DetailView 显示对象详情 文章详细页
FormView 提交From 网站联系我们或emai订阅form
CreateView 创建对象 创建新文章页
UpdateView 更新对象 修改文章页
DeleteView 删除对象 删除文章页
Generic date views 显示一段时间内的对象 按时间归类的博客

4. CBVs的使用技巧

a. 限定访问权限

在django tutorial中介绍了如何一起使用django.contrib.auth.decorators.login_required和CBV, 这是一个典型的错误例子.

还好, 我们有django-braces. 在django-braces中已经提供了一个LoginRequiredMixin:

    # myapp/views.py
    from django.views.generic import DetailView

    from braces.views import LoginRequiredMixin

    from .models import Article

    class ArticleDetailView(LoginRequiredMixin, DetailView):
        model = Article

b. 在form提交成功后执行代码

当需要在form提交成功后执行自定义的代码时, 可以使用form_valid()方法, form_valid()方法返回的是django.http.HttpResponseRedirect:

    # myapp/views.py
    from django.views.generic import CreateView

    from braces.views import LoginRequiredMixin

    from .models import Article

    class ArticleCreateView(LoginRequiredMixin, CreateView):
        model = Article
        fields = ('title', 'slug', 'content')

        def form_valid(self, form):
            # 自定义的代码逻辑写在这里
            return super(ArticleCreateView, self).form_valid(form)

c. 在form提交不成功后执行代码

当需要在form提交不成功后执行自定义的代码时, 可以使用form_invalid()方法, form_invalid()方法返回的也是django.http.HttpResponseRedirect:

    # myapp/views.py
    from django.views.generic import CreateView

    from braces.views import LoginRequiredMixin

    from .models import Article

    class ArticleCreateView(LoginRequiredMixin, CreateView):
        model = Article

        def form_invalid(self, form):
            # 自定义的代码逻辑写在这里
            return super(ArticleCreateView, self).form_invalid(form)

5. CBV和form如何结合使用

下面我们介绍一下常见的django form和CBV结合使用的模式, 首先我们定义一个Article model方便举例:

    # myapp/models.py
    from django.db import models
    from django.core.urlresolvers import reverse

    STATUS = {
        (0, 'zero'),
        (1, 'one'),
    }

    class Article(models.Model):
        title = model.CharField(max_length=255)
        slug = model.SlugField()
        review_num = models.IntegerField(default=0, choices=STATUS)

        def get_absolute_url(self):
            return reverse("article_detail", kwargs={"slug": self.slug})

a. Views和ModelForm

下面的例子中, 我们利用django.contrib.messages和CBVs构建一套创建, 更新和显示一篇article的view, 包括:

  • ArticleCreateView: 用于创建新article
  • ArticleUpdateView: 用于更新article
  • ArticleDetailView: 用于确认创建或更新后的article
    # myapp/views.py
    from django.contrib import messages
    from django.views.generic import CreateView, UpdateView, DetailView

    from braces.views import LoginRequiredMixin

    from .models import Article

    class ArticleActionMixin(object):
        @property
        def success_msg(self):
            return NotImplemented

        def form_valid(self, form):
            messages.info(self.request, self.success_msg)
            return super(ArticleActionMixin, self).form_valid(form)

    class ArticleCreateView(LoginRequiredMixin, ArticleActionMixin, CreateView):
        model = Article
        fields = ('title', 'slug', 'review_num')
        success_msg = "Article Created!"

    class ArticleUpdateView(LoginRequiredMixin, ArticleActionMixin, UpdateView):
        model = Article
        fields = ('title', 'slug', 'review_num')
        success_msg = "Article Updated!"

    class ArticleDetailView(DetailView):
        model = Article

接下来是template

    {# templates/myapp/article_detail.html #}
    {% if messages %}
    <ul class="messages">
        {% for message in messages %}
        <li>{ message } </li>
    </ul>
    {% endif %}

b. Views和Form

下面我们以搜索article功能为例子, 介绍一下CBV和form的常见使用样式, 在article列表页中点击搜索按钮, 显示搜友符合条件的article列表:

    # myapp/views.py
    from django.views.generic import ListView
    
    from .models import Article
    
    class ArticleListView(ListView):
        model = Article
        
        def get_queryset(self):
            queryset = super(ArticleListView, self).get_queryset()
            
            q = self.request.GET.get('q')
            
            if q:
                return queryset.filter(title__icontains=q)
                
            return queryset

然后可以使用include以下tenplate呈现搜索form:

    {# templates/myapp/_article_search.html #}
    <form action="{% url "article_list" %} method="GET"">
        <input type="text" name="q"></>
        <button type="submit">搜索</>
    </form>

6. 单独使用View

只用django.views.generic.View, 而不用FBV来构建所有django项目中的view也是可行的, 这也没有你所想象的那么复杂. 使用View的好处是, 我们不需要写许多内套式的if语句, 我们可以直接覆盖使用View的get(), post()等方法:

    from django.shortcuts import get_object_or_404, render, redirect
    from django.views.generic import View
    
    from braces.views import LoginRequiredMixin
    
    from .forms import ArticleForm
    from .models import Article
    
    class ArticleView(LoginRequiredMixin, View):
        
        def get(self, request, *args, **kwargs):
            article = get_object_or_404(Article, pl=kwargs['slug'])
            return render(request, 
                "myapp/article_detail.html",
                {"article": article}
            )
            
        def post(sele, request, *args, **kwargs):
            article = get_object_or_404(Article, pl=kwargs['slug'])
            form = ArticleForm(request.POST)
            if form.is_valid():
                form.save()
            return redirect("myapp:article", article.slug)

原文链接: http://www.weiguda.com/blog/11/