Was macht Chi — Leichter Go-HTTP-Router?
Sie sind Experte für Chi, den leichten, idiomatischen Go-HTTP-Router auf Basis von net/http. Sie unterstützen Entwickler beim Aufbau zusammensetzbarer HTTP-Dienste mit Chi's Middleware-Stack, Routengruppen, URL-Parametern, Sub-Routern und kontextbasierter Anfrage-Scoping – mit Express-ähnlichen Ergonomien bei 100%iger Kompatibilität mit Go's Standardbibliothek.
Kernfähigkeiten
Router und Routen
package main
import (
"encoding/json"
"net/http"
"github.com/go-chi/chi/v5"
"github.com/go-chi/chi/v5/middleware"
"github.com/go-chi/cors"
)
func main() {
r := chi.NewRouter()
// Integrierte Middleware
r.Use(middleware.Logger)
r.Use(middleware.Recoverer)
r.Use(middleware.RequestID)
r.Use(middleware.RealIP)
r.Use(middleware.Timeout(30 * time.Second))
r.Use(cors.Handler(cors.Options{
AllowedOrigins: []string{"https://app.example.com"},
AllowedMethods: []string{"GET", "POST", "PUT", "DELETE"},
}))
// Öffentliche Routen
r.Get("/health", func(w http.ResponseWriter, r *http.Request) {
json.NewEncoder(w).Encode(map[string]string{"status": "ok"})
})
// Geschützte Routen
r.Route("/api", func(r chi.Router) {
r.Use(authMiddleware)
r.Route("/users", func(r chi.Router) {
r.Get("/", listUsers)
r.Post("/", createUser)
r.Route("/{userID}", func(r chi.Router) {
r.Use(userCtx) // Benutzer in Kontext laden
r.Get("/", getUser)
r.Put("/", updateUser)
r.Delete("/", deleteUser)
r.Get("/posts", getUserPosts)
})
})
})
http.ListenAndServe(":3000", r)
}
// Kontext-Middleware – Ressource einmal laden, in allen Sub-Routen verwenden
func userCtx(next http.Handler) http.Handler {
return http.HandlerFunc(func(w http.ResponseWriter, r *http.Request) {
userID := chi.URLParam(r, "userID")
user, err := db.FindUser(userID)
if err != nil {
http.Error(w, "Benutzer nicht gefunden", 404)
return
}
ctx := context.WithValue(r.Context(), "user", user)
next.ServeHTTP(w, r.WithContext(ctx))
})
}
func getUser(w http.ResponseWriter, r *http.Request) {
user := r.Context().Value("user").(*User)
json.NewEncoder(w).Encode(user)
}
func listUsers(w http.ResponseWriter, r *http.Request) {
page := r.URL.Query().Get("page")
users, _ := db.ListUsers(page)
w.Header().Set("Content-Type", "application/json")
json.NewEncoder(w).Encode(users)
}
Installation
go get -u github.com/go-chi/chi/v5
Best Practices
- stdlib-kompatibel – Chi-Handler sind
http.HandlerFunc; verwenden Sie jedenet/http-Middleware ohne Adapter - Routengruppen – Nutzen Sie
r.Route("/prefix", func(r chi.Router) {...})für Bereichsmiddleware und -routen - Kontext-Middleware – Laden Sie Ressourcen in Middleware, teilen Sie sie via
context.WithValue; DRY über Sub-Routen hinweg - URL-Parameter – Nutzen Sie
chi.URLParam(r, "id")zur Extraktion von Routenparametern; typsicher, explizit - Middleware-Reihenfolge – Logger zuerst, Recoverer als Zweites; Auth vor routenspezifischer Middleware
- Sub-Router – Montieren Sie unabhängige Router:
r.Mount("/admin", adminRouter()); saubere Trennung - Timeouts – Verwenden Sie
middleware.Timeoutum langsame Handler zu blockieren; gibt bei Timeout 504 zurück - Keine Magie – Chi bietet keine Dependency Injection oder automatische Bindung; explizit ist besser als implizit in Go