django 入门笔记：通用视图类重构视图

django 及 rest_framework 笔记链接如下：
django 入门笔记：环境及项目搭建
django 入门笔记：数据模型
django 入门笔记：视图及模版
django 入门笔记：Admin 管理系统及表单
django 入门笔记：通用视图类重构视图
django_rest_framework 入门笔记：Serializer
django_rest_framework 入门笔记：视图函数重构
django_rest_framework 入门笔记：分页，多条件筛选及权限认证设置
django 自带 user 字段扩展及头像上传

终于到最后一部分了，这部分我们将通过 django 自带的通用视图类替换之前写的视图函数，对视图进行重构

利用 django 通用视图类创建类视图

1. 创建视图类

   import markdown
   from django.shortcuts import render
   from django.views.generic import ListView, DetailView
   from django.shortcuts import get_object_or_404
   from blog.models import Post
   
   # 获取相应模型下的全部数据
   def home(request):
       post_list = Post.objects.all()
       return render(request, 'blog/home.html', locals())
   
   # 通过 ListView 类来进行修改
   class HomeView(ListView):
       model = Post # 指定视图模型
       template_name = 'blog/home.html' # 指定渲染的模版
       context_objects_name = 'post_list' # 对应的模型列表数据保存的变量名
   
   # #################################################################################
   # 获取特定条件下的模型数据 
   def category(request, pk):
       category = get_object_or_404(Category, pk=pk)
       post_list = Post.objects.filter(category=category)
       return render(request, 'blog/home.html', locals())
   
   # 通过 ListView 类进行修改
   # 基本属性同 HomeView 相同，也可以直接继承 HomeView 然后复写 get_queryset() 方法实现
   class CategoryView(ListView):
       model = Post
       template_name = 'blog/home.html'
       context_objects_name = 'post_list'
       
       # 该方法默认返回指定模型的全部数据，通过复写该方法，改变默认行为
       def get_queryset(self):
           # 类视图中，从 url 捕获的命名组参数值保存在实例的 kwargs 中，是一个字典
           # 非命名组参数值保存在实例的 args 中，是一个列表
           category = get_object_or_404(Category, pk=kwargs.get('pk'))
           return super(CategoryView, self).get_queryset().filter(category=category)
   
   # #################################################################################
   # 获取具体的详情
   def post_detail(request, pk):
       post = get_object_or_404(Post, pk=pk)
       post.increase_views()
       post.body = markdown.markdown(post.body, extensions=[
           'markdown.extensions.extra',
           'markdown.extensions.codehilite',
       ])
       form = CommentForm()
       return render(request, 'blog/detail.html', locals())
   
   class PostDetailView(DetailView):
       model = Post
       template_name = 'blog/detail.html'
       context_objects_name = 'post'
       
       # 方法返回一个 HttpResponse 实例
       def get(self, request, *args, **kwargs):
           # get 方法会通过调用 get_object 和 get_context——data 方法对模版渲染
           # def get(self, request, *args, **kwargs):
            # self.object = self.get_object()
            # context = self.get_context_data(object=self.object)
            # return self.render_to_response(context)
           response = super(PostDetailView, self).get(request, *args, **kwargs)
           # 只有当 get 方法被调用后才有 self.object 属性，即 post 实例
           # 对应 post_detail 函数中的 post.increase_views()
           self.object.increase_views()
           return response
       
       # 根据 post 的 pk 值获取相应的 post 实例
       def get_object(self, queryset=None):
           post = super(PostDetailView, self).get_object(queryset=None)
           post.body = markdown.markdown(post.body, extensions=[
            'markdown.extensions.extra',
            'markdown.extensions.codehilite',
        ])
           return post
       
       # 返回一个字典，为模版变量字典，传递给相应的模版
       def get_context(self, **kwargs):
           context = super(PostDetailView, self).get_context(**kwargs)
           form = CommentForm()
           # 更新 context 的内容，必须调用
           context.update(locals())
           return context
   

