Net Core教程

基于.NetCore开发博客项目 StarBlog - (29) 开发RSS订阅功能

本文主要是介绍基于.NetCore开发博客项目 StarBlog - (29) 开发RSS订阅功能,对大家解决编程问题具有一定的参考价值,需要的程序猿们随着小编来一起学习吧!

前言

最近忙中偷闲把博客的评论功能给做完了,我可以说这个评论功能已经达到「精致」的程度了😃

但在正式发布之前,先卖个关子,来介绍一下另一个新功能——RSS订阅🔊

RSS是啥

来自hk gov新闻网的介绍~

RSS 是簡易資訊聚合(Really Simple Syndication) 的簡稱,RSS採用一個 XML 的檔案格式,只要你把RSS內容的網址,加到你的RSS閱讀軟件 (RSS Reader),每當該網頁內容更新時,更新了的摘要便會自動加到你的閱讀軟件之內,通知你有關內容。透過 RSS 的使用,供應網頁內容的人可以很容易地產生並傳播新聞鏈結、標題和摘要等資料。

一个网站支持 RSS,就意味着每当它新发布一篇新文章,就会往一个位于特定网址的文件中,以特定的语法(具体而言是 XML 标记语言或 JSON)增加一条记录,列明这篇文章的标题、作者、发表时间和内容(可以是全文,也可以是摘要)等信息。这样,用户只要搜集所有他感兴趣的网站提供的这种文件的网址,并不时检查这些文件内容的更新,就能知道这些网站是否、何时发布了什么内容。RSS 阅读器的核心功能,就是存储用户订阅的 RSS 地址,以固定的频率自动检查更新,并将其内容转换为易读的格式呈现给用户。

为啥要开发RSS功能

起先是有用户在StarBlog项目github里提了个issue

我觉得挺不错的,实现起来也不难,所以就着手安排实现了。

对于现在的网友来说,这算是个比较陌生和小众的东西,RSS 的对立面是算法推荐,像微信公众号、知乎、微博、今日头条等平台。 且不说算法推送平台广告多,迁移麻烦的问题。算法推荐的特点是,你不需要刻意选择,算法会根据你的喜好,给你推送内容。这样一来,你几乎没有选择的余地,在不断被「喂饱」中逐渐失去判断的能力。更可怕的地方在于,它替你定义了你的画像,然后把你潜移默化中变成了它所认为的你。「大数据杀熟」的东窗事发绝非偶然,用算法窥视用户隐私是当今互联网公司的通配。

做信息的主人,而不是奴隶。RSS 是一种公开的协议,可自由更换平台与客户端。重要的一点是,获取信息的权力完全自治。RSS 相比算法推荐,拥有了可控性和安全感,隐私完全掌握在自己手里。

RSS版本 - Atom 与 RSS2.0

我一开始以为 RSS2.0 比 Atom1.0 更新,结果完全搞反了~

简单来说:ATOM是RSS2.0的改进方案,因为RSS2.0的标准已经冻结,所以才出了ATOM。主要改进是ATOM可以通过标签识别一个内容是否是全文输出而RSS2.0不可以。

同时,ATOM不仅能够判断出内容是否是全文输出,在终端软件使用该FEED时,还可以从中得到那一部分是“摘要”那一部分是“全文”方便进行区别显示。

那肯定选新版的啦,直接用 Atom1.0 版本。

实现

一开始我是打算找个第三方库,可以直接和AspNetCore很好地结合在一起的那种。

不过没有找到,但是我发现 C# 标准库居然有提供对 RSS 的支持~ 那还要啥自行车,立刻安排!🆗

安装依赖

虽然是「标准库」但因为现在 .net core 是很轻的,所以还是需要手动添加个 nuget 包才可以用。

dotnet add package System.ServiceModel.Syndication

这个 Syndication 库可以很方便的创建 RSS 订阅。

下面分步骤实现

添加接口

添加 StarBlog.Web/Controllers/RssController.cs 文件

[ApiController]
[Route("feed")]
[ApiExplorerSettings(IgnoreApi = true)]
public class RssController : ControllerBase {
  private readonly IBaseRepository<Post> _postRepo;

