Go Academy · Lezione

Associare agli struct

Eseguire l'unmarshal della configurazione

Lezione 4 di 413 passaggi

Associare agli struct è una lezione Go Academy gratuita su CoddyKit. Questa è la lezione 4 di 4. Puoi leggere la lezione completa qui gratuitamente — poi esercitati direttamente nel browser con un editor di codice integrato e un tutor IA disponibile 24/7. Fa parte del percorso di apprendimento Go Academy, e i tuoi progressi si sincronizzano tra il web e l'app CoddyKit. Il corso Go Academy include 4 lezioni in totale.

Dalle chiavi non tipizzate a una struct

Chiamare GetString ovunque disperde chiavi stringa nel codice. Deserializzare la configurazione in una struct tipizzata fornisce nomi dei campi verificati in fase di compilazione e un unico punto in cui visualizzare la struttura.

Definire una struct di configurazione

Dichiari una struct i cui campi contengano tag mapstructure, così Viper sa quale chiave di configurazione corrisponde a ciascun campo. Ogni campo è seguito da un tag come mapstructure:"host", scritto tra apici inversi nel vero codice sorgente Go.

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
}

Chiamare Unmarshal

Dopo aver letto la configurazione, la si decodifica nella struct:

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

Perché mapstructure, non json

Viper utilizza la libreria mapstructure perché la configurazione può provenire da molti formati, tra cui YAML, variabili d'ambiente e TOML, non solo da JSON. Il tag mapstructure è indipendente dal formato e decodifica i dati a partire da una map generica.

Deserializzare un singolo sottoalbero

È possibile decodificare una sola sezione con UnmarshalKey:

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

Campi annidati e slice

mapstructure gestisce automaticamente i campi annidati e le slice:

Le struct annidate corrispondono a sezioni di configurazione annidate
Un campo []string corrisponde a un array YAML/JSON

Un campo slice conterrebbe un tag mapstructure:"hosts", scritto tra apici inversi nel vero codice sorgente.

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

Valori predefiniti dei campi

Se una chiave è assente e non è stato impostato alcun valore predefinito, il campo assume il valore zero di Go: 0, stringa vuota o false. Combini l'associazione alla struct con SetDefault per garantire valori sensati.

Convalidare la struct decodificata

Dopo la deserializzazione, esegua la convalida. Un modello comune consiste in un metodo Validate() che restituisce un errore per combinazioni impossibili, come port 0 o host vuoto.

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

Gli errori di decodifica sono tipizzati

Se un valore non è compatibile con il tipo del campo, ad esempio una stringa quando è previsto un int, la decodifica restituisce un errore che descrive il campo. Lo verifichi sempre e lo renda visibile invece di ignorarlo.

La stessa idea con encoding/json

La libreria standard può decodificare JSON nello stesso modo. Con tag espliciti per le struct, popola campi tipizzati; con una map, offre un accesso generico. L'esempio eseguibile qui sotto usa una map annidata, così è possibile eseguirlo senza tag per le struct.

Esempio eseguibile: decodifica della configurazione annidata

Questo programma autonomo decodifica una configurazione JSON annidata in una map generica e legge i campi annidati, rispecchiando il modo in cui Unmarshal popola una 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"])
}

Verifica rapida

Metta alla prova la propria comprensione del collegamento della configurazione alle struct.

Rispondi nella lezione interattiva

Riepilogo

Ha imparato a collegare la configurazione alle struct:

Usi i tag mapstructure e viper.Unmarshal(&cfg)
UnmarshalKey decodifica un singolo sottoalbero
Le struct e le slice annidate vengono decodificate automaticamente
Aggiunga un metodo Validate() per rilevare subito le combinazioni non valide

Gratis per iniziare

Impara Go con un tutor IA — gratis

Scrivi ed esegui vero codice nel tuo browser, ricevi aiuto istantaneo da un tutor IA disponibile 24/7, e riprendi da dove hai lasciato sul web o nell'app.

Corsi: 51
Lezioni: 203

Inizia a imparare gratis Visualizza il corso completo

Domande Frequenti

La lezione «Associare agli struct» è gratuita?

Sì — il testo completo di «Associare agli struct» è gratuito qui sul web. Per esercitarvi in modo interattivo (un editor di codice integrato e un tutor IA 24/7) e sbloccare il resto del corso Go Academy, passa a CoddyKit PRO. Il corso Go Academy include 4 lezioni in totale.

Cosa imparerò in «Associare agli struct»?

Eseguire l'unmarshal della configurazione Eserciti Go Academy con codice pratico che esegui direttamente nel browser, e un tutor IA 24/7 risponde alle tue domande mentre lavori sulla lezione.

Ho bisogno di esperienza per iniziare Go Academy?

Non è richiesta alcuna esperienza precedente. Go Academy su CoddyKit è strutturato per principianti e studenti avanzati, quindi puoi iniziare da qui o dall'inizio e procedere al tuo ritmo. Questa è la lezione 4 di 4.

Quanto tempo richiede la lezione «Associare agli struct»?

La maggior parte delle lezioni CoddyKit richiede circa 5–10 minuti. Ogni lezione è breve e interattiva, quindi fai progressi costanti e riprendi esattamente da dove hai lasciato su web e app.

Posso scrivere ed eseguire codice in questa lezione Go Academy?

Sì. Ogni lezione Go Academy include un editor di codice integrato, quindi scrivi ed esegui codice reale direttamente nel tuo browser e ricevi feedback istantaneo dall'IA — nessuna configurazione locale necessaria.

Tutte le lezioni di questo corso

← Torna a Go Academy