2024-008-007T13:53

一. 导言 导言 导言 导言 导言 导言 一,导言 导言 导言 导言 导言 导言

RSS(和Atom)仍然是唯一被广泛采用的内容合成格式。 这是一个简单的 XML 格式, 可以被广泛的种子阅读器使用。 我将教你们如何在 ASP. NET 核心应用程序中添加 RSS 种子。

[技选委

创建种子

其核心其实是为 RSS 种子创建 XML 文档 。 下面的代码列表 RssFeedItem 为种子生成 XML 对象。 缩略 RssFeedItem 类是指在种子中代表项目的简单类。 它具有标题、链接、描述、公布日期和类别等属性。

    public string GenerateFeed(IEnumerable<RssFeedItem> items, string categoryName = "")
    {
        XNamespace atom = "http://www.w3.org/2005/Atom";
        var feed = new XDocument(
            new XDeclaration("1.0", "utf-8", null),
            new XElement("rss",    new XAttribute(XNamespace.Xmlns + "atom", atom.NamespaceName), new XAttribute("version", "2.0"),
                new XElement("channel",
                    new XElement("title", !string.IsNullOrEmpty(categoryName) ? $"mostlylucid.net for {categoryName}" : $"mostlylucid.net"),
                    new XElement("link", $"{GetSiteUrl()}/rss"),
                    new XElement("description", "The latest posts from mostlylucid.net"),
                    new XElement("pubDate", DateTime.UtcNow.ToString("R")),
                    new XElement(atom + "link", 
                        new XAttribute("href", $"{GetSiteUrl()}/rss"), 
                        new XAttribute("rel", "self"), 
                        new XAttribute("type", "application/rss+xml")),
                    from item in items
                    select new XElement("item",
                        new XElement("title", item.Title),
                        new XElement("link", item.Link),
                        new XElement("guid", item.Guid, new XAttribute("isPermaLink", "false")),
                        new XElement("description", item.Description),
                        new XElement("pubDate", item.PubDate.ToString("R")),
                        from category in item.Categories
                        select new XElement("category", category)
                    )
                )
            )
        );

        var settings = new XmlWriterSettings
        {
            Indent = true,
            Encoding = new UTF8Encoding(false) // UTF-8 without BOM
        };

        using (var memoryStream = new MemoryStream())
        using (var writer = XmlWriter.Create(memoryStream, settings))
        {
            feed.Save(writer);
            writer.Flush();
            return Encoding.UTF8.GetString(memoryStream.ToArray());
        }
    }

上述代码中值得注意的一点是: 我们需要创建 Atoom 命名空间并将其注入 XML 文档以支持 atom:link 元素。

     XNamespace atom = "http://www.w3.org/2005/Atom";
        var feed = new XDocument(
            new XDeclaration("1.0", "utf-8", null),
            new XElement("rss",    new XAttribute(XNamespace.Xmlns + "atom", atom.NamespaceName), new XAttribute("version", "2.0"),

UTF-8 编码

虽然我们具体说明 utf-8 这里ASP.NET核心忽略了这一点... 因为它很特别 相反,我们需要确保文件中生成的字符串实际上是UTF-8,我本以为

   var settings = new XmlWriterSettings
        {
            Indent = true,
            Encoding = new UTF8Encoding(false) // UTF-8 without BOM
        };

但是没有... 我们需要这样做:

        using (var memoryStream = new MemoryStream())
        using (var writer = XmlWriter.Create(memoryStream, settings))
        {
            feed.Save(writer);
            writer.Flush();
            return Encoding.UTF8.GetString(memoryStream.ToArray());
        }

这样它就可以输出一个带有 utf-8 编码的 XML 文档 。

控制器

从那里,在RSS中,我们非常简单, 我们有一个方法可以接受 category 和 startdate (目前是一个超级秘密特征? ) 返回 feed。

    [HttpGet]
    public IActionResult Index([FromQuery] string category = null, [FromQuery] string startDate = null)
    {
        DateTime? startDateTime = null;
        if (DateTime.TryParseExact(startDate, "yyyy-MM-dd", CultureInfo.InvariantCulture, DateTimeStyles.None,
                out DateTime startDateTIme))
        {
            logger.LogInformation("Start date is {startDate}", startDate);
        }

        var rssFeed = rssFeedService.GenerateFeed(startDateTime, category);
        return Content(rssFeed, "application/rss+xml", Encoding.UTF8);
    }

然后,在 `_布局. cshtml' 我们为种子添加链接 :

        <link rel="alternate" type="application/rss+xml"
              title="RSS Feed for mostlylucid.net"
              href="/rss" />

这确保了 feed 的读者能够“ 自动发现 ” 的 feed 阅读器 。