文章目錄

• • 0.思路引導(dǎo)
  • 1.Model 回顧
  • 2.數(shù)據(jù)庫數(shù)據(jù)聚合
  • 3.使用 Annotate
  • 4.在模板中引用新增的屬性

0.思路引導(dǎo)

在我們的博客側(cè)邊欄有分類列表和標(biāo)簽列表，顯示博客已有的全部文章分類。現(xiàn)在想在分類名和標(biāo)簽名后顯示該分類或者標(biāo)簽下有多少篇文章，該怎么做呢？最優(yōu)雅的方式就是使用 django 的 annotate 方法。

1.Model 回顧

回顧一下我們的 model 代碼，django 博客有一個 Post 和 Category 模型，分別表示文章和分類：

文件位置：blog/models.py

class Post(models.Model):title = models.CharField('標(biāo)題', max_length=70)body = models.TextField('正文')category = models.ForeignKey(Category, verbose_name='分類', on_delete=models.CASCADE)# 其它屬性...def __str__(self):return self.titleclass Category(models.Model):name = models.CharField('分類名', max_length=100)

我們知道從數(shù)據(jù)庫取數(shù)據(jù)都是使用模型管理器 objects 的方法實現(xiàn)的。比如獲取全部分類是：Category.objects.all() ，假設(shè)有一個名為 test 的分類，那么獲取該分類的方法是：Category.objects.get(name=‘test’) 。

objects 除了 all、get 等方法外，還有很多操作數(shù)據(jù)庫的方法，而其中有一個 annotate 方法，該方法可以幫我們實現(xiàn)本文所關(guān)注的統(tǒng)計分類下的文章數(shù)量的功能。

2.數(shù)據(jù)庫數(shù)據(jù)聚合

annotate 方法在底層調(diào)用了數(shù)據(jù)庫的數(shù)據(jù)聚合函數(shù)，下面使用一個實際的數(shù)據(jù)庫表來幫助我們理解 annotate 方法的工作原理。

在 Post 模型中我們通過 ForeignKey 把 Post 和 Category 關(guān)聯(lián)了起來，這時候它們的數(shù)據(jù)庫表結(jié)構(gòu)就像下面這樣：

Post 表：
Category 表：

1）當(dāng) Django 要查詢某篇 post 對應(yīng)的分類時，比如 post 1，首先查詢到它分類的 id 為 1，然后 Django 再去 Category 表找到 id 為 1 的那一行，這一行就是 post 1 對應(yīng)的分類。

2）反過來，如果要查詢 category 1 對應(yīng)的全部文章呢？category 1 在 Category 表中對應(yīng)的 id 是 1，Django 就在 Post 表中搜索哪些行的 category_id 為 1，發(fā)現(xiàn)前 3 行都是，把這些行取出來就是 category 1 下的全部文章了。

3）同理，這里 annotate 做的事情就是把全部 Category 取出來，然后去 Post 查詢每一個 Category 對應(yīng)的文章，查詢完成后只需算一下每個 category id 對應(yīng)有多少行記錄，這樣就可以統(tǒng)計出每個 Category 下有多少篇文章了。

4）把這個統(tǒng)計數(shù)字保存到每一條 Category 的記錄就可以了（當(dāng)然并非保存到數(shù)據(jù)庫，在 Django ORM 中是保存到 Category 的實例的屬性中，每個實例對應(yīng)一條記錄）。

3.使用 Annotate

以上是原理方面的分析，具體到 Django 中該如何用呢？在我們的博客中，獲取側(cè)邊欄的分類列表的方法寫在模板標(biāo)簽 get_categories 里，因此我們修改一下這個函數(shù)，具體代碼如下：

文件位置：blog/templatetags/blog_extras.py

from django.db.models.aggregates import Count from blog.models import Category@register.inclusion_tag('blog/inclusions/_categories.html', takes_context=True) def show_categories(context):category_list = Category.objects.annotate(num_posts=Count('post')).filter(num_posts__gt=0)return {'category_list': category_list,}

1）這個 Category.objects.annotate 方法和 Category.objects.all 有點類似，它會返回數(shù)據(jù)庫中全部 Category 的記錄，但同時它還會做一些額外的事情，在這里我們希望它做的額外事情就是去統(tǒng)計返回的 Category 記錄的集合中每條記錄下的文章數(shù)。

2）代碼中的 Count 方法為我們做了這個事，它接收一個和 Categoty 相關(guān)聯(lián)的模型參數(shù)名（這里是 Post，通過 ForeignKey 關(guān)聯(lián)的），然后它便會統(tǒng)計 Category 記錄的集合中每條記錄下的與之關(guān)聯(lián)的 Post 記錄的行數(shù)，也就是文章數(shù)，最后把這個值保存到 num_posts 屬性中。

3）此外，我們還對結(jié)果集做了一個過濾，使用 filter 方法把 num_posts 的值小于 1 的分類過濾掉。因為 num_posts 的值小于 1 表示該分類下沒有文章，沒有文章的分類我們不希望它在頁面中顯示。

同理，tags 也可以做同樣的操作。

@register.inclusion_tag('blog/inclusions/_tags.html', takes_context=True) def show_tags(context):tag_list = Tag.objects.annotate(num_posts=Count('post')).filter(num_posts__gt=0)return {'tag_list': tag_list,}

4.在模板中引用新增的屬性

現(xiàn)在在 Category 和 Tag 列表中每一項都新增了一個 num_posts 屬性記錄該 Category 下的文章數(shù)量，我們就可以在模板中引用這個屬性來顯示分類下的文章數(shù)量了。

文件位置：templates/blog/inclusions/_categories.html

<div class="widget widget-category"><h3 class="widget-title">分類</h3><ul>{% for category in category_list %}<li><a href="{% url 'blog:category' category.pk %}">{{ category.name }} <span class="post-count">({{ category.num_posts }})</span></a></li>{% empty %}暫無分類！{% endfor %}</ul> </div>

文件位置：templates/blog/inclusions/_tags.html

<div class="widget widget-tag-cloud"><h3 class="widget-title">標(biāo)簽云</h3><ul>{% for tag in tag_list %}<li><a href="{% url 'blog:tag' tag.pk %}">{{ tag.name }} <span class="post-count">({{ tag.num_posts }})</a></li>{% empty %}暫無標(biāo)簽！{% endfor %}</ul> </div>

也就是在模板中通過模板變量 {{ category.num_posts }}以及 {{ tag.num_posts }}顯示 num_posts 的值。

開啟開發(fā)服務(wù)器，可以看到分類名后正確地顯示了該分類下的文章數(shù)了，而沒有文章分類則不會在分類列表中出現(xiàn)。

效果展示如下：

總結(jié)

以上是生活随笔為你收集整理的Diango博客--17.统计各个分类和标签下的文章数的全部內(nèi)容，希望文章能夠幫你解決所遇到的問題。

如果覺得生活随笔網(wǎng)站內(nèi)容還不錯，歡迎將生活随笔推薦給好友。