把 JSON 对象转换成带缩进的 XML 文档。以 @ 开头的 key 变成属性,#text key 变成元素的文本,数组则重复生成同名元素,因此只用普通的 JSON 就能描述带属性的 XML。
适合手里的数据是 JSON、却必须发送 XML 的场景:SOAP 请求体、RSS feed 或 sitemap,以及只接受 XML 的遗留支付、物流或政务 API。
JSON 框中。让顶层成为只有一个 key 的对象,比如 {"rootName": {...}},这个 key 就会成为根元素。@ 前缀的 key,如 "@id": "1";要让属性和文本内容并存,使用 "#text" key。结果 下检查包括 <?xml ...?> 声明在内的文档,然后复制。{
"rss": {
"@version": "2.0",
"channel": {
"title": "Release notes",
"item": [
{ "title": "v1.2 & fixes", "guid": { "@isPermaLink": "false", "#text": "r-12" } },
{ "title": "v1.3", "guid": { "@isPermaLink": "false", "#text": "r-13" } }
]
}
}
}<?xml version="1.0" encoding="UTF-8"?>
<rss version="2.0">
<channel>
<title>Release notes</title>
<item>
<title>v1.2 & fixes</title>
<guid isPermaLink="false">r-12</guid>
</item>
<item>
<title>v1.3</title>
<guid isPermaLink="false">r-13</guid>
</item>
</channel>
</rss>
@version 和 @isPermaLink 变成了属性,guid 的 #text 成为元素内容。item 数组被写成两个 <item> 元素,标题中的 & 被转义为 &。
<?xml version="1.0" encoding="UTF-8"?> 声明,并以两个空格缩进。<root> 包裹,数组的每一项写成 <item>。&、<、>、" 和 ' 转义为实体。_,以数字开头的 key 会加上前导 _:first name → first_name,2nd → _2nd。null 值写成 <tag/> 这样的空元素。照着 WSDL 示例手写标签,很容易让开始标签和结束标签对不上。把请求数据写成 JSON 再转换,标签配对和转义都不会出错。
先用 JSON 勾勒出服务器应该输出的 feed,确认哪些 key 会变成属性、哪些会变成重复元素,再把这个结构移植到代码中。
[])没有可重复的内容,会从输出中消失。<price>12.5</price>,不带 XML Schema 类型信息。"soap:Envelope" 这样的 key 和 "@xmlns:soap" 属性,它们会按原样输出。把数据包在一个只有一个 key 的对象里,例如 {"order": {...}}。如果有多个 key,或那唯一的值是数组,就会改用 <root>。
给一个数组:{"tag": ["a", "b"]} 会变成 <tag>a</tag><tag>b</tag>。如果要在外面套一层 <tags>,使用 {"tags": {"tag": [...]}}。
中文、韩文或带重音的字符等 Unicode 字母在 XML 名称中是合法的,会原样保留。空格、/ 以及不在开头的 @ 会被替换成 _,请确认标签名符合接收方的预期。