设计个人站点页面（跨表查询、分组查询）

一、个人站点页面的文章查询

1、路由配置个人站点url

urls.py:

urlpatterns = [
    ...
    # 个人站点url
    # 正则规则：w：匹配数字、字母、下划线   W：匹配除数字、字母、下划线以外的任意字符
    # '(?P<name>...)' 分组匹配  {"username": alex}
    re_path('^(?P<username>w+)$', views.home_site),
]

2、构建home_site视图函数及文章查询

def home_site(request, username):
    """
    个人站点视图函数
    :param request:
    :param username:  yuan / alex
    :return:
    """
    print("username", username)
    # 去数据库查找该用户是否存在
    # ret = UserInfo.objects.filter(username= username).exists()

    # 拿到当前用户对象
    user = UserInfo.objects.filter(username= username).first()

    # 判断用户是否存在
    if not user:
        # 用户不存在返回404页面
        return render(request, "not_found.html")

    # 查询当前站点对象
    blog = user.blog

    # 查看当前用户或当前站点所对应的所有文章
    # 方法1：基于对象查询
    # article_list = user.article_set.all()
    # 方法2：基于双下划线查询
    article_list = models.Article.objects.filter(user=user)

    return render(request, "home_site.html")

注意：

（1）访问个人网站需要去数据库查看该用户是否存在，如果用户不存在返回404页面。

# 去数据库查找该用户是否存在
ret = UserInfo.objects.filter(username= username).exists()

# 判断用户是否存在
if not ret:
    # 用户不存在返回404页面
    return render(request, "not_found.html")

（2）查看当前站点对象

（3）查看当前用户或当前站点所对应的所有文章

# 查看当前用户或当前站点所对应的所有文章
# 方法1：基于对象查询
# article_list = user.article_set.all()
# 方法2：基于双下划线查询
article_list = models.Article.objects.filter(user=user)

二、个人站点页面标签和分类查询

# 每一个后的表模型.objects.values("pk").annotate(聚合函数(关联表__统计字段)).values()
# 查询每一个分类名称及对应的文章数(最简单的分组查询)
ret = models.Category.objects.values("pk").annotate(c=Count("article__title")).values("title", "c")
print(ret)   # <QuerySet [{'title': 'yuan的鸡汤', 'c': 1}, {'title': 'Dubbo', 'c': 1}, {'title': '前端', 'c': 1}]>

# 查询当前站点的每一个分类名称以及对应的文章数
cate_list = models.Category.objects.filter(blog=blog).values("pk").annotate(c=Count("article__title")).values_list("title", "c")
print(cate_list)  # <QuerySet [{'title': 'yuan的鸡汤', 'c': 1}, {'title': 'Dubbo', 'c': 1}]>

# 查询当前站点的每一个标签名称及对应的文章数
tag_list = models.Tag.objects.filter(blog=blog).values("pk").annotate(c=Count("article")).values_list("title", "c")
print(tag_list)

三、日期归档查询方式一

　　这是一个单表分组查询。按照日期进行分组。但是create_time字段是包含时分秒的，因此不能使用它分组。

# 查询当前站点每一个年月的名称及对应的文章数
date_list = models.Article.objects.filter(user=user).extra(select={"y_m_date": "date_format(create_time, '%%Y-%%m')"}).values("y_m_date").annotate(c=Count("nid")).values("y_m_date", "c")
print(date_list)   # <QuerySet [{'y_m_date': '2018-08', 'c': 2}]>

1、date_format函数

　　注意date imedatetime三种事件类型的区别

　　创建表并插入当前时间：

create table t_mul_new(d date,t time,dt datetime);

insert into t_mul_new values(now(),now(),now());

　　利用date_form函数用于以不同的格式显示日期/时间数据

mysql> select * from t_mul_new;
+------------+----------+---------------------+
| d          | t        | dt                  |
+------------+----------+---------------------+
| 2018-08-02 | 14:58:57 | 2018-08-02 14:58:57 |
+------------+----------+---------------------+
1 row in set (0.00 sec)

mysql> select date_format(dt,"%Y/%m/%d") from t_mul_new;
+----------------------------+
| date_format(dt,"%Y/%m/%d") |
+----------------------------+
| 2018/08/02                 |
+----------------------------+
1 row in set (0.00 sec)

　　语法和参数如下所示：

语法：
DATE_FORMAT(date,format)
    date 参数是合法的日期。format 规定日期/时间的输出格式。

