Как реализовать middleware в Go?

Как реализовать middleware в Go?

• HTTP middleware представляет собой функцию, которая оборачивает http.Handler
• Она принимает http.Handler и возвращает другой http.Handler, добавляя логику до или после запуска основного обработчика
• На практике middleware применяют для логирования, авторизации, обработки ошибок и настройки CORS
• Чаще всего его оформляют как функцию верхнего уровня: func(next http.Handler) http.Handler
• Полученный обработчик выполняет next.ServeHTTP(w, r) в рамках собственной логики
• Несколько middleware объединяют в цепочку, чтобы последовательно обрабатывать запрос и ответ
• Популярные фреймворки, включая Gorilla и Echo, предоставляют встроенную поддержку middleware

Такой подход помогает отделять функциональность, повторно использовать код и гибко, прозрачно организовывать обработку HTTP-запросов.

Подробный ответ

Основной ответ

В Go middleware обычно оформляют как функцию-обёртку над HTTP-хендлером: она принимает http.Handler и возвращает новый http.Handler. Благодаря этому дополнительную логику — например, логирование, аутентификацию или обработку ошибок — можно разместить вокруг основного обработчика, не меняя его исходный код. Этот паттерн широко применяется с пакетом net/http и такими фреймворками, как gin и chi.

Ключевые моменты

• Функции высшего порядка: middleware имеют вид func(http.Handler) http.Handler, поэтому обработчики можно последовательно «оборачивать» друг в друга.
• Контекст выполнения: middleware может изменять запрос, добавлять заголовки, выполнять проверку аутентификации, вести журнал или влиять на формирование ответа.
• Независимость и переиспользуемость: разделение логики на небольшие модули упрощает тестирование и повторное применение middleware.
• В Go для этого стандартно применяются интерфейс http.Handler и метод ServeHTTP(ResponseWriter, *Request), обеспечивающие универсальный подход.

Пример реализации

func loggingMiddleware(next http.Handler) http.Handler {
return http.HandlerFunc(func(w http.ResponseWriter, r *http.Request) {
log.Printf("Request URI: %s", r.RequestURI)
next.ServeHTTP(w, r)
})
}

Пример использования:

http.Handle("/path", loggingMiddleware(myHandler))

Практический контекст

В прикладных проектах, например при использовании Go 1.19 и более новых версий, middleware часто объединяют в цепочку посредством утилит наподобие alice либо встроенных механизмов фреймворка. Так можно гибко выстраивать pipeline обработки запросов и гарантировать, что каждый middleware вызовет следующий и обработает ответ.