基于.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
添加到订阅源之后,就可以看到今年发布的文章了
搞定,收工~