JSON から Go へ

関連おすすめ

JSONからGoについて：JSONをGoの強い型付けstructに変換する

ユースケース

• Goバックエンド開発でREST APIレスポンスJSONをstructに変換し、json.Unmarshalを使用してGin/Echo/Fiberハンドラーの入力パラメータに直接バインドする
• フロントエンド・バックエンド連携時にPostmanのサンプルレスポンスJSONからGoモデルを素早く生成し、手書きのフィールド定義を削減する
• サードパーティのWebhookコールバックを連携する際に、ペイロードJSONをGo structに変換してフィールドレベルのアクセスと検証を容易にする
• Viper/Consul/NacosのJSON設定ファイルをGo型に変換し、map[string]interface{}による弱い型付けのアクセスを置き換える
• マイクロサービスチームでgRPC/HTTPインターフェースのリクエスト・レスポンス構造を統一し、サンプルJSONを共有のGo型に変換する
• テストエンジニアがJSONフィクスチャをGo structに変換し、testifyと組み合わせてアサーション駆動テストを行う
• 運用担当者がELK/Fluentdで収集したJSONログ行を解析し、structを生成した後にGoプログラムで構造化分析を行う
• クローラーが取得したJSONデータをGo structに変換し、gorm/genやentと組み合わせてデータベースモデルを生成する
• IoTデバイスから送信されるJSONテレメトリデータをGo structに変換し、エッジゲートウェイプログラムでデシリアライズとフィルタリングを行う
• Kafka/NATS/RabbitMQから消費したJSONメッセージをGo型に変換し、イベント駆動のコンシューマー実装に使用する
• SDK開発者がサーバーのサンプルレスポンスJSONをGo structに変換し、クライアントライブラリのtypesパッケージに書き込んでユーザーが参照できるようにする
• Swagger/OpenAPIドキュメントのサンプルJSONをGo structに変換し、インターフェースドキュメントのコード例として使用する
• 学生や講師がGoのコースでサンプルJSONをstructに変換し、Goの型システムとjsonタグの使用法をデモンストレーションする
• データ移行スクリプトでMySQL/PostgreSQLからエクスポートしたJSON行をGo structに変換し、フィールドマッピングと型検証を行う
• CI/CD設定のJSONをGo structに変換し、Goで記述されたパイプラインツールで設定を強い型付けで読み取れるようにする
• レガシープロジェクトでmapに基づいて動的に読み取られていたJSONコードを、structに基づく強い型付けのアクセスにリファクタリングする

使い方

1. 左側のエディタにJSONコンテンツを貼り付けるか、.json/.txtファイルをドラッグ＆ドロップでアップロードするか、「サンプル」をクリックして内蔵データを読み込みます。
2. 約400ms待つと、ツールは自動的に変換を行い、右側に生成されたGo structコードを表示します。
3. JSONエラーが発生した場合は、「JSONを修復」ボタンをクリックして一般的なフォーマットエラーを自動的に修正し、生成を続行します。
4. 右側の出力を確認し、「コピー」をクリックしてGoプロジェクトに貼り付けるか、「ダウンロード」をクリックしてmodel.goファイルとして保存します。

特徴

• ブラウザローカルでGo structを生成：JSONの解析とGoコードの生成はブラウザ内で完結し、元のデータはサーバーにアップロードされません
• 400msのデバウンスによる自動変換：貼り付けや変更後に手動でクリックする必要はなく、右側にコピー可能なGoコードがリアルタイムで出力されます
• スマートな型推論：文字列はstring、ブール値はbool、整数はint64、浮動小数点はfloat64、配列はスライス、オブジェクトはstructにマッピングされます
• ネストされたオブジェクトを自動展開：再帰的に独立したstruct型を生成し、JSONの階層関係を明確に保ちます
• jsonタグを自動生成：フィールドの後に `json:"元のフィールド名"` タグが付与され、encoding/jsonですぐに使用できます
• JSONエラーをワンクリック修復：末尾のカンマ、シングルクォート、引用符の欠落などの一般的なフォーマットエラーを自動的に処理し、修復後に生成を続行します
• 貼り付け/アップロード/サンプルの3つの入力方法に対応：.json/.txtファイルをドラッグ＆ドロップでアップロードするか、内蔵のサンプルを読み込むことができます
• ワンクリックコピーとダウンロード：Goコード全体をクリップボードにコピーするか、model.goファイルとしてダウンロードしてプロジェクトに直接配置できます
• localStorageによる入力履歴：最近の入力を自動的に保存し、ページを更新したり誤って閉じたりした場合でもすぐに復元できます
• レスポンシブな分割画面エディタ：左右のパネルの幅は調整可能で、デスクトップでもモバイルでも入力と出力を快適に表示できます