常用格式：
%a	缩写星期名
%b	缩写月名
%c	月，数值
%D	带有英文前缀的月中的天
%d	月的天，数值(00-31)
%e	月的天，数值(0-31)
%H	小时 (00-23)
%h	小时 (01-12)
%I	小时 (01-12)
%i	分钟，数值(00-59)
%j	年的天 (001-366)
%M	月名
%m	月，数值(00-12)
%p	AM 或 PM
%r	时间，12-小时（hh:mm:ss AM 或 PM）
%S	秒(00-59)
%s	秒(00-59)
%T	时间, 24-小时 (hh:mm:ss)

2、extra函数

语法：

extra(select=None, where=None, params=None, tables=None, order_by=None, select_params=None)

　　有些情况下，Django的查询语法难以简单的表达复杂的 WHERE 子句，对于这种情况, Django 提供了 extra() QuerySet修改机制 — 它能在 QuerySet生成的SQL从句中注入新子句。

　　extra可以指定一个或多个参数,例如 select, where or tables. 这些参数都不是必须的，但是你至少要使用一个!要注意这些额外的方式对不同的数据库引擎可能存在移植性问题.(因为你在显式的书写SQL语句),除非万不得已,尽量避免这样做。

select参数：

　　The select 参数可以让你在 SELECT从句中添加其他字段信息，它应该是一个字典，存放着属性名到 SQL 从句的映射。

queryResult=models.Article.objects.extra(select={'is_recent': "create_time > '2017-09-05'"})

　　结果集中每个 Entry 对象都有一个额外的属性is_recent, 它是一个布尔值，表示 Article对象的create_time 是否晚于2017-09-05.

　　如果要进一步过滤结果，拿到匹配元素的名称和是否最近的结果：

ret = models.Article.objects.extra(select={"is_recent": "create_time > '2017-09-05'"}).values("title", "is_recent")
print(ret) # <QuerySet [{'is_recent': 1, 'title': '追求优秀，才是合格的程序员'}, {'is_recent': 1, 'title': 'Dubbo负载均衡与集群容错机制'}, {'is_recent': 1, 'title': 'vue相关'}]>

利用extra查看对应所有文章，并得到年-月-日形式发布时间：

ret = models.Article.objects.extra(select={"y_m_d_date": "date_format(create_time, '%%Y-%%m-%%d')"}).values("title", "y_m_d_date")
print(ret)  # <QuerySet [{'y_m_d_date': '2018-08-01', 'title': '追求优秀，才是合格的程序员'}, {'y_m_d_date': '2018-08-01', 'title': 'Dubbo负载均衡与集群容错机制'}, {'y_m_d_date': '2018-08-01', 'title': 'vue相关'}]>

3、再加入filter(user=user)过滤出当前站点用户，并使用.annotate(c=Count("nid"))分组

date_list = models.Article.objects.filter(user= user).extra(select={"y_m_date": "date_format(create_time, '%%Y-%%m')"}).values("y_m_date").annotate(c=Count("nid")).values("y_m_date", "c")
print(date_list)   # <QuerySet [{'y_m_date': '2018-08', 'c': 2}]>

　　如此就得到了当前站点每一个年月的文章数。但是这个数据传入模板中，调用不了，因为它并不是字典。

# 改用values_list，得到字典
date_list = models.Article.objects.filter(user=user).extra(
    select={"y_m_date": "date_format(create_time, '%%Y-%%m')"}).values("y_m_date").annotate(c=Count("nid")).values_list(
    "y_m_date", "c")
print(date_list)  # <QuerySet [('2018-08', 2)]>

四、日期归档查询方式二

　　应用django提供的接口来快速处理日期归档查询，这里引入的是TruncMonth，比较常用的还有TruncDay等。

from django.db.models.functions import TruncMonth
ret = models.Article.objects.filter(user=user).annotate(month=TruncMonth("create_time")).values("month").annotate(c=Count("nid")).values_list("month", "c")
print("ret---->", ret)   # ret----> <QuerySet [(datetime.datetime(2018, 8, 1, 0, 0), 2)]>

1、TruncMonth模块及使用方式

from django.db.models.functions import TruncMonth
       
Sales.objects
	.annotate(month=TruncMonth('timestamp'))  # Truncate to month and add to select list
	.values('month')                          # Group By month
	.annotate(c=Count('id'))                  # Select the count of the grouping
	.values('month', 'c')                     # (might be redundant, haven't tested) select month and count    

