【C#/RestSharp】再帰処理でRedfish APIをクロールし、全JSONをマージする方法

旅の途中、興味深いオアシスを見つけた。忘れないうちに、この羊皮紙に記しておくとしよう。

前回の旅で、我々はRedfishのモックアップという名の「地図」から、その構造を読み解く魔法を編み出した。しかし、地図はあくまで地図。真の冒険者ならば、本物の遺跡（サーバ）へ赴き、その魂に直接触れたいと思うのが常だろう。

今回は、前回の魔法をさらに進化させ、RestSharpという名の翼を授ける。これにより、我々はファイルという名の書庫から飛び立ち、ネットワークという広大な空を経て、サーバ（BMC）という名の神殿に直接アクセスするのだ。自己署名証明書という結界を突破し、@odata.idという糸を辿って、遺跡の魂の全てを一枚の羊皮紙にマージする。さあ、真の探査の旅が始まる。

この羊皮紙のあらまし

この羊皮紙のあらまし
この羊皮紙が導く者
翼を授ける儀式：RestSharpとの契約
秘儀の全貌：魂をマージする呪文
- 設計図その１：JsonElement
- 設計図その２：Redfish
羊皮紙を巻く前に
砂漠で見つけた魔法のランプ
ラクダの独り言

この羊皮紙が導く者

サーバ（BMC）という名の神殿から、Redfishの情報を一気に引き出したいと願う者
RestSharpという翼を使い、REST APIという大空を自在に飛び回りたい探求者

翼を授ける儀式：RestSharpとの契約

今回の旅の鍵を握るのは、HTTPアクセスを驚くほど簡単にする魔法の道具「RestSharp」だ。

Hello from RestSharp | RestSharp

この翼を使いこなす作法は、極めてシンプルだ。

RestClientという翼を広げる。この時、自己署名証明書という名の結界を無視するため、RemoteCertificateValidationCallbackで「全てを信じる」と誓いを立てる。
RestRequestで行き先（URI）を定め、ExecuteAsyncの呪文で大空へ飛び立つ。
戻ってきたRestResponseという名の伝書バトから、お目当ての情報を受け取る。

秘儀の全貌：魂をマージする呪文

この秘儀の核心は、遺跡の魂（JSON）を読み解き、繋ぎ合わせるための、二つの設計図（クラス）と、それらを操る「再帰の魔法（Readメソッド）」にある。

設計図その１：`JsonElement`

これは、遺跡から得られる魂の欠片、一つ一つの情報を記録するための、最小単位の器だ。

/// <summary>
/// JSONの要素
/// </summary>
class JsonElement
{
    public JsonToken TokenType { get; set; }
    public object? Value { get; set; }
}

設計図その２：`Redfish`

そしてこれが、旅の全てを司る、我々の分身だ。翼（RestClient）を持ち、魂の欠片（JsonElement）を集め、そして再帰の魔法を唱える。

/// <summary>
/// Redfishマージ用
/// </summary>
class Redfish
{
    public RestClient? Client { get; set; }
    public List<JsonElement> Elements { get; set; } = new List<JsonElement>();

    HashSet<JsonToken> JsonTags { get; } = new HashSet<JsonToken>() { JsonToken.StartObject, JsonToken.EndObject, JsonToken.StartArray, JsonToken.EndArray };
    HashSet<string> OdataItems { get; set; } = new HashSet<string>() { "/redfish/v1/" };

    /// <summary>
    /// 全ての魂を再帰的に読み込む
    /// </summary>
    public void Read(string path)
    {
        if (Client == null) return;

        // RestSharpの翼で、遺跡へ直接問いかける
        var request = new RestRequest(path);
        request.AddHeader("Content-Type", "application/json");
        var response = Client.ExecuteAsync(request, Method.Get).Result;
        if (response == null || response.Content == null || response.ResponseUri == null) return;
        Console.WriteLine($"{response.ResponseUri.AbsoluteUri}\n{response.Content}\n");

        // 遺跡からの応答（JSON）を解読し、
        // 新たな「@odata.id」という名の道を見つけたら、
        // 再びこのReadメソッド自身を呼び出し、旅を続ける（再帰）
        var reader = new JsonTextReader(new StringReader(response.Content));
        while (reader.Read())
        {
            var val1 = reader.Value;
            Elements.Add(new JsonElement() { TokenType = reader.TokenType, Value = val1 });

            if (reader.TokenType != JsonToken.PropertyName) continue;
            reader.Read();
            var val2 = reader.Value;
            Elements.Add(new JsonElement() { TokenType = reader.TokenType, Value = val2 });

            if (val1 == null || val2 == null) continue;
            if (JsonTags.Contains(reader.TokenType)) continue;
            if (!((string)val1).Equals("@odata.id")) continue;

            if (!OdataItems.Contains((string)val2))
            {
                OdataItems.Add((string)val2);
                Elements.Add(new JsonElement() { TokenType = JsonToken.PropertyName, Value = "/* @odata.child */" });
                Read((string)val2);
            }
        }
    }
    // ...（Writeメソッドは、集めたElementsをファイルに書き出すだけなので省略）...
}