複雑な深くネストされたJSONからGo構造体への変換

深くネストされたJSONのGoへの変換

JSONが4レベル以上のネストを持つ場合、生成されるGoコードは読みにくくなることがあります。適切な命名と整理戦略が明確さの維持に役立ちます。

例：クラウドAPIレスポンス

{
  "response": {
    "cluster": {
      "name": "prod-us-1",
      "nodes": [
        {
          "id": "node-a",
          "status": "running",
          "resources": {
            "cpu": { "used": 75.5, "total": 100 },
            "memory": { "used": 8192, "total": 16384 }
          }
        }
      ]
    }
  }
}

生成される構造体階層

type APIResponse struct {
    Response Response `json:"response"`
}

type Response struct {
    Cluster Cluster `json:"cluster"`
}

type Cluster struct {
    Name  string `json:"name"`
    Nodes []Node `json:"nodes"`
}

type Node struct {
    ID        string    `json:"id"`
    Status    string    `json:"status"`
    Resources Resources `json:"resources"`
}

type Resources struct {
    CPU    ResourceUsage `json:"cpu"`
    Memory ResourceUsage `json:"memory"`
}

type ResourceUsage struct {
    Used  float64 `json:"used"`
    Total float64 `json:"total"`
}

深いネストを管理する戦略

1. 可能な限りフラット化 — 一つのリーフ値のみ必要な場合、ヘルパー関数を検討：

func (r *APIResponse) CPUUsage() float64 {
    if len(r.Response.Cluster.Nodes) == 0 {
        return 0
    }
    return r.Response.Cluster.Nodes[0].Resources.CPU.Used
}

2. 共通型を再利用 — ResourceUsage はCPUとメモリの両方に同じ形状を共有するため使用されます。

3. 型ごとに別ファイル — 非常に大きなAPIレスポンスの場合、models パッケージ内で各構造体を個別のファイルに定義します。

4. 中間変数を使用 — 深くネストされたフィールドにアクセスする際、中間構造体をローカル変数に代入して可読性を向上：

node := response.Response.Cluster.Nodes[0]
cpuPercent := node.Resources.CPU.Used / node.Resources.CPU.Total * 100

オプショナルな深いレベルの処理

存在しない可能性のあるネストされたオブジェクトにはポインタを使用：

type Node struct {
    Resources *Resources `json:"resources,omitempty"`
}

これにより、リソースデータのないノードでのnilポインタパニックを防ぎます。