阅读: 13343 评论：4

Django提供了一个高层次的聚合内容框架，让我们创建RSS/Atom变得简单，你需要做的只是编写一个简单的Python类。

一、范例

要创建一个feed，只需要编写一个Feed类，然后设置一条指向Feed实例的URLconf就可以了，非常简单，下面是一个示例，演示了某站点的最近五条新闻记录：

  1. from django.contrib.syndication.views import Feed
  2. from django.urls import reverse
  3. from policebeat.models import NewsItem
  5. class LatestEntriesFeed(Feed):
  6.     title = "Police beat site news"
  7.     link = "/sitenews/"
  8.     description = "Updates on changes and additions to police beat central."
  10.     def items(self):
  11.         return NewsItem.objects.order_by('-pub_date')[:5]
  13.     def item_title(self, item):
  14.         return item.title
  16.     def item_description(self, item):
  17.         return item.description
  19.     # item_link is only needed if NewsItem has no get_absolute_url method.
  20.     def item_link(self, item):
  21.         return reverse('news-item', args=[item.pk])

要设置链接这个feed的URL，只需要将这个Feed类的实例，作为参数，加入URLconf，如下所示：

  1. from django.conf.urls import url
  2. from myproject.feeds import LatestEntriesFeed
  4. urlpatterns = [
  5.     # ...
  6.     url(r'^latest/feed/$', LatestEntriesFeed()),
  7.     # ...
  8. ]

注意:

  • 新建的Feed类继承于django.contrib.syndication.views.Feed。
  • title、link和description属性分别对应标准RSS的、和``元素。
  • items()方法简单地返回此Feed需要包含的对象，列表形式。
  • 如果你要创建一个Atom feed，而不是RSS feed，使用subtitle属性替代description。

还有一件事要做。在一个 RSS feed中，每一个都有一个, 和， 我们需要告诉框架往这些对象里放入哪些数据。

  • 对于和，Django将尝试调用Feed类中的item_title()和item_description()方法。 这两个方法都会被传入一个参数：item，也就是对象自己。
  • 对于`，Django首先会尝试调用item_link()方法，如果该方法不存在，则使用对象的ORM模型中定义的get_absolute_url()`方法。

二、指定feed类型

默认情况下，使用RSS 2.0类型，如果要指定类型，在Feed类中添加feed_type属性，如下所示：

  1. from django.utils.feedgenerator import Atom1Feed
  3. class MyFeed(Feed):
  4.     feed_type = Atom1Feed

目前可用的类型有下面三种：

  • django.utils.feedgenerator.Rss201rev2Feed (RSS 2.01. Default.)
  • django.utils.feedgenerator.RssUserland091Feed (RSS 0.91.)
  • django.utils.feedgenerator.Atom1Feed (Atom 1.0.)

三、同时发布Atom和RSS feeds

要同时发布这两者，很简单，为你的Feed类创建一个子类，并且将其feed_type设置为你需要的类型，最后添加一条URLconf就可以了，如下所示：

  1. from django.contrib.syndication.views import Feed
  2. from policebeat.models import NewsItem
  3. from django.utils.feedgenerator import Atom1Feed
  5. class RssSiteNewsFeed(Feed):
  6.     title = "Police beat site news"
  7.     link = "/sitenews/"
  8.     description = "Updates on changes and additions to police beat central."
  10.     def items(self):
  11.         return NewsItem.objects.order_by('-pub_date')[:5]
  13. # 增加下面的子类
  14. class AtomSiteNewsFeed(RssSiteNewsFeed):
  15.     feed_type = Atom1Feed # 修改类型
  16.     subtitle = RssSiteNewsFeed.description

增加路由：

  1. from django.conf.urls import url
  2. from myproject.feeds import RssSiteNewsFeed, AtomSiteNewsFeed
  4. urlpatterns = [
  5.     # ...
  6.     url(r'^sitenews/rss/$', RssSiteNewsFeed()),
  7.     url(r'^sitenews/atom/$', AtomSiteNewsFeed()),
  8.     # ...
  9. ]