Cinchoo ETL - 将 JSON 转换为带命名空间的 XML
使用 Cinchoo ETL 将 JSON 转换为带命名空间的 XML 的技巧
- 下载 Cinchoo ETL 源代码
- 下载 Cinchoo ETL 二进制文件 (.NET Core)
- 下载 Cinchoo ETL 二进制文件 (.NET Framework)
- 工作示例 1 (.NET Fiddle)
- 工作示例 2 (.NET Fiddle)
1. 引言
ChoETL 是一个用于 .NET 的开源 ETL(提取、转换和加载)框架。它是一个基于代码的库,用于从多个来源提取数据、进行转换并将其加载到您自己的 .NET 环境中的数据仓库中。您可以立即将数据放入您的数据仓库中。
本技巧讨论了如何使用 Cinchoo ETL 框架将 JSON 转换为具有命名空间的 XML。它非常易于使用,只需几行代码即可完成转换。您可以转换大型文件,因为转换过程是基于流的,速度很快,并且内存占用量低。
2. 要求
这个框架库是用 C# 编写的,使用 .NET 4.5 / .NET Core 3.x 框架。
3. 如何使用
3.1 示例数据
让我们首先看一下下面的 JSON 文件,其中包含复杂、嵌套的结构。例如,我们有两家公司,第一家公司有两个分支机构,而第二家公司只有一个分支机构。
列表 3.1.1 示例 JSON 文件 (items.json)
{
"item": {
"name": "item #1"
"code": "itm-123"
"image": {
"@url": "http://www.foo.com/bar.jpg"
"title": "bar"
}
}
}
预期的 JSON 输出如下所示
列表 3.1.2 XML 输出文件 (items.xml)
<foo:item xmlns:foo="http://foo.com">
<foo:name>item #1</foo:name>
<foo:code>itm-123</foo:code>
<foo:image url="http://www.test.com/bar.jpg">
<foo:title>bar</foo:title>
</foo:image>
</foo:item>
3.2 安装库
接下来,安装 ChoETL.JSON / ChoETL.JSON.NETStandard
nuget 包。为此,请在包管理器控制台中运行以下命令。
.NET 标准框架
Install-Package ChoETL.JSON
.NET Core
Install-Package ChoETL.JSON.NETStandard
现在将 ChoETL
命名空间添加到程序。
using ChoETL;
3.3 快速转换
让我们使用该库将复杂的结构化 JSON 转换为具有命名空间的 XML。这就像使用几行代码一样简单。不需要 POCO 类。它速度快、基于流并且消耗的内存少。
列表 3.3.1. 快速 JSON 文件转换
private static void QuickConversion()
{
using (var r = new ChoJSONReader.LoadText("items.json"))
{
using (var w = new ChoXmlWriter("items.xml")
.IgnoreRootName()
.IgnoreNodeName()
.WithDefaultXmlNamespace("foo", "http://foo.com")
)
{
w.Write(r);
}
}
}
创建一个 ChoXmlWriter
实例以生成 XML (items.xml) 输出文件。然后创建一个 ChoJSONReader
对象实例以读取复杂的 JSON (items.json) 文件。
其中
IgnoreRootName()
- 告诉写入器不输出根元素IgnoreNodeName()
- 告诉写入器不输出节点元素WithDefaultXmlNamespace("foo", "http://foo.com")
- 告诉写入器将传递的 XML 命名空间用作所有节点的默认值
示例 Fiddle:https://dotnetfiddle.net/MITsuL
3.4 将不同的 XML 命名空间添加到子节点
此示例将展示如何将不同的 XML 命名空间添加到子节点,而不是根节点。在这里,您将看到如何将“http://temp.com
”添加到 image
节点。
列表 3.4.1. 将不同的 XML 命名空间添加到子节点
private static void AddDifferentNamespaceToSubnode()
{
using (var r = new ChoJSONReader("items.json"))
{
using (var w = new ChoXmlWriter("items.xml")
.IgnoreRootName()
.IgnoreNodeName()
.WithDefaultXmlNamespace("foo", "http://foo.com")
.WithXmlNamespace("temp", "http://temp.com")
)
{
w.Write(r.Select(rec =>
{
rec.item.image.AddNamespace("temp", "http://temp.com");
return rec;
}
)
);
}
}
}
创建一个 ChoJSONWriter
实例以生成扁平化的 JSON (companies_out.json) 输出文件。然后创建一个 ChoJSONReader
对象实例以读取复杂的 JSON (companies.json) 文件。
其中
IgnoreRootName()
- 告诉写入器不输出根元素IgnoreNodeName()
- 告诉写入器不输出节点元素WithDefaultXmlNamespace("foo", "http://foo.com")
- 告诉写入器将传递的 XML 命名空间用作所有节点的默认值WithXmlNamespace("temp", "http://temp.com")
- 告诉写入器使用传递的 XML 命名空间作为所有子节点及其子节点的附加命名空间。AddNamespace("temp", "http://temp.com")
- 使用此方法将子节点指定要使用的 XML 命名空间。
运行代码后将生成以下 XML 输出。
列表 3.4.2. 具有不同 XML 命名空间的子节点的 XML 输出
<foo:item xmlns:foo="http://foo.com" xmlns:temp="http://temp.com">
<foo:name>item #1</foo:name>
<foo:code>itm-123</foo:code>
<temp:image url="http://www.test.com/bar.jpg">
<temp:title>bar</temp:title>
</temp:image>
</foo:item>
示例 fiddle:https://dotnetfiddle.net/OO0fpx
下载上面附带的示例,试一试。
有关 Cinchoo ETL 的更多信息,请访问其他 CodeProject 文章。
历史
- 2021 年 10 月 27 日:初始版本