System.Text.Json 再進化 - 透過 DOM 巡覽及編修 JSON 文件

依微軟的計劃，System.Text.Json 應取代 Json.NET，成為 .NET Core/.NET 5+ 奧林匹克指定 JSON 程式庫。System.Text.Json 主打輕巧高效能，但畢竟發展時間尚短，與身經百戰的老將 Json.NET 相比，在功能完整性及可擴充性上仍有點「嫩」。其中我覺得最不便的地方是缺少像 Json.NET 一樣的 JObjec/JArray 物件模型，無法動態巡覽 JSON 屬性或修改內容，更甭提整合 dynamic 動態型別的花式應用。

好消息! .NET 6 起，System.Text.Json 補強了這段，加入 JsonNode、JsonObject、JsonArray、JsonValue 等型別，對映到 Json.NET 的 JToken、JObject、JArray、JValue，允許開發者以物件模型方式建構 JSON 文件，或是將 JSON 文件轉為物件資料結構，進行增刪修改或屬性巡覽，有了這項武器，處理 JSON 文件就更方便了。

多說無益，直接來段威力展示：

using System.Text.Json.Nodes;
using System.Text.Json;

// 建立 JSON
var avatar = new JsonObject {
    ["Id"] = "A001",
    ["Name"] = "Jeffrey",
    ["Extra"] = "Prop To Remove",
    ["Equipments"] = new JsonArray("Shield", "Sword", "Bottle")
};
// 動態指定屬性
avatar["Score"] = 32767;
// 加入物件屬性
avatar["Pet"] = new JsonObject {
    ["Name"] = "Spot",
    ["Exp"] = 255
};
// 移除屬性
avatar.Remove("Extra");
// 對 JsonArray 進行操作
var array = avatar["Equipments"]!.AsArray();
array.Remove(array.Single(o => o?.GetValue<string>() == "Bottle"));
array.Insert(0, "Bag");

var json = avatar.ToJsonString(new JsonSerializerOptions{
    WriteIndented = true
});
Console.ForegroundColor = ConsoleColor.Yellow;
Console.WriteLine(json);

Console.ForegroundColor = ConsoleColor.Blue;
// 由 JSON 還原回 JObject
var restored = JsonNode.Parse(json)!.AsObject();
// 列舉所有屬性
foreach (var prop in restored) {
    var pn = prop.Key;
    // 測試屬性型別
    if (prop.Value is JsonObject) 
        Console.WriteLine($"{pn} is JsonObject");
    else if (prop.Value is JsonArray) 
        Console.WriteLine($"{pn} is JsonArray, length={prop.Value.AsArray().Count()}");
    // 使用 TryGetValue<T> 嘗試取值
    else if (prop.Value?.AsValue().TryGetValue<int>(out var i) ?? false) 
        Console.WriteLine($"{pn} is int: {i}");   
}
Console.ResetColor();

執行結果：

Introduce to the new feature of System.Text.Json, writable DOM API.