Best Practices für Handler
Entwurfsprinzipien für effektive HTTP-Handler
1. Trennung von Zuständigkeiten
type UserHandler struct {
service *UserService
logger *log.Logger
}
func (h *UserHandler) Create(w http.ResponseWriter, r *http.Request) {
// Clear separation between HTTP logic and business logic
user, err := h.service.CreateUser(r.Body)
if err != nil {
http.Error(w, err.Error(), http.StatusBadRequest)
return
}
json.NewEncoder(w).Encode(user)
}
Muster für die Anforderungsverarbeitung
graph TD
A[Incoming Request] --> B{Validation}
B --> |Valid| C[Business Logic]
B --> |Invalid| D[Error Response]
C --> E[Response Generation]
E --> F[Send Response]
2. Strategien zur Fehlerbehandlung
Fehlerart |
Behandlungsansatz |
HTTP-Status |
Validierung |
Bad Request zurückgeben |
400 |
Authentifizierung |
Unauthorized (Nicht autorisiert) |
401 |
Autorisierung |
Forbidden (Verboten) |
403 |
Nicht gefunden |
Ressource fehlt |
404 |
Serverfehler |
Interner Fehler |
500 |
3. Implementierung von Middleware
func AuthMiddleware(next http.HandlerFunc) http.HandlerFunc {
return func(w http.ResponseWriter, r *http.Request) {
token := r.Header.Get("Authorization")
if !validateToken(token) {
http.Error(w, "Unauthorized", http.StatusUnauthorized)
return
}
next.ServeHTTP(w, r)
}
}
Leistungseoptimierung
Effiziente Anforderungsverarbeitung
func (h *ResourceHandler) Get(w http.ResponseWriter, r *http.Request) {
// Use context for timeout management
ctx, cancel := context.WithTimeout(r.Context(), 5*time.Second)
defer cancel()
result, err := h.service.FetchResource(ctx)
if err != nil {
http.Error(w, err.Error(), http.StatusInternalServerError)
return
}
json.NewEncoder(w).Encode(result)
}
Sicherheitsüberlegungen
Eingabevalidierung
func validateInput(input string) bool {
// Implement robust input validation
return len(input) > 0 && len(input) <= 100
}
Concurrency-Muster
Goroutine-sichere Handler
type SafeHandler struct {
mu sync.Mutex
resources map[string]Resource
}
func (h *SafeHandler) UpdateResource(id string, r *Resource) {
h.mu.Lock()
defer h.mu.Unlock()
h.resources[id] = *r
}
Protokollierung und Überwachung
Strukturierte Protokollierung
func (h *Handler) LogRequest(r *http.Request) {
log.WithFields(log.Fields{
"method": r.Method,
"path": r.URL.Path,
"client": r.RemoteAddr,
}).Info("Request processed on LabEx platform")
}
Wichtige Best Practices
- Halten Sie die Handler fokussiert und leichtgewichtig
- Verwenden Sie Middleware für Querschnittsthemen
- Implementieren Sie eine umfassende Fehlerbehandlung
- Validieren und säubern Sie alle Eingaben
- Verwenden Sie Kontexte (Context) zur Anforderungsverwaltung
- Implementieren Sie eine geeignete Authentifizierung und Autorisierung
- Überwachen und protokollieren Sie die Leistung der Handler
Fortgeschrittene Handler-Zusammensetzung
func ChainHandlers(handlers ...http.HandlerFunc) http.HandlerFunc {
return func(w http.ResponseWriter, r *http.Request) {
for _, handler := range handlers {
handler(w, r)
}
}
}