Go Academy · Pelajaran

Binding ke Struct

Lakukan unmarshal konfigurasi

Binding ke Struct adalah pelajaran Go Academy gratis di CoddyKit. Ini adalah pelajaran 4 dari 4. Kamu bisa membaca pelajaran lengkapnya di bawah secara gratis — lalu praktikkan langsung di browser dengan editor kode bawaan dan tutor AI 24/7. Ini adalah bagian dari jalur belajar Go Academy, dan progresmu tersinkronisasi di web dan aplikasi CoddyKit. Kursus Go Academy mencakup 4 pelajaran total.

Dari Kunci Tersebar ke Struktur

Memanggil GetString di banyak tempat menyebarkan kunci teks ke seluruh kode Anda. Deserialisasi konfigurasi ke dalam struktur bertipe memberi Anda nama bidang saat kompilasi dan satu tempat untuk melihat bentuknya.

Mendefinisikan Struktur Konfigurasi

Deklarasikan sebuah struktur yang bidang-bidangnya memiliki anotasi mapstructure agar Viper mengetahui kunci konfigurasi mana yang dipetakan ke setiap bidang. Setiap bidang diikuti anotasi seperti mapstructure:"host" yang dalam kode sumber Go nyata ditulis di antara tanda petik balik.

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
}

Memanggil Unmarshal

Setelah membaca konfigurasi, dekode konfigurasi tersebut ke dalam struktur Anda:

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

Mengapa mapstructure, Bukan json

Viper menggunakan pustaka mapstructure karena konfigurasi dapat berasal dari banyak format (YAML, lingkungan, dan TOML), bukan hanya JSON. Anotasi mapstructure tidak bergantung pada format dan melakukan dekode dari peta umum.

Mendeserialisasi Satu Subbagian

Anda dapat mendekode hanya satu bagian dengan UnmarshalKey:

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

Bidang Bertingkat dan Irisan

mapstructure menangani struktur bertingkat dan irisan secara otomatis:

Struktur bertingkat dipetakan ke bagian konfigurasi bertingkat
Bidang []string dipetakan ke larik YAML/JSON

Bidang irisan akan memiliki anotasi mapstructure:"hosts" (ditulis di antara tanda petik balik dalam kode sumber nyata).

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

Nilai Bawaan Bidang

Jika sebuah kunci tidak ada dan Anda tidak menetapkan nilai bawaan, bidang tersebut mengambil nilai nol Go (0, teks kosong, false). Gabungkan pengikatan struktur dengan SetDefault untuk menjamin nilai yang wajar.

Memvalidasi Struktur yang Didekode

Setelah deserialisasi, lakukan validasi. Pola yang umum adalah metode Validate() yang mengembalikan galat untuk kombinasi yang tidak mungkin, seperti porta 0 atau host kosong.

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

Kesalahan Dekode Bertipe

Jika suatu nilai tidak dapat ditampung oleh tipe bidangnya (teks ketika yang diharapkan adalah bilangan bulat), proses dekode mengembalikan kesalahan yang menjelaskan bidang tersebut. Selalu periksa dan tampilkan kesalahan itu, bukan mengabaikannya.

Gagasan yang Sama dengan encoding/json

Pustaka standar dapat mendekode JSON dengan cara yang sama. Dengan tag struktur yang eksplisit, pustaka ini mengisi bidang bertipe; dengan peta, Anda mendapatkan akses generik. Contoh yang dapat dijalankan di bawah menggunakan peta bertingkat agar pembaca dapat mengeksekusinya tanpa tag struktur.

Dapat Dijalankan: Dekode Konfigurasi Bertingkat

Program mandiri ini mendekode konfigurasi JSON bertingkat menjadi peta generik dan membaca bidang-bidang bertingkat tersebut, meniru cara Unmarshal mengisi struktur.

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"])
}

Uji Cepat

Uji pemahaman Anda tentang pengikatan konfigurasi ke struktur.

Ringkasan

Anda telah mempelajari cara mengikat konfigurasi ke struktur:

Gunakan tag mapstructure dan viper.Unmarshal(&cfg)
UnmarshalKey mendekode satu subpohon
Struktur bertingkat dan irisan didekode secara otomatis
Tambahkan metode Validate() untuk mendeteksi kombinasi yang salah sejak awal

Pertanyaan yang Sering Diajukan

Apakah pelajaran “Binding ke Struct” gratis?

Ya — teks lengkap “Binding ke Struct” gratis dibaca di sini di web. Untuk praktiknya secara interaktif (editor kode bawaan dan tutor AI 24/7) dan buka sisa kursus Go Academy, upgrade ke CoddyKit PRO. Kursus Go Academy mencakup 4 pelajaran total.

Apa yang akan aku pelajari di “Binding ke Struct”?

Lakukan unmarshal konfigurasi Kamu berlatih Go Academy dengan kode praktik yang langsung kamu jalankan di browser, dan tutor AI 24/7 menjawab pertanyaanmu saat kamu mengerjakan pelajaran ini.

Apakah aku perlu pengalaman untuk memulai Go Academy?

Tidak diperlukan pengalaman sebelumnya. Go Academy di CoddyKit dirancang untuk pemula hingga pelajar tingkat lanjut, jadi kamu bisa memulai di sini atau dari awal dan belajar sesuai kecepatan kamu sendiri. Ini adalah pelajaran 4 dari 4.

Berapa lama pelajaran “Binding ke Struct” memakan waktu?

Sebagian besar pelajaran CoddyKit memakan waktu sekitar 5–10 menit. Setiap pelajaran ringkas dan interaktif, jadi kamu membuat kemajuan stabil dan melanjutkan dari tempat kamu tinggalkan di web dan aplikasi.

Bisakah aku menulis dan menjalankan kode dalam pelajaran Go Academy ini?

Ya. Setiap pelajaran Go Academy menyertakan editor kode bawaan, jadi kamu menulis dan menjalankan kode nyata langsung di browser dan mendapatkan umpan balik AI instan — tidak diperlukan penyiapan lokal.

Semua pelajaran dalam kursus ini

← Kembali ke Go Academy