在内容分发、站点更新通知等场景中,RSS Feed是常用的数据格式,很多业务场景中我们已经存储了JSON格式的内容数据,需要将其转换为RSS Feed供订阅器读取。RSS Feed本质是符合特定规范的XML文档,核心包含频道信息和多个内容项,只要按照规范拼接XML结构即可完成转换。

RSS Feed基础结构说明
标准的RSS 2.0格式Feed主要包含两部分内容,第一部分是频道整体信息,第二部分是多个内容项。频道信息需要包含标题、链接、描述等基础属性,内容项则需要包含每条内容的标题、发布时间、链接、描述等信息。
一个最简化的RSS Feed结构如下,所有内容项都放在<channel>标签内部:
<?xml version="1.0" encoding="UTF-8"?>
<rss version="2.0">
<channel>
<title>站点名称</title>
<link>https://ipipp.com</link>
<description>站点描述信息</description>
<item>
<title>第一条内容标题</title>
<link>https://ipipp.com/article/1</link>
<pubDate>Mon, 01 Jan 2024 00:00:00 GMT</pubDate>
<description>第一条内容描述</description>
</item>
</channel>
</rss>
Node.js转换实现步骤
1. 准备JSON数据源
首先我们需要准备好要转换的JSON数据,假设我们的JSON数据是一个数组,每个元素代表一条内容,包含标题、链接、发布时间、描述等字段,示例如下:
// 待转换的JSON数据
const jsonData = [
{
title: "Node.js基础教程",
link: "https://ipipp.com/nodejs-basic",
pubDate: "2024-01-01T00:00:00.000Z",
description: "Node.js入门基础知识点讲解"
},
{
title: "RSS Feed规范说明",
link: "https://ipipp.com/rss-spec",
pubDate: "2024-01-02T00:00:00.000Z",
description: "RSS 2.0格式规范详细解读"
}
];
2. 编写转换函数
接下来我们编写核心的转换函数,遍历JSON数组,将每个对象的属性对应拼接到RSS的XML结构中,同时需要注意XML特殊字符的转义,避免生成的文档格式错误。
/**
* 将JSON数据转换为RSS Feed字符串
* @param {Array} items 内容项数组
* @param {Object} channelInfo 频道基础信息
* @returns {String} RSS Feed XML字符串
*/
function jsonToRss(items, channelInfo) {
// 转义XML特殊字符,避免格式错误
function escapeXml(str) {
if (typeof str !== "string") return str;
return str.replace(/&/g, "&")
.replace(/</g, "<")
.replace(/>/g, ">")
.replace(/"/g, """)
.replace(/'/g, "'");
}
// 拼接频道头部信息
let rssContent = `<?xml version="1.0" encoding="UTF-8"?>
<rss version="2.0">
<channel>
<title>${escapeXml(channelInfo.title)}</title>
<link>${escapeXml(channelInfo.link)}</link>
<description>${escapeXml(channelInfo.description)}</description>`;
// 遍历JSON数据拼接内容项
items.forEach(item => {
// 将ISO格式时间转换为RSS要求的GMT格式
const pubDate = new Date(item.pubDate).toUTCString();
rssContent += `
<item>
<title>${escapeXml(item.title)}</title>
<link>${escapeXml(item.link)}</link>
<pubDate>${pubDate}</pubDate>
<description>${escapeXml(item.description)}</description>
</item>`;
});
// 拼接闭合标签
rssContent += `
</channel>
</rss>`;
return rssContent;
}
3. 调用函数生成Feed
最后我们传入准备好的JSON数据和频道信息,调用转换函数即可得到完整的RSS Feed内容,如果是Web服务场景,可以直接将内容返回给客户端,设置正确的Content-Type即可。
// 频道基础信息
const channelInfo = {
title: "技术博客更新",
link: "https://ipipp.com",
description: "分享前端、后端相关技术文章"
};
// 生成RSS Feed
const rssFeed = jsonToRss(jsonData, channelInfo);
console.log(rssFeed);
// 如果是Express服务场景,返回Feed的示例
// const express = require("express");
// const app = express();
// app.get("/rss", (req, res) => {
// res.set("Content-Type", "application/rss+xml; charset=utf-8");
// res.send(rssFeed);
// });
// app.listen(3000);
注意事项
- 所有插入到XML中的文本内容都需要做特殊字符转义,否则会导致XML解析失败
- RSS Feed的时间格式要求是RFC 822格式,也就是GMT时间格式,需要将JSON中的时间做对应转换
- 如果需要支持更多RSS特性,比如分类、作者等字段,只需要在<item>标签中按照规范添加对应的子标签即可
- 生成的RSS内容可以直接保存为.xml文件,也可以通过接口返回给订阅客户端使用