2. 绑定 url

   urlpatterns = [
    # url(r'^home/$', views.home, name='home'),
    url(r'^home/$', views.HomeView.as_view(), name='home'),
    # url(r'cate/(?P[0-9]+)/$', views.category, name='cate'),
    url(r'cate/(?P[0-9]+)/$', views.CategoryView.as_view(), name='cate'),
    # url(r'post/(?P[0-9]+)/$', views.post_detail, name='post'),
    url(r'post/(?P[0-9]+)/$', views.PostDetailView.as_view(), name='post'),
   ]
   

修改完后的界面应该和之前的效果是一样的

列表界面.png

详情界面

有时候如果我们的数据过多，同一页加载全部数据，用户的体验肯定不好，我们通过通用视图类来创建分页，这边为了方便显示，我们会设置每页加载一篇文章

通过 ListView 创建分页

1. 指定 ListView 中的 paginate_by 属性来设置分页

   class PostListView(ListView):
       model = Post
       template_name = 'blog/home.html'
       context_objects_name = 'post_list'
       # 指定分页，每页数量为 1
       paginate_by = 1
   

2. 在模版中加入分页

   {# ...... #}
   {% if is_paginated %}
    
   
        {% if page_obj.has_previous %}
            Previous
        {% endif %}
            
                    Page {{ post_list.number }} of {{ post_list.paginator.num_pages }}
            
           {% if page_obj.has_next %}
            Next
           {% endif %}
    
   {# ...... #}
   

通过 Paginator 创建分页

1. 创建相应的视图

   def home(request):
       limit = 10
       posts = Post.object.all()
       paginator = Paginator(posts, limit)
       
       # 根据表单获取页码
       page = request.GET.get('page')
       try:
           post_list = paginator.page(page) # 获取 num 页码下的列表
       except PageNotAnInteger:
           post_list = paginator.page(1) # 如果 page 不是整数则返回第一页列表
    except EmptyPage:
           post_list = paginator.page(paginator.num_pages) # 如果没有数据则返回最后一页列表
    
       return render(request, 'blog/home.html', locals())
   

2. 通过模版进行渲染

   {% for post in post_list %}
       {{ post.title }}
   
       ...
   {% endfor %}
   
   
       
           {% if post_list.has_previous %}
               previous
           {% endif %}
           
           
               Page {{ post_list.number }} of {{ post_list.paginator.num_pages }}
           
   
           {% if post_list.has_next %}
               next
           {% endif %}
       
   
   

最后做了分页的效果界面

带分页列表

目前的分页效果看上去并不那么美观，在实际项目中，我们优化了分页的显示，具体的代码就不贴了(我怕代码太多你们会打我)，可以下载项目查看，这边我们可以看下效果图

优化分页列表

最后我们列下 Paginator 常用属性结束 django 的入门教程，接下来会有 DRF 的入门教程，django 算是其基础吧，DRF 实现了前后端分离，刚好适合我这种 Android 开发需要接口的。

from django.core.paginator import Paginator
item_list = ['a', 'b', 'c', 'd', 'e', 'f', 'g', 'h', 'i', 'j', 'k', 'l', 'm', 'n']
# 指定 paginator 的列表以及每页显示的列表数量
p = Paginator(item_list, 2)
print(p.count) # 返回列表的总数    14
print(p.num_pages) # 返回总页数    7
print(p.page_range) # 返回页数的范围   (1, 8)
print(p.per_page) # 返回每页列表的数量
print(p.object_list) # 返回所有的列表 item
# 通过 page(num) 方法获取 num 页的列表 
page2 = p.page(2)
print(page2.number) # 获取当前页的页码
print(page2.object_list) # 获取该页码下的所有列表    ['c', 'd']
print(page2.has_next()) # 是否有下页    True
print(page2.has_previous()) # 是否有上页    True
print(page2.has_other_pages()) # 是否有其他页    True
# 如果没有上/下一页则返回 EmptyPage 错误 EmptyPage: That page contains no results
print(page2.next_page_number()) # 获取下一页的页码    3
print(page2.previous_page_number()) # 获取上一页的页码    1
print(page2.start_index()) # 当前页第一个 item 在列表中的位置    3
print(page2.end_index()) # 当前页最后一个 item 在列表中的位置    4