דילוג לתוכן המרכזי
מודול 10 · שיעור 5 מתוך 550/50 בקורס~18 min
שיעורי מודול (5/5)

מיני-פרויקט: שרת HTTP

חבילת stdlib net/http מספיקה כדי לבנות שרת HTTP מוכן לייצור: ניתוב, מטפלים, תוכנת ביניים, כיבוי חינני. אין צורך במסגרת. עבור ממשקי API טיפוסיים של REST זה הבסיס.

שלום עולם

Go
package main

import (
    "fmt"
    "net/http"
)

func main() {
    http.HandleFunc("/", func(w http.ResponseWriter, r *http.Request) {
        fmt.Fprintf(w, "hello %s", r.URL.Path[1:])
    })
    if err := http.ListenAndServe(":8080", nil); err != nil {
        panic(err)
    }
}

http.ListenAndServe חוסם ומחזיר רק בשגיאה. nil בתור הארגומנט השני = "השתמש ב-DefaultServeMux".

חתימת המטפל

כל המטפלים חולקים את אותה חתימה:

Go
func(w http.ResponseWriter, r *http.Request)
  • w http.ResponseWriter - פלט: כותרות, קוד סטטוס, גוף.
  • r *http.Request - קלט: שיטה, כתובת אתר, כותרות, גוף, הקשר.

דפוס אופייני:

Go
func ping(w http.ResponseWriter, r *http.Request) {
    if r.Method != http.MethodGet {
        http.Error(w, "method not allowed", http.StatusMethodNotAllowed)
        return
    }
    w.Header().Set("Content-Type", "application/json")
    w.WriteHeader(http.StatusOK) // optional, defaults to 200
    fmt.Fprintln(w, `{"ok":true}`)
}

ניתוב עם ServeMux

*http.ServeMux הוא הנתב הבסיסי. מאז Go 1.22 הוא תומך בתבניות עם פרמטרים של שיטה ונתיב:

Go
mux := http.NewServeMux()
mux.HandleFunc("GET /users/{id}", func(w http.ResponseWriter, r *http.Request) {
    id := r.PathValue("id")
    fmt.Fprintln(w, "user", id)
})
mux.HandleFunc("POST /users", createUser)

http.ListenAndServe(":8080", mux)

לנתבים מתוחכמים יותר (קבוצות, תוכנת ביניים משולבת, רגקס) יש chi, gorilla/mux, gin, echo. הסטדליב מכסה 90% מהמקרים.

כלי ביניים כדקורטור

תוכנת ביניים היא פונקציה func(http.Handler) http.Handler:

Go
func logMW(next http.Handler) http.Handler {
    return http.HandlerFunc(func(w http.ResponseWriter, r *http.Request) {
        start := time.Now()
        next.ServeHTTP(w, r)
        log.Printf("%s %s %s", r.Method, r.URL.Path, time.Since(start))
    })
}

http.ListenAndServe(":8080", logMW(mux))

כדי לשרשר אותם: logMW(authMW(rateLimitMW(mux))). כל תווך מקשט את הבא.

http.Server לשליטה עדינה

http.ListenAndServe(addr, h) הוא קיצור דרך. לזמן קצוב, TLS וכיבוי חינני, עליך להפעיל את http.Server:

Go
srv := &http.Server{
    Addr:              ":8080",
    Handler:           mux,
    ReadHeaderTimeout: 5 * time.Second,
    ReadTimeout:       30 * time.Second,
    WriteTimeout:      30 * time.Second,
    IdleTimeout:       2 * time.Minute,
}
log.Fatal(srv.ListenAndServe())

כיבוי חינני עם הקשר

כאשר התהליך מקבל SIGINT/SIGTERM, אתה רוצה לסיים בקשות בטיסה לפני הסגירה:

Go
ctx, stop := signal.NotifyContext(context.Background(),
    os.Interrupt, syscall.SIGTERM)
defer stop()

srv := &http.Server{Addr: ":8080", Handler: mux}
go func() {
    if err := srv.ListenAndServe(); err != nil && err != http.ErrServerClosed {
        log.Fatal(err)
    }
}()

<-ctx.Done() // wait for the signal

shutdownCtx, cancel := context.WithTimeout(context.Background(), 10*time.Second)
defer cancel()
if err := srv.Shutdown(shutdownCtx); err != nil {
    log.Println("shutdown:", err)
}

srv.Shutdown מפסיק לקבל חיבורים חדשים ומחכה לסיום החיבורים הפעילים (עד המועד האחרון שעבר).

קריאת גוף JSON

Go
type CreateUserReq struct {
    Name string `json:"name"`
}

func createUser(w http.ResponseWriter, r *http.Request) {
    var req CreateUserReq
    if err := json.NewDecoder(r.Body).Decode(&req); err != nil {
        http.Error(w, err.Error(), http.StatusBadRequest)
        return
    }
    // ... use req.Name
    w.WriteHeader(http.StatusCreated)
}

r.Body הוא io.ReadCloser: השרת סוגר אותו אוטומטית, אבל json.NewDecoder אינו קורא מעבר לאובייקט JSON הראשון (שימושי לאימות קלט).

תרגילים

פעילות גופנית#go.m10.l5.e1
ניסיונות: 0טוען...

הרשמה למטפל שלום מסלול '/' usando http.HandleFunc.

טוען עורך...

הפתרון זמין לאחר 3 ניסיונות

פעילות גופנית#go.m10.l5.e2
ניסיונות: 0טוען...

Avvia il server su :8080 con http.ListenAndServe e stampa l'errore se non è nil.

טוען עורך...

הפתרון זמין לאחר 3 ניסיונות

Quiz#go.m10.l5.e3
מוכן

האם יש לך גישה ל-HTTP ב-Go?

Go
func H(???) { ... }
אפשרויות תשובה