为什么需要新的 JSON API ？
JSON.NET 大家都用过，老版本的 ASP.NET Core 也依赖于 JSON.NET 。
然而这个依赖就会引起一些版本问题：例如 ASP .NET Core某个版本需要使用 JSON .NET v10 ，而另一个库需要使用 JSON.NET v11 ；或者 JSON .NET 出现了一个新版本，而ASP .NET Core 还不能支持这个版本，而您却想使用该版本。
System.Text.Json
随着 NET Core 3.0 的出现，出现了 System .Text.Json 命名空间和它下面一些用于处理 JSON 的类。
特点
这个内置 JSON API 具有与生俱来的高性能、地分配的特点：
JSON .NET 使用 .NET 里面的字符串作为基本数据类型，其实也就是 UTF16 ，而 .NET Core 中新的 JSON API 直接使用数据原始的 UTF8 格式。
新的 JSON API 基于 Span <byte> 这个数据类型来进行操作 JSON 数据，从而具有低分配的特点，这就可以极大的改善吞吐量和内存使用情况。
但是新的JSON API 的特性还不那么丰富，有一些 JSON .NET 具有的特性都还不支持。
例子
随便找了一个 JSON 示例文件：
针对这个文件，需要修改一下它的属性：
Utf8JsonReader
先使用 Utf8JsonReader 来读取JSON文件。
Utf8JsonReader 并不会读取文件或者 stream ，它会读取Span数据类型。
直接上代码：
Main方法里面，我们使用 File .ReadAllBytes 从 sample .json 文件读取数格式为 byte[] ，然后通过 AsSpan 这个扩展方法将其转化为 Span <byte> 数据类型，然后把它传递到 Utf8JsonReader 的构造函数来创建一个JSON的 reader 。
接下来使用while循环对JSON数据的每个 Token 进行读取，每次执行 Read() 方法时， reader 就会移动到 JSON 数据里面的下一个 Token 那里。
Token 分成几种类型， GetToken Info 方法就是判断一下 Token 的类型，并返回一些描述性信息，这里面应该是包含了所有的类型。这里面使用到了C# 8 的 switch 表达式。
运行程序
结果如下：
可以看到 sample.json 文件里面的每个 Token 都被正确的显示了。
Json Document 类
Json Document 是基于 Utf8JsonReader 构建的 。 JsonDocument 可分析 JSON 数据并生成只读文档对象模型 (DOM) ，可对模型进行查询，以支持随机访问和枚举。使用 JsonDocument 分析常规 JSON 有效负载并访问其所有成员比使用 Json.NET 快 2-3 倍，且为合理大小（即 < 1 MB ）的数据所分配的量非常少。
JsonDocument 可以处理 Span ，也可以处理 Stream 。
例子：
这里我通过 File .OpenRead 把 json 文件转化为 stream 。然后使用 Json Document.Parse 方法把 stream 解析成 JSON 文档对象模型。
注意，这里我使用了 C# 8 的 using var 语法，这个以后再说。
下面我们开始从这个 JSON 文档对象模型的根节点开始遍历，也就是 RootElement ：
然后通过 root 这个 JsonElement 类型的对象的 GetProperty 方法来获得相应的属性，而且这个方法可以连串使用：
最后一行使用 GetString 方法来获得该属性的字符串值。
然后我们可以写一个递归调用的方法来遍历整个模型的每个属性：
这个方法接受 JsonElement 类型的对象，然后对该元素的属性进行循环。
如果当前属性是另一个对象，那么就继续递归调用这个方法；
否则就输出原始的文本。
最后调用该方法：
输出结果为：
与json文件的内容匹配。
Utf8JsonWriter 类
下面研究一下如何写入json文件。这里需要使用Utf 8JsonWriter 类。
直接看代码：
这个类需要传递的参数类型是 Stream 或者Buffer，也就是向 Stream 或 Buffer 里面写入数据。
那么就提供一个 buffer ：
下面单独写一个方法，来生成json数据：
参数类型是Utf 8JsonWriter 。通过智能提示可以看到它提供了很多用于写入不同类型数据的方法。
写 JSON 对象
现在我想写一个json对象，那么就从Write StartObject () 开始，然后以WriteEnd Object() 结束 :
这样的话，实际上我已经拥有了一个合法的json文档。
写属性和值
可以分开写属性和值：
也可以同时把属性和值写出来：
显示 JSON 数据
我先写这些内容，然后在Main方法里面调用一下：
