Go Academy · Lezione

Hook e scope

Personalizzare le query

Lezione 4 di 413 passaggi

Hook e scope è 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.

Hook e scope

GORM offre due strumenti di personalizzazione: gli hook eseguono automaticamente del codice intorno agli eventi del ciclo di vita, mentre gli scope raggruppano logica di query riutilizzabile. Insieme mantengono pulito e coerente l'accesso ai dati.

Che cosa sono gli hook

Gli hook sono metodi del model che GORM chiama prima o dopo un'operazione: BeforeCreate, AfterCreate, BeforeUpdate, BeforeDelete e altri.

Un hook BeforeCreate

Definisca sul model un metodo con la firma corretta. In questo caso impostiamo un UUID prima dell'inserimento del record.

func (u *User) BeforeCreate(tx *gorm.DB) error {
    u.UUID = uuid.NewString()
    return nil
}

Validazione negli hook

Restituisca un errore da un hook per interrompere l'operazione. GORM esegue il rollback della transazione circostante, quindi i dati non validi non raggiungono mai il database.

func (u *User) BeforeSave(tx *gorm.DB) error {
    if u.Age < 0 {
        return errors.New("age cannot be negative")
    }
    return nil
}

Gli hook vengono eseguiti in una transazione

L'argomento tx *gorm.DB è la transazione utilizzata da GORM. Se scrive dati correlati all'interno di un hook, usi questo tx affinché il commit o il rollback avvenga atomicamente insieme all'operazione principale.

Cosa sono gli scope

Uno scope è una funzione che riceve e restituisce un *gorm.DB e incapsula un frammento di query. È possibile applicarlo con db.Scopes(...) e riutilizzarlo in molte query.

func ActiveUsers(db *gorm.DB) *gorm.DB {
    return db.Where("active = ?", true)
}

Applicazione degli scope

È possibile passare uno o più scope a Scopes. Gli scope si combinano, consentendo di unire dichiarativamente i filtri in una query finale.

db.Scopes(ActiveUsers, Recent).Find(&users)

Un hook eseguibile e la simulazione di uno scope

GORM richiede un database, quindi questo esempio eseguibile simula un hook BeforeCreate e un filtro riutilizzabile simile a uno scope, usando semplici funzioni.

package main

import (
    "errors"
    "fmt"
)

type User struct {
    Name   string
    Age    int
    Active bool
}

func beforeCreate(u *User) error {
    if u.Age < 0 {
        return errors.New("age cannot be negative")
    }
    if u.Name == "" {
        u.Name = "anonymous"
    }
    return nil
}

func activeOnly(users []User) []User {
    var out []User
    for _, u := range users {
        if u.Active {
            out = append(out, u)
        }
    }
    return out
}

func main() {
    u := User{Age: 30, Active: true}
    if err := beforeCreate(&u); err != nil {
        fmt.Println("error:", err)
        return
    }
    fmt.Println("created:", u.Name)
    all := []User{u, {Name: "Lin", Active: false}}
    fmt.Println("active count:", len(activeOnly(all)))
}

Scope per la paginazione

Uno scope comune genera la paginazione a partire dal numero di pagina e incapsula Offset e Limit, così ogni endpoint che restituisce elenchi applica la paginazione allo stesso modo.

func Paginate(page, size int) func(*gorm.DB) *gorm.DB {
    return func(db *gorm.DB) *gorm.DB {
        return db.Offset((page - 1) * size).Limit(size)
    }
}

Hook e logica applicativa

Gli hook centralizzano aspetti trasversali come timestamp, slug e campi di audit. Mantenga la logica di business complessa nei service, non negli hook, così il comportamento rimane prevedibile e facilmente testabile.

Disattivare gli hook

Per le operazioni in blocco è possibile disabilitare gli hook con db.Session(&gorm.Session{SkipHooks: true}). Questo accelera le importazioni di grandi dimensioni, ma salta le validazioni, quindi va usato con cautela.

Verifica rapida

Verifichi la propria conoscenza di hook e scope.

Riepilogo

Ha imparato a usare hook e scope:

  • Gli hook vengono eseguiti attorno agli eventi del ciclo di vita; la restituzione di un errore interrompe l'operazione e annulla la transazione
  • Gli hook vengono eseguiti all'interno della transazione tramite l'argomento tx
  • Gli scope sono funzioni riutilizzabili *gorm.DB applicate con Scopes
  • Utilizzi gli scope per i filtri e la paginazione
  • SkipHooks aggira gli hook nelle operazioni in blocco
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

Domande Frequenti

La lezione «Hook e scope» è gratuita?

Sì — il testo completo di «Hook e scope» è 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 «Hook e scope»?

Personalizzare le query 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 «Hook e scope»?

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

  1. Modelli e AutoMigrate
  2. Operazioni CRUD
  3. Associazioni
  4. Hook e scope
← Torna a Go Academy