  public RssController(IBaseRepository<Post> postRepo) {
    _postRepo = postRepo;
  }

  [ResponseCache(Duration = 1200)]
  [HttpGet]
  public async Task<IActionResult> Index() {
  }
}

接着在 Index 方法里面写代码

创建 feed

var feed = new SyndicationFeed("StarBlog", "程序设计实验室,一个技术探索与知识分享的平台", new Uri("http://blog.deali.cn"), "RSSUrl", DateTime.Now) {
  Copyright = new TextSyndicationContent($"{DateTime.Now.Year} DealiAxy")
};

传入的参数分别是标题、说明、网站地址、订阅ID和最后更新时间。

这里只是例子,所以把更新时间直接写成当前时间了,实际上应该把最新文章的时间写进去。

添加文章

把博客的文章添加到订阅源里

var items = new List<SyndicationItem>();
var posts = await _postRepo.Where(a => a.IsPublish && a.CreationTime.Year == DateTime.Now.Year)
  .Include(a => a.Category)
  .ToListAsync();
foreach (var item in posts) {
  var postUrl = Url.Action("Post", "Blog", new { id = item.Id }, HttpContext.Request.Scheme);
  items.Add(new SyndicationItem(item.Title, item.Summary, new Uri(postUrl), item.Id, item.LastUpdateTime) {
    Categories = { new SyndicationCategory(item.Category?.Name) },
    Authors = { new SyndicationPerson("admin@deali.cn", "DealiAxy", "https://deali.cn") },
    PublishDate = item.CreationTime
  });
}
feed.Items = items;

这里我把今年已发布的文章都放进订阅源里。

RSS文章内容通过 SyndicationItem 构造方法的第二个参数传入,为了实例代码简洁,我直接偷懒使用纯文本的 summary

如果要让 RSS 阅读器显示文章的时候图文并茂,应该使用 HTML 格式的文章内容,可以把 item.Summary 换成以下代码

new TextSyndicationContent(PostService.GetContentHtml(item), TextSyndicationContentKind.Html)

生成xml

最后,因为 RSS 是使用 XML 格式的,所以最后需要使这个接口返回 XML 数据。

var settings = new XmlWriterSettings {
  Async = true,
  Encoding = Encoding.UTF8,
  NewLineHandling = NewLineHandling.Entitize,
  NewLineOnAttributes = true,
  Indent = true
};
using var stream = new MemoryStream();
await using var xmlWriter = XmlWriter.Create(stream, settings);
var rssFormatter = new Atom10FeedFormatter(feed);
rssFormatter.WriteTo(xmlWriter);
await xmlWriter.FlushAsync();

return File(stream.ToArray(), "application/rss+xml; charset=utf-8");

注意 var rssFormatter = new Rss20FeedFormatter(feed, false); 这行代码,表示我们用的 RSS 版本是 Atom1.0。

如果要用 RSS2.0 ,可以换成以下代码,第二个参数设置为 false 代表不把扩展语法渲染成 Atom 1.0 的样式。

var rssFormatter = new Rss20FeedFormatter(feed, false);

完整代码

完整代码见 github ~

https://github.com/Deali-Axy/StarBlog/blob/dev/StarBlog.Web/Controllers/RssController.cs

最终效果

RSS 订阅需要使用客户端阅读

这里我使用了一个开源的Windows客户端 Fluent Reader

blog.deali.cn/feed 添加到订阅源之后,就可以看到今年发布的文章了

搞定,收工~

参考资料

  • https://mitchelsellers.com/blog/article/creating-an-rss-feed-in-asp-net-core-3-0
  • https://www.news.gov.hk/chi/rss/index.html
  • https://sspai.com/post/56198
  • https://www.zhihu.com/question/19593963/answer/12361526
这篇关于基于.NetCore开发博客项目 StarBlog - (29) 开发RSS订阅功能的文章就介绍到这儿,希望我们推荐的文章对大家有所帮助,也希望大家多多支持为之网!