django 入门:通用视图类重构视图

2020-12-15 16:05:03 浏览数 (1)

作者:Kuky_xs

博客:https://www.jianshu.com/p/8cdf099e974f

1

正文

《django入门:环境及项目搭建》

《django入门:数据模型》

《django入门:视图及模版》

《django入门:Admin管理系统及表单》

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

2

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

1.创建视图类

代码语言:javascript复制
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

代码语言:javascript复制
urlpatterns = [
 # url(r'^home/$', views.home, name='home'),
 url(r'^home/$', views.HomeView.as_view(), name='home'),
 # url(r'cate/(?P<pk>[0-9] )/$', views.category, name='cate'),
 url(r'cate/(?P<pk>[0-9] )/$', views.CategoryView.as_view(), name='cate'),
 # url(r'post/(?P<pk>[0-9] )/$', views.post_detail, name='post'),
 url(r'post/(?P<pk>[0-9] )/$', views.PostDetailView.as_view(), name='post'),
]

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

列表界面

详情界面

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

3

通过 ListView 创建分页

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

代码语言:javascript复制
class PostListView(ListView):
    model = Post
    template_name = 'blog/home.html'
    context_objects_name = 'post_list'
    # 指定分页,每页数量为 1
    paginate_by = 1

2.在模版中加入分页

代码语言:javascript复制
{# ...... #}
{% if is_paginated %}
 <div class="pagination-simple">
     {% if page_obj.has_previous %}
         <a href="?page={{ page_obj.previous_page_number }}">Previous</a>
     {% endif %}
         <span class="current">
                 Page {{ post_list.number }} of {{ post_list.paginator.num_pages }}
         </span>
        {% if page_obj.has_next %}
         <a href="?page={{ page_obj.next_page_number }}">Next</a>
        {% endif %}
 </div>
{# ...... #}

4

通过 Paginator 创建分页

1.创建相应的视图

代码语言:javascript复制
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.通过模版进行渲染

代码语言:javascript复制
{% for post in post_list %}
    {{ post.title }}<br />
    ...
{% endfor %}

<div class="pagination">
    <span class="step-links">
        {% if post_list.has_previous %}
            <a href="?page={{ post_list.previous_page_number }}">previous</a>
        {% endif %}
        
        <span class="current">
            Page {{ post_list.number }} of {{ post_list.paginator.num_pages }}
        </span>

        {% if post_list.has_next %}
            <a href="?page={{ post_list.next_page_number }}">next</a>
        {% endif %}
    </span>
</div>

最后做了分页的效果界面

带分页列表

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

优化分页列表

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

代码语言:javascript复制
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 页的列表 <Page 2 of 7>
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

最后附上整个项目的地址:blog_project

https://github.com/kukyxs/blog_project

0 人点赞