К плану
Урок
0+

Реализация Middleware для сквозной функциональности

В предыдущей теме мы разобрали роутер в Go 1.22+ и научились регистрировать хендлеры. В реальных проектах возникают сквозные задачи: логирование, проверка авторизации или обработка паник. Если копировать этот код в каждый хендлер, проект станет невозможно поддерживать.

Для таких задач используют паттерн Middleware. Если вы писали на React, то уже знакомы с этой концепцией через компоненты высшего порядка (HOC) или Middleware в Redux. В Go это функции, которые принимают http.Handler и возвращают новый, «обернутый» http.Handler.

Анатомия Middleware

В Go функции — это объекты первого класса. Их можно передавать как аргументы и возвращать из других функций. Процесс создания такой обертки называется Handler wrapping.

На Схеме 1 показано, как запрос проходит через слои Middleware до бизнес-логики и возвращается обратно.

Стандартная сигнатура Middleware: func(http.Handler) http.Handler.

Реализуем Middleware для логирования времени запроса. Мы используем замыкание, чтобы вернуть функцию, которая соответствует интерфейсу http.Handler.

func Logger(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 %v", r.Method, r.URL.Path, time.Since(start))
    })
}

Цепочки вызовов (Chaining)

Когда Middleware становится много, их выстраивают в последовательность. Этот процесс называется Chaining. В Go 1.22+ Middleware можно применять ко всему серверу или к группам маршрутов.

Ручное вложение функций делает код нечитаемым:

// Плохо: «ад» из скобок
mux.Handle("/api/users", Logger(Auth(Recover(usersHandler))))

Чтобы избежать нагромождения, используют функции-конструкторы или сторонние библиотеки (например, chi.Chain). Помните: Middleware выполняются в порядке «оборачивания» — внешние слои срабатывают первыми.

Восстановление после сбоев (Recovery)

Если в хендлере случится panic (например, из-за обращения к nil), без защиты упадет весь сервер. Middleware для восстановления использует defer и recover.

Middleware, который перехватывает панику и отдает клиенту 500 ошибку:

func Recovery(next http.Handler) http.Handler {
    return http.HandlerFunc(func(w http.ResponseWriter, r *http.Request) {
        defer func() {
            if err := recover(); err != nil {
                log.Printf("Паника: %v", err)
                http.Error(w, "Internal Server Error", http.StatusInternalServerError)
            }
        }()
        next.ServeHTTP(w, r)
    })
}

Передача данных через Context

Middleware для авторизации часто извлекает ID пользователя из токена. Чтобы передать этот ID в хендлер, используйте r.Context(). Это похоже на React Context, но работает только в рамках одного HTTP-запроса 🧩

type contextKey string
const userIDKey contextKey = "userID"

// В Middleware:
ctx := context.WithValue(r.Context(), userIDKey, 42)
next.ServeHTTP(w, r.WithContext(ctx))

// В хендлере:
userID, ok := r.Context().Value(userIDKey).(int)

Реализуйте Middleware HeaderCheck. Он должен проверять заголовок X-App-Token. Если заголовка нет или он пуст — верните ошибку 403 Forbidden через http.Error и не вызывайте next.ServeHTTP. Если заголовок на месте — пропустите запрос дальше.

Мы научились делать сервисы надежными с помощью Middleware. Но данные в памяти живут недолго. Чтобы приложение приносило пользу, нужно сохранять информацию на диске.

В следующей теме мы перейдем к работе с персистентностью: изучим PostgreSQL, драйвер pgx и управление пулом соединений.

Сохраните прогресс в Telegram.Продолжить в Telegram