Go Academy · レッスン

構造体へのバインディング

Q: 「構造体へのバインディング」で何を学びますか？

設定をアンマーシャルします ブラウザで直接実行するハンズオンコードでGo Academyを演習し、24時間対応のAIチューターがレッスンを進める中での質問に答えます。

設定をアンマーシャルします

「構造体へのバインディング」はCoddyKit上の無料Go Academyレッスンです。これはレッスン4/4です。下記で完全なレッスンを無料で読むことができます。その後、ブラウザ内の組み込みコードエディタと24時間対応のAIチューターでハンズオン演習できます。これはGo Academy学習パスの一部であり、ウェブとCoddyKitアプリ全体で進捗が同期されます。 Go Academyコースには全4レッスンが含まれています。

緩いキーから構造体へ

あちこちでGetStringを呼び出すと、文字列キーがコード全体に散らばります。設定を型付きの構造体にアンマーシャリングすると、フィールド名をコンパイル時に検証でき、構造を確認できる場所も1つになります。

設定構造体の定義

フィールドにmapstructureタグを付けた構造体を宣言し、Viperがどの設定キーをどのフィールドに対応付けるかを知らせます。各フィールドの後には、実際のGoソースではバッククォートで囲んで記述するmapstructure:"host"のようなタグを付けます。

type ServerConfig struct {
    Host string // tag: mapstructure host
    Port int    // tag: mapstructure port
}

type Config struct {
    Server ServerConfig // tag: mapstructure server
    Debug  bool         // tag: mapstructure debug
}

Unmarshalの呼び出し

設定を読み込んだ後、構造体にデコードします。

var cfg Config
if err := viper.Unmarshal(&cfg); err != nil {
    log.Fatalf("unable to decode config: %v", err)
}
fmt.Println(cfg.Server.Port)

jsonではなくmapstructureを使う理由

Viperは、設定がJSONだけでなく、さまざまな形式（YAML、環境変数、TOML）から取得されるため、mapstructureライブラリを使用します。mapstructureタグは形式に依存せず、汎用マップからデコードできます。

1つのサブツリーをアンマーシャリングする

UnmarshalKeyを使うと、1つのセクションだけをデコードできます。

var sc ServerConfig
viper.UnmarshalKey("server", &sc)
fmt.Println(sc.Host, sc.Port)

ネストしたフィールドとスライスのフィールド

mapstructureはネスト構造とスライスを自動的に処理します。

ネストした構造体は、ネストした設定セクションに対応します
[]stringフィールドは、YAMLまたはJSONの配列に対応します

スライスのフィールドには、実際のソースではバッククォートで囲んで記述するmapstructure:"hosts"タグを付けます。

type Config struct {
    Hosts []string // tag: mapstructure hosts
}

構造体フィールドのデフォルト値

キーが存在せず、デフォルト値も設定していない場合、フィールドにはGoのゼロ値（0、空文字列、false）が入ります。構造体へのバインディングとSetDefaultを組み合わせて、妥当な値を保証してください。

デコードした構造体のバリデーション

アンマーシャリング後にバリデーションを行います。一般的な方法は、実現不可能な組み合わせ（ポートが0、ホストが空など）に対してエラーを返すValidate()メソッドを用意することです。

func (c Config) Validate() error {
    if c.Server.Port == 0 {
        return fmt.Errorf("server.port is required")
    }
    return nil
}

デコードエラーには型があります

値がフィールドの型に適合しない場合（int が期待されているのに文字列が指定された場合など）、デコードはそのフィールドを示すエラーを返します。エラーを無視せず、必ず確認して呼び出し元に伝えてください。

encoding/jsonでも同じ考え方

標準ライブラリでも、同じ方法で JSON をデコードできます。明示的な struct タグを付けると型付きフィールドに値が設定され、map を使うと汎用的にアクセスできます。以下の実行可能なコードでは、struct タグなしで実行できるようにネストした map を使用しています。

実行例：ネストした設定のデコード

この自己完結型のプログラムは、ネストした JSON 設定を汎用 map にデコードし、ネストしたフィールドを読み取ります。これは、Unmarshal が struct に値を設定する動作を再現したものです。

package main

import (
    "encoding/json"
    "fmt"
)

func main() {
    raw := "{\"server\":{\"host\":\"localhost\",\"port\":8080},\"debug\":true}"
    var c map[string]any
    if err := json.Unmarshal([]byte(raw), &c); err != nil {
        panic(err)
    }
    srv := c["server"].(map[string]any)
    fmt.Printf("%v:%v debug=%v\n", srv["host"], srv["port"], c["debug"])
}

理解度チェック

設定を struct にバインドする方法について、理解度を確認しましょう。

まとめ

設定を struct にバインドする方法を学びました。

mapstructure タグと viper.Unmarshal(&cfg) を使用する
UnmarshalKey で単一のサブツリーをデコードする
ネストした struct とスライスは自動的にデコードされる
Validate() メソッドを追加して、不正な組み合わせを早期に検出する

よくある質問

「構造体へのバインディング」レッスンは無料ですか？

はい。「構造体へのバインディング」の完全なテキストはこのウェブで無料で読めます。インタラクティブに演習し（組み込みコードエディタと24時間対応のAIチューター）、Go Academyコースの残りをアンロックするには、CoddyKit PROにアップグレードしてください。 Go Academyコースには全4レッスンが含まれています。

「構造体へのバインディング」で何を学びますか？

設定をアンマーシャルしますブラウザで直接実行するハンズオンコードでGo Academyを演習し、24時間対応のAIチューターがレッスンを進める中での質問に答えます。

Go Academyを始めるのに経験は必要ですか？

事前経験は必要ありません。CoddyKitのGo Academyは初級者から上級者向けに構成されているため、ここから始めるか最初から始めて、自分のペースで進むことができます。これはレッスン4/4です。

「構造体へのバインディング」レッスンにはどのくらい時間がかかりますか？

ほとんどのCoddyKitレッスンは約5～10分かかります。各レッスンはコンパクトでインタラクティブなので、着実に進歩し、ウェブとアプリ全体で正確に前回の場所から再開できます。

このGo Academyレッスンでコードを書いて実行できますか？

はい。すべてのGo Academyレッスンに組み込みコードエディタが含まれているため、ブラウザでリアルコードを書いて実行し、即座のAIフィードバックを取得できます。ローカル設定は不要です。

このコースのすべてのレッスン

← Go Academyに戻る