注意：

（1）.annotate(month=TruncMonth('timestamp'))并没有做分组，是把日期截断到年月为止，并赋值给month的字段；

（2）.values('month') 是利用刚刚截断出来的month字段来进行分组；

（3）.annotate(c=Count('id')) 统计id的数量；

（4）.values('month', 'c') 显示month和统计出来的c值。

2、django中的时区设置TIME_ZONE,USE_TZ

　　运行代码发现报错：Database returned an invalid datetime value. Are time zone definitions for your database installed?

　　检查发现是settings.py中改写过TIME_ZONE = "Asia/Shanghai"后，需要将USE_TZ=True改为USE_TZ=False。　

　　Django如果开启了Time Zone功能，则所有的存储和内部处理，甚至包括直接print显示全都是UTC的。只有通过模板进行表单输入/渲染输出的时候，才会执行UTC本地时间的转换。建议后台处理时间的时候，最好完全使用UTC，不要考虑本地时间的存在。而显示时间的时候，也避免手动转换，尽量使用Django模板系统代劳。

　　启用 USE_TZ = True 后，处理时间方面，有两条 “黄金法则”：

1、保证存储到数据库中的是 UTC 时间；
2、在函数之间传递时间参数时，确保时间已经转换成 UTC 时间；

# 通常获取当前时间用的是：
import datetime
now = datetime.datetime.now()

# 启用 USE_TZ = True 后，需要写成：
import datetime 
from django.utils.timezone import utc
utcnow = datetime.datetime.utcnow().replace(tzinfo=utc)

　　除非应用支持用户设置自己所在的时区，通常我们不需要关心模板的时区问题。模板在展示时间的时候，会使用 settings.TIME_ZONE 中的设置自动把 UTC 时间转成 settings.TIME_ZONE 所在时区的时间渲染。

TIME_ZONE = 'Asia/Shanghai'　　

五、个人站点页面渲染布局

1、将数据传入模板home_site.html中：

def home_site(request, username):
    ...
    return render(request, "home_site.html", {"blog": blog, "article_list": article_list, "cate_list": cate_list, "date_list": date_list})

2、home_site.html页面布局及数据获取代码如下：

<!DOCTYPE html>
<html lang="en">
<head>
    <meta charset="UTF-8">
    <title>Title</title>
    <!-- 引入 Bootstrap 核心 CSS 文件 -->
    <link rel="stylesheet" href="/static/blog/bootstrap-3.3.7/css/bootstrap.css">
    <!-- jQuery (Bootstrap 的所有 JavaScript 插件都依赖 jQuery，所以必须放在前边) -->
    <script src="/static/js/jquery-3.3.1.js"></script>
    <!-- 引入 Bootstrap 核心 JavaScript 文件 -->
    <script src="/static/blog/bootstrap-3.3.7/js/bootstrap.js"></script> <!--依赖jquery-->
    <style>
        * {
            margin: 0;
            padding: 0;
        }

        .header {
             100%;
            height: 60px;
            background-color: #369;
        }

        .header .title {
            font-size: 18px; /* 字体大小 */
            font-weight: 100; /* 字体粗细 */
            line-height: 60px; /* 行高与页头一致，完成居中 */
            color: white;
            margin-left: 15px;
            margin-top: -10px;
        }

        .backend {
            float: right; /* 浮动到右边 */
            color: white;
            text-decoration: none; /* 去除下划线 */
            font-size: 16px;
            margin-right: 12px;
            margin-top: 10px;
        }
        .pub_info {
            margin-top: 10px;
            color: darkgray;
        }
    </style>
</head>
<body>

<div class="header">
    <div class="content">
        <!--站点标题-->
        <p class="title">
            <span>{{ blog.title }}</span>
            <a href="" class="backend">管理</a>
        </p>
    </div>
</div>

