0Pricing
Go Academy · Leçon

Valeurs par défaut et validation

Définir des valeurs par défaut pertinentes

Valeurs par défaut et validation 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.

Définir des valeurs par défaut judicieuses

Un constructeur robuste commence par de bonnes valeurs par défaut, puis permet aux options de les remplacer. Cela évite complètement le piège de la valeur zéro.

Initialiser avant d'appliquer

Construisez la configuration avec ses valeurs par défaut d'abord, puis appliquez les options par-dessus.

package main

import "fmt"

type Server struct {
	Port    int
	Timeout int
}
type Option func(*Server)

func WithPort(p int) Option { return func(s *Server) { s.Port = p } }

func NewServer(opts ...Option) *Server {
	s := &Server{Port: 8080, Timeout: 30}
	for _, o := range opts { o(s) }
	return s
}

func main() {
	fmt.Printf("%+v\n", *NewServer())
	fmt.Printf("%+v\n", *NewServer(WithPort(9000)))
}

Les valeurs par défaut s'appliquent jusqu'à leur remplacement

Un appel sans options produit les valeurs par défaut ; une option ne remplace que le champ qu'elle modifie. Vous bénéficiez ainsi du meilleur des deux approches.

Valider après application

Après avoir appliqué les options, validez la configuration finale et renvoyez une erreur si elle est invalide. Faites renvoyer au constructeur (*T, error).

package main

import (
	"errors"
	"fmt"
)

type Server struct{ Port int }
type Option func(*Server)

func WithPort(p int) Option { return func(s *Server) { s.Port = p } }

func NewServer(opts ...Option) (*Server, error) {
	s := &Server{Port: 8080}
	for _, o := range opts { o(s) }
	if s.Port < 1 || s.Port > 65535 {
		return nil, errors.New("invalid port")
	}
	return s, nil
}

func main() {
	_, err := NewServer(WithPort(99999))
	fmt.Println(err)
}

Valider dans les options

Autre possibilité : les options elles-mêmes peuvent renvoyer une erreur. Le type Option devient alors func(*Config) error.

package main

import (
	"errors"
	"fmt"
)

type Server struct{ Port int }
type Option func(*Server) error

func WithPort(p int) Option {
	return func(s *Server) error {
		if p < 1 {
			return errors.New("port must be positive")
		}
		s.Port = p
		return nil
	}
}

func NewServer(opts ...Option) (*Server, error) {
	s := &Server{Port: 8080}
	for _, o := range opts {
		if err := o(s); err != nil {
			return nil, err
		}
	}
	return s, nil
}

func main() {
	_, err := NewServer(WithPort(-1))
	fmt.Println(err)
}

Quel style de validation choisir

Validez dans les options pour les contrôles propres à chaque réglage ; validez après l'application pour les règles entre champs, par exemple TLS exige un chemin de certificat. Souvent, vous utilisez les deux approches.

Documenter les valeurs par défaut

Documentez toujours chaque valeur par défaut dans le commentaire de documentation du constructeur afin que les utilisateurs sachent ce qu'ils obtiennent lorsqu'ils omettent une option.

Valeurs obligatoires et facultatives

Conservez les valeurs véritablement obligatoires comme paramètres positionnels ; réservez les options à ce qui est réellement facultatif. Ne dissimulez pas une donnée obligatoire derrière une option.

package main

import "fmt"

type Client struct {
	BaseURL string
	Retries int
}
type Option func(*Client)

func WithRetries(n int) Option { return func(c *Client) { c.Retries = n } }

func NewClient(baseURL string, opts ...Option) *Client {
	c := &Client{BaseURL: baseURL, Retries: 3}
	for _, o := range opts { o(c) }
	return c
}

func main() {
	fmt.Printf("%+v\n", *NewClient("https://api"))
}

Combiner les options

Vous pouvez composer plusieurs options en une seule configuration prédéfinie pour les configurations courantes.

package main

import "fmt"

type Server struct{ Port, Timeout int }
type Option func(*Server)

func WithPort(p int) Option    { return func(s *Server) { s.Port = p } }
func WithTimeout(t int) Option { return func(s *Server) { s.Timeout = t } }

func Production() Option {
	return func(s *Server) {
		WithPort(443)(s)
		WithTimeout(60)(s)
	}
}

func NewServer(opts ...Option) *Server {
	s := &Server{Port: 8080, Timeout: 30}
	for _, o := range opts { o(s) }
	return s
}

func main() {
	fmt.Printf("%+v\n", *NewServer(Production()))
}

Bonnes pratiques

  • Commencer par les valeurs par défaut, puis appliquer les options
  • Valider après l'application pour les règles entre champs
  • Conserver les valeurs obligatoires en positionnel
  • Documenter chaque valeur par défaut

Une interface complète et robuste

La combinaison des valeurs par défaut, des options et de la validation vous donne un constructeur flexible, sûr, explicite et facile à étendre.

Vérification rapide

Évaluez vos connaissances des valeurs par défaut et de la validation.

Récapitulatif

Vous avez achevé le modèle des options fonctionnelles.

  • Définir les valeurs par défaut avant d'appliquer les options
  • Valider après l'application, ou dans les options pour les contrôles propres à chaque champ
  • Conserver les valeurs obligatoires en positionnel
  • Composer les options en configurations prédéfinies et documenter les valeurs par défaut

Questions Fréquemment Posées

La leçon « Valeurs par défaut et validation » est-elle gratuite ?

Oui — le texte complet de « Valeurs par défaut et validation » 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 « Valeurs par défaut et validation » ?

Définir des valeurs par défaut pertinentes 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 « Valeurs par défaut et validation » ?

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

  1. Le problème des paramètres nombreux
  2. Fonctions d’options
  3. Construire une API flexible
  4. Valeurs par défaut et validation
← Retour à Go Academy