コード例

package main

import (
    "encoding/json"
    "fmt"
)

// 以下代码由 GeekFormat JSON 转 Go 工具生成
type User struct {
    ID      int64    `json:"id"`
    Name    string   `json:"name"`
    Tags    []string `json:"tags"`
    Address Address  `json:"address"`
}

type Address struct {
    City string `json:"city"`
}

func main() {
    data := []byte(`{
        "id": 1,
        "name": "Alice",
        "tags": ["admin", "dev"],
        "address": {"city": "Beijing"}
    }`)

    var u User
    if err := json.Unmarshal(data, &u); err != nil {
        panic(err)
    }

    fmt.Println(u.Name, u.Address.City)
}

package main

import "encoding/json"

// 手动将字段改为指针，缺失时值为 nil
type User struct {
    ID      *int64  `json:"id,omitempty"`
    Name    *string `json:"name,omitempty"`
    Email   *string `json:"email,omitempty"`
}

func main() {
    data := []byte(`{"id": 1, "name": "Bob"}`)
    var u User
    json.Unmarshal(data, &u)
    if u.Email == nil {
        println("Email 字段缺失")
    }
}

よくある質問

トラブルシューティング

用語集

struct

Goの複合データ型で、複数のフィールドを1つの型にまとめるために使用されます。このツールが生成するGoコードの主体は、複数のstruct定義です。

slice

Goの動的配列型で、構文は[]Tです。このツールはJSON配列を対応するsliceにマッピングします。例えば[]string、[]int64、[]UserItemなどです。

json tag

Go structフィールドの後のバッククォートで囲まれた文字列で、例えば `json:"user_name"` のようなものです。encoding/jsonによるシリアライズ/デシリアライズ時のフィールド名を指定するために使用されます。このツールはこのタグを自動的に生成します。

interface{}

Goの空のインターフェース型で、任意の値を表すことができます。このツールはJSONのnullに遭遇したり型を特定できない場合に、安全なフォールバックとしてinterface{}を使用します。

PascalCase

各単語の最初の文字を大文字にする命名スタイルで、例えばUserName、AddressCityなどです。Goではエクスポート可能なフィールドは大文字で始まる必要があるため、このツールはJSONフィールド名をPascalCaseに自動的に変換します。

encoding/json

Go標準ライブラリのJSONエンコード/デコードパッケージです。このツールが生成するstructはjsonタグと組み合わせることで、json.Unmarshalとjson.Marshalで直接処理できます。

unmarshal

JSONバイトストリームをGoの値に解析するプロセスです。structを生成した後の最も一般的な使用法は、json.Unmarshal(data, &user)を呼び出すことです。

omitempty

Goのjson tagの一般的なオプションで、例えば `json:"name,omitempty"` のように使用します。フィールドがゼロ値の場合に出力を省略することを示します。このツールはデフォルトでomitemptyを生成しませんが、生成後に必要に応じて手動で追加できます。

JSON型からGo型へのマッピング早見表

このツールはJSON値の型に基づいて対応するGo型を自動的に推論します。一般的なマッピング関係は以下の通りです：

一般的なGo数値型の選択に関する推奨事項

ツールはデフォルトでint64とfloat64を使用します。実際のプロジェクトでは必要に応じて調整できます：

Privacy & Security

このJSONからGoツールのすべての処理はブラウザローカルで完全に実行されます：JSONの解析、型推論、Goコードの生成はすべてWeb Workerを介してクライアント側で実行され、入力されたJSONコンテンツ、アップロードされたファイル、生成されたGoコードがサーバーにアップロードされたり、クラウドに記録、キャッシュ、保存されたりすることはありません。ページを閉じるか更新すると、すべての入力と出力のコンテンツはメモリから自動的に消去され、localStorageにのみ最近の入力履歴が保持されます（いつでも消去できます）。APIキー、トークン、機密性の高いビジネスデータを含むJSONの処理に適しています。