Go Academy · Leçon

Associer la configuration aux structs

Désérialiser la configuration

Associer la configuration aux structs est une leçon Go Academy gratuite sur CoddyKit. Ceci est la leçon 4 sur 4. Tu peux lire la leçon complète ci-dessous gratuitement — puis la pratiquer en direct dans le navigateur avec un éditeur de code intégré et un tuteur IA 24/7. Elle fait partie du parcours d'apprentissage Go Academy, et ta progression se synchronise sur le web et l'application CoddyKit. Le cours Go Academy comprend 4 leçons au total.

Des clés dispersées à une structure

Appeler GetString partout disperse des clés textuelles dans votre code. La désérialisation de la configuration dans une structure typée vous fournit des noms de champs vérifiés à la compilation et un emplacement unique où voir sa structure.

Définir une structure de configuration

Déclarez une structure dont les champs portent des balises mapstructure, afin que Viper sache quelle clé de configuration correspond à chaque champ. Chaque champ est suivi d’une balise telle que mapstructure:"host", écrite entre accents graves dans une véritable source 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
}

Appeler Unmarshal

Après avoir lu la configuration, décodez-la dans votre structure :

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

Pourquoi mapstructure plutôt que json

Viper utilise la bibliothèque mapstructure parce que la configuration peut provenir de nombreux formats, notamment YAML, l’environnement et TOML, et pas uniquement de JSON. La balise mapstructure est indépendante du format et décode les données depuis une table associative générique.

Désérialiser un seul sous-arbre

Vous pouvez décoder une seule section avec UnmarshalKey :

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

Champs imbriqués et tableaux dynamiques

mapstructure gère automatiquement l’imbrication et les tableaux dynamiques :

Les structures imbriquées correspondent à des sections de configuration imbriquées
Un champ []string correspond à un tableau YAML ou JSON

Un champ de type tableau dynamique porterait une balise mapstructure:"hosts", écrite entre accents graves dans une véritable source.

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

Valeurs par défaut des champs

Si une clé est absente et qu’aucune valeur par défaut n’est définie, le champ prend la valeur zéro de Go (0, chaîne vide, false). Combinez l’association à une structure avec SetDefault pour garantir des valeurs cohérentes.

Valider la structure décodée

Après la désérialisation, validez la structure. Un schéma courant consiste à utiliser une méthode Validate() qui renvoie une erreur pour les combinaisons impossibles, comme un port égal à 0 ou un hôte vide.

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

Les erreurs de décodage sont typées

Si une valeur ne peut pas correspondre au type du champ (une chaîne alors qu’un entier est attendu), le décodage renvoie une erreur qui décrit le champ. Vérifiez-la toujours et signalez-la au lieu de l’ignorer.

La même idée avec encoding/json

La bibliothèque standard peut décoder du JSON de la même manière. Avec des balises de structure explicites, elle remplit des champs typés ; avec une carte, elle vous donne un accès générique. L’exemple exécutable ci-dessous utilise une carte imbriquée afin que l’apprenant puisse l’exécuter sans balises de structure.

Exécutable : décoder une configuration imbriquée

Ce programme autonome décode une configuration JSON imbriquée dans une carte générique et lit les champs imbriqués, en reproduisant la manière dont Unmarshal remplit une structure.

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

Vérification rapide

Vérifiez votre compréhension de la liaison d’une configuration à des structures.

Récapitulatif

Vous avez appris à lier une configuration à des structures :

Utilisez les balises mapstructure et viper.Unmarshal(&cfg)
UnmarshalKey décode un sous-arbre unique
Les structures imbriquées et les tranches sont décodées automatiquement
Ajoutez une méthode Validate() pour détecter rapidement les combinaisons incorrectes

Questions Fréquemment Posées

La leçon « Associer la configuration aux structs » est-elle gratuite ?

Oui — le texte complet de « Associer la configuration aux structs » est gratuit à lire ici sur le web. Pour la pratiquer de manière interactive (un éditeur de code intégré et un tuteur IA 24/7) et déverrouiller le reste du cours Go Academy, passe à CoddyKit PRO. Le cours Go Academy comprend 4 leçons au total.

Qu'est-ce que j'apprendrai dans « Associer la configuration aux structs » ?

Désérialiser la configuration Tu pratiques Go Academy avec du code pratique que tu exécutes directement dans le navigateur, et un tuteur IA 24/7 répond à tes questions au fur et à mesure que tu avances dans la leçon.

Dois-je avoir de l'expérience pour commencer Go Academy ?

Aucune expérience préalable n'est requise. Go Academy sur CoddyKit est structuré pour les débutants jusqu'aux apprenants avancés, donc tu peux commencer ici ou depuis le début et avancer à ton rythme. Ceci est la leçon 4 sur 4.

Combien de temps prend la leçon « Associer la configuration aux structs » ?

La plupart des leçons CoddyKit prennent environ 5–10 minutes. Chacune est courte et interactive, tu progresses régulièrement et tu repiques exactement où tu t'es arrêté sur le web et l'app.

Peux-tu écrire et exécuter du code dans cette leçon Go Academy ?

Oui. Chaque leçon Go Academy inclut un éditeur de code intégré, tu écris et exécutes du vrai code directement dans ton navigateur et tu reçois des retours IA instantanés — aucune configuration locale requise.

Toutes les leçons de ce cours

← Retour à Go Academy