Go Academy · Lezione

Usare gorilla/websocket

Aggiornare e gestire le connessioni

Usare gorilla/websocket è una lezione Go Academy gratuita su CoddyKit. Questa è la lezione 2 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.

La libreria gorilla/websocket

gorilla/websocket è la libreria WebSocket per Go più utilizzata. Gestisce l'handshake di upgrade e fornisce un oggetto connessione per leggere e scrivere frame. La installi con go get github.com/gorilla/websocket.

import "github.com/gorilla/websocket"

L'Upgrader

Un Upgrader trasforma una richiesta HTTP in una connessione WebSocket. È possibile configurare le dimensioni dei buffer e un controllo dell'origine.

var upgrader = websocket.Upgrader{
    ReadBufferSize:  1024,
    WriteBufferSize: 1024,
}

CheckOrigin e sicurezza

Per impostazione predefinita, Upgrader rifiuta le richieste provenienti da un'origine diversa. Durante lo sviluppo è possibile allentare questo controllo, ma in produzione è necessario validare l'header Origin per impedire il dirottamento di WebSocket tra siti.

upgrader.CheckOrigin = func(r *http.Request) bool {
    return r.Header.Get("Origin") == "https://myapp.com"
}

Eseguire l'upgrade in un handler

All'interno di un http.HandlerFunc, chiami Upgrade. In caso di successo, ottiene un *websocket.Conn.

func wsHandler(w http.ResponseWriter, r *http.Request) {
    conn, err := upgrader.Upgrade(w, r, nil)
    if err != nil {
        return
    }
    defer conn.Close()
    // read/write loop here
}

Leggere i messaggi

ReadMessage si blocca finché non arriva un frame e restituisce il tipo di messaggio insieme ai byte del payload.

mt, data, err := conn.ReadMessage()
if err != nil {
    return // client closed or error
}
fmt.Printf("got %d bytes\n", len(data))
_ = mt

Scrivere i messaggi

WriteMessage invia un frame di un determinato tipo:

err := conn.WriteMessage(websocket.TextMessage, []byte("hello"))
if err != nil {
    return
}

Il ciclo echo

Un esempio classico legge un messaggio e lo riscrive. Il ciclo termina quando Read restituisce un errore, cioè quando il client si disconnette.

for {
    mt, msg, err := conn.ReadMessage()
    if err != nil {
        break
    }
    conn.WriteMessage(mt, msg)
}

Helper JSON

gorilla fornisce ReadJSON e WriteJSON per serializzare direttamente i valori Go tramite il socket, una soluzione pratica per i messaggi strutturati. Il campo della struttura Msg contiene il tag json:"text" nel codice sorgente reale.

type Msg struct {
    Text string // tag: json text
}
var m Msg
conn.ReadJSON(&m)
conn.WriteJSON(Msg{Text: "ack"})

Regola: un lettore, uno scrittore

Importante: una singola connessione consente un solo lettore concorrente e un solo scrittore concorrente. Se più goroutine scrivono, protegga le scritture con un mutex oppure le convogli attraverso un'unica goroutine (argomento trattato nella sezione sul broadcasting).

Registrare la route

Colleghi l'handler come una normale route HTTP. I client si connettono a ws://host/ws.

http.HandleFunc("/ws", wsHandler)
http.ListenAndServe(":8080", nil)

Eseguibile: analogia del round trip JSON

Il codice WebSocket richiede la libreria esterna; questo frammento basato sulla libreria standard riproduce il comportamento di ReadJSON/WriteJSON, eseguendo l'unmarshaling di un messaggio in ingresso in una mappa e il marshaling di una risposta.

package main

import (
    "encoding/json"
    "fmt"
)

func main() {
    in := []byte("{\"text\":\"ping\"}")
    var m map[string]string
    json.Unmarshal(in, &m)
    reply, _ := json.Marshal(map[string]string{"text": m["text"] + "-ack"})
    fmt.Println(string(reply))
}

Verifica rapida

Verifichi la propria comprensione dell'utilizzo di gorilla/websocket.

Riepilogo

Ha imparato a utilizzare gorilla/websocket:

Un Upgrader esegue l'handshake; convalidi CheckOrigin
Upgrade restituisce un *websocket.Conn
Utilizzi ReadMessage/WriteMessage oppure gli helper JSON
Una connessione può avere un lettore e uno scrittore alla volta

Domande Frequenti

La lezione «Usare gorilla/websocket» è gratuita?

Sì — il testo completo di «Usare gorilla/websocket» è 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 «Usare gorilla/websocket»?

Aggiornare e gestire le connessioni 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 2 di 4.

Quanto tempo richiede la lezione «Usare gorilla/websocket»?

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

← Torna a Go Academy