Go Academy · Leçon

Modèles de constructeurs

Construire des constructeurs Go idiomatiques

Leçon 3 sur 413 étapes

Modèles de constructeurs est une leçon Go Academy gratuite sur CoddyKit. Ceci est la leçon 3 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.

Pourquoi utiliser des constructeurs ?

Go ne possède pas de mot-clé new pour les types ni de constructeurs de classe. La convention consiste à utiliser une fonction nommée New... qui valide les entrées et renvoie une valeur ou un pointeur initialisé.

Fonction New simple

Renvoyez un pointeur afin que l'appelant travaille avec une instance partagée :

package main
import "fmt"

type Server struct {
    Host string
    Port int
}

func NewServer(host string, port int) *Server {
    return &Server{Host: host, Port: port}
}

func main() {
    s := NewServer("localhost", 8080)
    fmt.Println(s.Host, s.Port)
}

Validation dans les constructeurs

Les constructeurs sont un bon endroit pour valider les entrées et renvoyer une erreur :

package main
import ("errors"; "fmt")

type Config struct{ Workers int }

func NewConfig(workers int) (*Config, error) {
    if workers < 1 {
        return nil, errors.New("workers must be >= 1")
    }
    return &Config{Workers: workers}, nil
}

func main() {
    c, err := NewConfig(4)
    fmt.Println(c, err)
}

Modèle des options fonctionnelles

Le modèle des options fonctionnelles permet une configuration facultative sans modifier l'API :

package main
import "fmt"

type Server struct{ host string; port int; 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 NewServer(host string, opts ...Option) *Server {
    s := &Server{host: host, port: 8080, timeout: 30}
    for _, o := range opts { o(s) }
    return s
}

func main() {
    s := NewServer("localhost", WithPort(9090), WithTimeout(60))
    fmt.Println(s.port, s.timeout)
}

Modèle de construction

Pour les objets complexes, le modèle de construction enchaîne les méthodes de définition et renvoie le résultat :

package main
import "fmt"

type QueryBuilder struct{ table, where string; limit int }

func (q *QueryBuilder) Table(t string) *QueryBuilder { q.table = t; return q }
func (q *QueryBuilder) Where(w string) *QueryBuilder { q.where = w; return q }
func (q *QueryBuilder) Limit(n int)   *QueryBuilder { q.limit = n; return q }
func (q *QueryBuilder) Build() string {
    return fmt.Sprintf("SELECT * FROM %s WHERE %s LIMIT %d", q.table, q.where, q.limit)
}

func main() {
    sql := (&QueryBuilder{}).Table("users").Where("age>18").Limit(10).Build()
    fmt.Println(sql)
}

Renvoyer une valeur ou un pointeur

Renvoyez une valeur lorsque la structure est petite et immuable ; renvoyez un pointeur lorsqu'elle est grande, mutable ou implémente des interfaces :

Petites structures de configuration → valeur
Objets avec état (serveur, client, groupe) → pointeur
Si une interface est implémentée avec des récepteurs pointeurs → pointeur

Modèle des valeurs par défaut

Utilisez une fonction de valeurs par défaut ou un littéral de structure pour définir des valeurs raisonnables avant d'appliquer les options :

package main
import "fmt"

type Cache struct{ maxSize int; ttlSecs int }

func defaultCache() Cache { return Cache{maxSize: 100, ttlSecs: 300} }

func NewCache(opts ...func(*Cache)) *Cache {
    c := defaultCache()
    for _, o := range opts { o(&c) }
    return &c
}

func main() {
    c := NewCache(func(c *Cache) { c.maxSize = 500 })
    fmt.Println(c.maxSize, c.ttlSecs) // 500 300
}

Modèle singleton

Utilisez sync.Once pour initialiser une ressource partagée exactement une fois :

package main
import ("fmt"; "sync")

type DB struct{ DSN string }

var (
    instance *DB
    once     sync.Once
)

func GetDB(dsn string) *DB {
    once.Do(func() { instance = &DB{DSN: dsn} })
    return instance
}

func main() {
    db1 := GetDB("postgres://...")
    db2 := GetDB("ignored")
    fmt.Println(db1 == db2) // true
}

Tester les constructeurs

Les constructeurs qui renvoient des erreurs sont faciles à tester :

package main
import ("errors"; "fmt")

type Pool struct{ size int }

func NewPool(size int) (*Pool, error) {
    if size <= 0 { return nil, errors.New("size must be positive") }
    return &Pool{size: size}, nil
}

func main() {
    _, err := NewPool(-1)
    fmt.Println(err) // size must be positive
    p, _ := NewPool(5)
    fmt.Println(p.size) // 5
}

Éviter l'initialisation automatique

Les fonctions init() s'exécutent automatiquement et sont difficiles à tester. Préférez des constructeurs explicites qui renvoient des erreurs à une initialisation implicite dans init().

Vérification rapide

Quel est le résultat du modèle des options fonctionnelles ?

Réponds-y dans la leçon interactive

Récapitulatif : modèles de constructeurs

À retenir :

Utilisez des fonctions New... comme constructeurs
Renvoyez des erreurs lorsque la validation échoue
Utilisez les options fonctionnelles pour une configuration facultative flexible
Utilisez le modèle de construction pour les objets complexes de requête ou de configuration
Préférez les constructeurs explicites à init()

Exercice pratique

Implémentez un constructeur NewHTTPClient avec des options fonctionnelles. Prenez en charge les options WithTimeout, WithBaseURL et WithMaxRetries.

Gratuit pour commencer

Apprends Go avec un tuteur IA — gratuit

Écris et exécute du vrai code dans ton navigateur, obtiens de l'aide instantanée d'un tuteur IA disponible 24h/24, et reprends là où tu t'es arrêté sur le web ou dans l'app.

Cours: 51
Leçons: 203

Commencer gratuitement Voir le cours complet

Questions Fréquemment Posées

La leçon « Modèles de constructeurs » est-elle gratuite ?

Oui — le texte complet de « Modèles de constructeurs » 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 « Modèles de constructeurs » ?

Construire des constructeurs Go idiomatiques 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 3 sur 4.

Combien de temps prend la leçon « Modèles de constructeurs » ?

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