Go Academy · Lezione

Fondamenti della catena middleware HTTP

Avvolgere http.Handler e concatenare gli handler con next

Fondamenti della catena middleware HTTP è una lezione Go Academy gratuita su CoddyKit. Questa è la lezione 1 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.

Middleware in net/http

Nella libreria standard di Go, un middleware è una funzione che accetta un http.Handler e restituisce un nuovo http.Handler con un comportamento aggiuntivo applicato attorno all'originale.

type Middleware func(http.Handler) http.Handler

Middleware di base

La funzione HandlerFunc interna avvolge il gestore originale con una logica pre/post:

func Logger(next http.Handler) http.Handler {
    return http.HandlerFunc(func(w http.ResponseWriter, r *http.Request) {
        log.Printf("→ %s %s", r.Method, r.URL.Path)
        next.ServeHTTP(w, r)
        log.Printf("← %s %s done", r.Method, r.URL.Path)
    })
}

Applicazione del middleware

Avvolga i gestori prima di registrarli nel mux:

mux := http.NewServeMux()
mux.Handle("/api/", Logger(Auth(apiHandler)))
http.ListenAndServe(":8080", mux)

Helper per la catena di middleware

Una funzione chain applica più middleware in un ordine leggibile, da sinistra a destra:

func Chain(h http.Handler, ms ...func(http.Handler) http.Handler) http.Handler {
    for i := len(ms)-1; i >= 0; i-- { h = ms[i](h) }
    return h
}
// Usage: Chain(handler, Logger, Auth, RateLimit)

Contesto nel middleware

Colleghi valori associati alla richiesta creando un contesto derivato e avvolgendo la richiesta:

func RequestID(next http.Handler) http.Handler {
    return http.HandlerFunc(func(w http.ResponseWriter, r *http.Request) {
        id := uuid.New().String()
        ctx := context.WithValue(r.Context(), reqIDKey, id)
        w.Header().Set("X-Request-ID", id)
        next.ServeHTTP(w, r.WithContext(ctx))
    })
}

Wrapper per il writer della risposta

Acquisisca il codice di stato scritto da un gestore avvolgendo il ResponseWriter:

type captureWriter struct {
    http.ResponseWriter
    status int
}
func (cw *captureWriter) WriteHeader(code int) {
    cw.status = code
    cw.ResponseWriter.WriteHeader(code)
}

Middleware per il recupero dai panic

Recuperi dai panic per impedire l'arresto anomalo del server:

func Recovery(next http.Handler) http.Handler {
    return http.HandlerFunc(func(w http.ResponseWriter, r *http.Request) {
        defer func() {
            if rec := recover(); rec != nil {
                http.Error(w, "Internal Server Error", 500)
            }
        }()
        next.ServeHTTP(w, r)
    })
}

L'ordine è importante

Il middleware viene eseguito nell'ordine in cui avvolge il gestore. Recovery dovrebbe essere il livello più esterno (e avvolgere tutto). Auth deve precedere la logica di business. Logging è solitamente all'esterno, dopo Recovery.

Compatibilità con router di terze parti

Poiché il middleware segue la firma standard func(http.Handler) http.Handler, è compatibile con chi, gorilla/mux e qualsiasi router che accetti http.Handler.

Globale rispetto a specifico per la route

Applichi il middleware globalmente all'intero mux oppure avvolga singoli gestori per un comportamento specifico per la route. I subrouter di chi rendono più semplice applicare il middleware a livello di gruppo.

Test del middleware

Utilizzi httptest.NewRecorder e httptest.NewRequest per testare il middleware in isolamento senza avviare un server reale.

w := httptest.NewRecorder()
r := httptest.NewRequest("GET", "/", nil)
Logger(http.HandlerFunc(noop)).ServeHTTP(w, r)

Verifica rapida

Qual è la firma standard del middleware net/http?

Riepilogo: catena di middleware

Punti chiave:

func(http.Handler) http.Handler è la firma standard
Utilizzi un helper Chain per evitare annidamenti profondi
r.WithContext(ctx) per collegare valori; avvolga il writer per registrare lo stato
Recovery all'esterno; Auth prima della logica di business; Logging dopo Recovery

Domande Frequenti

La lezione «Fondamenti della catena middleware HTTP» è gratuita?

Sì — il testo completo di «Fondamenti della catena middleware HTTP» è 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 «Fondamenti della catena middleware HTTP»?

Avvolgere http.Handler e concatenare gli handler con next 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 1 di 4.

Quanto tempo richiede la lezione «Fondamenti della catena middleware HTTP»?

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

Fondamenti della catena middleware HTTP
Middleware per logging e ID della richiesta
Middleware per autenticazione e limitazione della frequenza
Middleware CORS e recupero dai panic

← Torna a Go Academy