Go Academy · Lekcja

Używanie gorilla/websocket

Uaktualniaj połączenia i obsługuj je

Używanie gorilla/websocket to bezpłatna lekcja Go Academy na CoddyKit. To lekcja 2 z 4. Możesz przeczytać całą lekcję poniżej za darmo — a potem ćwiczyć ją interaktywnie w przeglądarce z wbudowanym edytorem kodu i tutorem AI dostępnym 24/7. To część ścieżki edukacyjnej Go Academy, a Twój postęp synchronizuje się między webem a aplikacją CoddyKit. Kurs Go Academy zawiera 4 lekcji w sumie.

Biblioteka gorilla/websocket

gorilla/websocket to najczęściej używana biblioteka WebSocket dla języka Go. Obsługuje uzgadnianie aktualizacji i udostępnia obiekt połączenia do odczytu oraz zapisu ramek. Należy ją zainstalować poleceniem go get github.com/gorilla/websocket.

import "github.com/gorilla/websocket"

Upgrader

Obiekt Upgrader przekształca żądanie HTTP w połączenie WebSocket. Można w nim skonfigurować rozmiary buforów oraz sprawdzanie źródła żądania.

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

CheckOrigin i bezpieczeństwo

Domyślnie Upgrader odrzuca żądania z innych źródeł. Podczas tworzenia aplikacji można złagodzić tę zasadę, ale w środowisku produkcyjnym należy weryfikować nagłówek Origin, aby zapobiec przejęciu WebSocket przez inną witrynę.

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

Aktualizacja połączenia w handlerze

Wewnątrz funkcji http.HandlerFunc należy wywołać Upgrade. Po pomyślnym wykonaniu otrzymuje się obiekt *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
}

Odczytywanie wiadomości

ReadMessage blokuje wykonanie do momentu nadejścia ramki, po czym zwraca jej typ oraz bajty danych.

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

Zapisywanie wiadomości

WriteMessage wysyła ramkę określonego typu:

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

Pętla echa

Klasyczny przykład odczytuje wiadomość i wysyła ją z powrotem. Pętla kończy się, gdy funkcja Read zwróci błąd (klient został rozłączony).

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

Pomocnicze funkcje JSON

gorilla udostępnia funkcje ReadJSON i WriteJSON, które bezpośrednio serializują wartości Go przez gniazdo, co jest wygodne w przypadku ustrukturyzowanych wiadomości. Pole struktury Msg zawiera w rzeczywistym kodzie źródłowym tag json:"text".

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

Zasada jednego czytelnika i jednego zapisującego

Ważne: pojedyncze połączenie pozwala najwyżej na jednego równoczesnego czytelnika i jednego równoczesnego zapisującego. Jeśli wiele goroutines zapisuje dane, należy użyć mutexu albo kierować wszystkie zapisy przez jedną goroutine (zostanie to omówione w lekcji o rozgłaszaniu).

Rejestrowanie trasy

Podłącz handler tak jak każdą trasę HTTP. Klienci łączą się z adresem ws://host/ws.

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

Wykonywalny przykład: analogia pełnego obiegu JSON

Kod WebSocket wymaga zewnętrznej biblioteki; ten fragment korzystający z biblioteki standardowej odzwierciedla działanie ReadJSON/WriteJSON, deserializując przychodzącą wiadomość do mapy i serializując odpowiedź.

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))
}

Szybkie sprawdzenie

Proszę sprawdzić swoją wiedzę o korzystaniu z gorilla/websocket.

Podsumowanie

Nauczyli się Państwo korzystać z gorilla/websocket:

obiekt Upgrader przeprowadza uzgadnianie; należy weryfikować CheckOrigin
Upgrade zwraca obiekt *websocket.Conn
należy używać ReadMessage/WriteMessage lub pomocniczych funkcji JSON
dla każdego połączenia jednocześnie może działać jeden czytelnik i jeden zapisujący

Często zadawane pytania

Czy lekcja „Używanie gorilla/websocket” jest bezpłatna?

Tak — pełny tekst „Używanie gorilla/websocket” jest dostępny za darmo tutaj w sieci. Aby ćwiczyć ją interaktywnie (wbudowany edytor kodu i tutor AI dostępny 24/7) i odblokować resztę kursu Go Academy, przejdź na CoddyKit PRO. Kurs Go Academy zawiera 4 lekcji w sumie.

Co nauczysz się w „Używanie gorilla/websocket”?

Uaktualniaj połączenia i obsługuj je Ćwiczysz Go Academy z praktycznym kodem, który uruchamiasz bezpośrednio w przeglądarce, a tutor AI dostępny 24/7 odpowiada na Twoje pytania podczas pracy nad lekcją.

Czy potrzebuję doświadczenia, aby zacząć Go Academy?

Nie wymagamy żadnego doświadczenia. Go Academy w CoddyKit jest strukturyzowany dla początkujących i zaawansowanych użytkowników, więc możesz zacząć tutaj lub od początku i uczyć się w swoim tempie. To lekcja 2 z 4.

Ile czasu zajmuje lekcja „Używanie gorilla/websocket”?

Większość lekcji CoddyKit trwa około 5–10 minut. Każda lekcja to mały, interaktywny krok, dzięki czemu robisz systematyczne postępy i zawsze wracasz dokładnie do tego samego miejsca — na webie i w aplikacji.

Czy mogę pisać i uruchamiać kod w tej lekcji Go Academy?

Tak. Każda lekcja Go Academy zawiera wbudowany edytor kodu, więc piszesz i uruchamiasz prawdziwy kod bezpośrednio w przeglądarce i od razu otrzymujesz sprzężenie zwrotne od AI — bez konfiguracji na komputerze.

Wszystkie lekcje w tym kursie

← Powrót do Go Academy