<div class="container">
    <div class="row">
        <div class="col-md-3">
            <!--添加bootstrap面板-->
            <div class="panel panel-warning">
                <div class="panel-heading">我的标签</div>
                <div class="panel-body">
                    {% for tag in tag_list %}
                        <p>{{ tag.0 }}({{ tag.1 }})</p>
                    {% endfor %}
                </div>
            </div>
            <div class="panel panel-danger">
                <div class="panel-heading">随笔分类</div>
                <div class="panel-body">
                    {% for cate in cate_list %}
                        <p>{{ cate.0 }}({{ cate.1 }})</p>
                    {% endfor %}
                </div>
            </div>
            <div class="panel panel-success">
                <div class="panel-heading">随笔归档</div>
                <div class="panel-body">
                    {% for date in date_list %}
                        <p>{{ date.0 }}({{ date.1 }})</p>
                    {% endfor %}
                </div>
            </div>
        </div>
        <div class="col-md-9">
            <div class="article_list">
                <div class="article_list">
                    {% for article in article_list %}
                        <div class="article-item clearfix">
                            <h5><a href="">{{ article.title }}</a></h5>
                            <div class="article-desc">
                                {# 文章摘要 #}
                                {{ article.desc }}
                            </div>
                            <!--文章下方详细信息-->
                            <div class="small pub_info pull-right">
                                {# 文章发布时间 #}
                                <span>发布于  {{ article.create_time|date:"Y-m-d H:i" }}</span>   
                                {# 评论数 #}
                                <span class="glyphicon glyphicon-comment"></span> 评论({{ article.comment_count }})  
                                {# 点赞数 #}
                                <span class="glyphicon glyphicon-thumbs-up"></span> 点赞({{ article.up_count }})
                            </div>
                        </div>
                        <hr>
                    {% endfor %}
                </div>
            </div>
        </div>
    </div>
</div>

</body>
</html>

注意：

（1）这里文章列表可以复用首页的文章列表代码来显示，做去除头像等微调即可。

（2）div标签添加class="clearfix"，解决标签浮动问题。

　　通过为父元素添加 .clearfix 类可以很容易地清除浮动（float）。这里所使用的是 Nicolas Gallagher 创造的 micro clearfix 方式。此类还可以作为 mixin 使用。

<div class="article-item clearfix">
    <h5><a href="">{{ article.title }}</a></h5>
    <div class="article-desc">
        {# 文章摘要 #}
        {{ article.desc }}
    </div>
    <!--文章下方详细信息-->
    <div class="small pub_info pull-right">
        {# 文章发布时间 #}
        <span>发布于  {{ article.create_time|date:"Y-m-d H:i" }}</span>   
        {# 评论数 #}
        <span class="glyphicon glyphicon-comment"></span> 评论({{ article.comment_count }})  
        {# 点赞数 #}
        <span class="glyphicon glyphicon-thumbs-up"></span> 点赞({{ article.up_count }})
    </div>
</div>

3、显示效果：

　　

六、个人站点页面跳转过滤功能

1、页面跳转路由设计

　　在点击标签、随笔分类、随笔日期归档的时候，显示对应的过滤信息。需要利用到路由跳转。

　　仿照博客园页面地址：https://www.cnblogs.com/xiugeng/category/1156842.html

urlpatterns = [
    ...
    # 个人站点url
    re_path('^(?P<username>w+)$', views.home_site),

    # 个人站点跳转   有名分组
    re_path('^(?P<username>w+)/(?P<condition>tag|category|archive)/(?P<param>.*)/$', views.home_site),
]

　　当用户访问个人站点时，传给视图函数home_site两个实参：homesite(request, username='yuan')；

　　当用户访问个人站点跳转时，传递四个参数：homesite(request, username='yuan', condition='tag', param='运维');

2、home_site视图函数改写

def home_site(request, username, **kwargs):
    """
    个人站点视图函数
    :param request:
    :param username:  yuan / alex
    :return:
    """
    # 拿到当前用户对象
    user = UserInfo.objects.filter(username=username).first()

    # 判断用户是否存在
    if not user:
        # 用户不存在返回404页面
        return render(request, "not_found.html")

    # 查询当前站点对象
    blog = user.blog

    if kwargs:
        condition = kwargs.get("condition")
        param = kwargs.get("param")  # 2012-12

        if condition=="category":
            article_list = models.Article.objects.filter(user=user).filter(category__title=param)
        elif condition=="tag":
            article_list = models.Article.objects.filter(user=user).filter(tags__title=param)
        else:
            year, month = param.split("-")
            article_list = models.Article.objects.filter(user=user).filter(create_time__year=year, create_time__month=month)
    else:
        article_list = models.Article.objects.filter(user=user)

    # 查询每一个分类名称及对应的文章数(最简单的分组查询)
    ret = models.Category.objects.values("pk").annotate(c=Count("article__title")).values("title", "c")
    print(ret)  # <QuerySet [{'title': 'yuan的鸡汤', 'c': 1}, {'title': 'Dubbo', 'c': 1}, {'title': '前端', 'c': 1}]>

    # 查询当前站点的每一个分类名称以及对应的文章数
    cate_list = models.Category.objects.filter(blog=blog).values("pk").annotate(c=Count("article__title")).values_list(
        "title", "c")
    print(cate_list)  # <QuerySet [{'title': 'yuan的鸡汤', 'c': 1}, {'title': 'Dubbo', 'c': 1}]>

    # 查询当前站点的每一个标签名称及对应的文章数
    tag_list = models.Tag.objects.filter(blog=blog).values("pk").annotate(c=Count("article")).values_list("title", "c")
    print(tag_list)

    # 改用values_list，得到字典
    date_list = models.Article.objects.filter(user=user).extra(
        select={"y_m_date": "date_format(create_time, '%%Y-%%m')"}).values("y_m_date").annotate(
        c=Count("nid")).values_list(
        "y_m_date", "c")
    print(date_list)  # <QuerySet [('2018-08', 2)]>

    return render(request, "home_site.html",
                  {"blog": blog, "article_list": article_list, "cate_list": cate_list, "tag_list": tag_list,
                   "date_list": date_list})

注意要点：

（1）给home_site()函数添加**kwargs参数。在访问个人站点跳转时，可以接收到其他参数。

（2）基于kwargs是否存在，判断是否是个人站点跳转，如果是的，拿到condition和param的值：

if kwargs:
    condition = kwargs.get("condition")
    param = kwargs.get("param")  # 2012-12

（3）由于condition的值只可能是tagcategoryarchive这三种，根据这三种情况拿到对应的文章列表

if kwargs:
    condition = kwargs.get("condition")
    param = kwargs.get("param")  # 2012-12

    if condition=="category":
        article_list = models.Article.objects.filter(user=user).filter(category__title=param)
    elif condition=="tag":
        article_list = models.Article.objects.filter(user=user).filter(tags__title=param)
    else:
        year, month = param.split("-")
        article_list = models.Article.objects.filter(user=user).filter(create_time__year=year, create_time__month=month)
else:
    article_list = models.Article.objects.filter(user=user)

　　由于models.Article.objects.filter(user=user)出现了多次重复，代码优化如下：

article_list = models.Article.objects.filter(user=user)
if kwargs:
    condition = kwargs.get("condition")
    param = kwargs.get("param")  # 2012-12

    if condition=="category":
        article_list = article_list.filter(category__title=param)
    elif condition=="tag":
        article_list = article_list.filter(tags__title=param)
    else:
        year, month = param.split("-")
        article_list = article_list.filter(create_time__year=year, create_time__month=month)

（4）日期归档时，当condition="archive"时，param的值是类似2012-12这样的格式，需要进行切割处理

year, month = param.split("-")　

 访问验证

　　

　　

　　

3、home_site.html模板修改

　　需要在views.py的return render中再给模板传递一个"username":

def home_site(request, username, **kwargs):
　　...
　　return render(request, "home_site.html",
                  {"username": username, "blog": blog, "article_list": article_list, "cate_list": cate_list, "tag_list": tag_list,
                   "date_list": date_list})

（1）我的标签 添加<a>并填写访问路径

<div class="panel panel-warning">
    <div class="panel-heading">我的标签</div>
    <div class="panel-body">
        {% for tag in tag_list %}
            <p><a href="/{{ username }}/tag/{{ tag.0 }}">{{ tag.0 }}({{ tag.1 }})</a></p>
        {% endfor %}
    </div>
</div>

　　注意{{tag.0}}是标签名称。点击验证如下：

　　

（2）随笔分类  处理方式和tag类似

<div class="panel panel-danger">
    <div class="panel-heading">随笔分类</div>
    <div class="panel-body">
        {% for cate in cate_list %}
            <p><a href="/{{ username }}/category/{{ cate.0 }}">{{ cate.0 }}({{ cate.1 }})</a></p>
        {% endfor %}
    </div>
</div>

　　显示效果：

　　

（3）随笔归档处理如下：

<div class="panel panel-success">
    <div class="panel-heading">随笔归档</div>
    <div class="panel-body">
        {% for date in date_list %}
            <p><a href="/{{ username }}/archive/{{ date.0 }}">{{ date.0 }}({{ date.1 }})</a></p>
        {% endfor %}
    </div>
</div>

　　显示效果如下：