Cinchoo ETL——快速入门：将JSON转换为Yaml文件

目录

1、简介

2. 要求

3. 如何使用

3.1 样本数据

3.2 快速转换

3.3 使用POCO对象

• 下载 Cinchoo ETL 源码
• 下载 Cinchoo ETL 二进制文件
• 工作示例 1（.NET Fiddle）
• 工作示例 2 (.NET Fiddle)

ChoETL是一个用于.NET的开源ETL（提取、转换和加载）框架。它是一个基于代码的库，用于在.NET环境中从多个来源提取数据、转换并加载到您自己的数据仓库中。您可以立即在数据仓库中获取数据。

本文讨论使用Cinchoo ETL框架从JSON格式生成Yaml文件。使用非常简单，几行代码就可以完成转换。您可以转换大文件，因为转换过程是基于流的，速度非常快且内存占用少。

该框架库是使用.NET 4.5/.NET Core 3.x框架用C#编写的。

让我们从一个转换以下JSON输入文件的简单示例开始。

清单 3.1.1 示例JSON数据输入文件(swagger.json)

{
   "swagger":"2.0",
   "info":{
      "title":"UberAPI",
      "description":"MoveyourappforwardwiththeUberAPI",
      "version":"1.0.0"
   },
   "host":"api.uber.com",
   "schemes":[
      "https"
   ],
   "basePath":"/v1",
   "produces":[
      "application/json"
   ]
}

预期的yaml输出将是。

清单 3.1.2 Yaml数据输出文件(swagger.yaml)

Swagger: 2.0
Info:
  Title: UberAPI
  Description: MoveyourappforwardwiththeUberAPI
  Version: 1.0.0
Host: api.uber.com
Schemes:
  - https
BasePath: /v1
Produces:
  - application/json

首先要做的是安装ChoETL.Yaml nuget包。为此，请在包管理器控制台中运行以下命令。

.NET Framework/.NET Core

Install-Package ChoETL.Yaml

现在将ChoETL命名空间添加到程序中。

using ChoETL;

这种方法展示了如何使用少量代码将JSON文件转换为Yaml格式。不需要设置/POCO类。

清单 3.2.1 快速JSON到Yaml文件转换

private static void QuickConversion()
{       
    using (var r = new ChoJSONReader("swagger.json"))
    {
        using (var w = new ChoYamlWriter("swagger.yaml")
               .Configure(c => c.SingleDocument = true)
              )
        {
            w.Write(r);
        }
    }
}

创建一个用于生成Yaml(swagger.yaml)文件的ChoYamlWriter实例。然后创建一个ChoJSONReader对象实例来读取swagger.json文件。瞧，Yaml文件转换发生在这段小代码中。

Fiddle示例：https ://dotnetfiddle.net/rpxQVa

这种方法向您展示了如何定义POCO实体类并将它们用于转换过程。这种方法更安全，并且可以更好地控制转换过程，例如进行属性验证、使用回调机制等。

首先，创建一个属性匹配JSON文件的类

清单 3.3.1 映射类

public class SwaggerDocument
{
    public string Swagger { get; set; }
    public Info Info { get; set; }
    public string Host { get; set; }
    public List Schemes { get; set; }
    public string BasePath { get; set; }
    public List Produces { get; set; }
}

public class Info
{
    public string Title { get; set; }
    public string Description { get; set; }
    public string Version { get; set; }
}

然后使用下面的这个类来进行文件的转换。

清单 3.3.2 使用POCO对象将JSON转换为Yaml文件

private static void UsingPOCO()
{
    using (var r = new ChoJSONReader("swagger.json"))
    {
        using (var w = new ChoYamlWriter("swagger.yaml")
               .Configure(c => c.SingleDocument = true)
              )
        {
            w.Write(r);
        }
    }
}

Fiddle示例：https ://dotnetfiddle.net/HIX4CU

https://www.codeproject.com/Tips/5314773/Cinchoo-ETL-Quick-Start-Converting-JSON-to-Yaml-Fi