Зачем нужен Middleware?

Роль Middleware в конвейере обработки запросов

Middleware — это фундаментальная архитектурная концепция в современных веб-фреймворках, включая ASP.NET Core, которая представляет собой цепочку компонентов, обрабатывающих HTTP1запрос и ответ. Каждый middleware компонент может:

• Обрабатывать входящий запрос перед передачей следующему компоненту
• Обрабатывать исходящий ответ после выполнения последующих компонентов
• Принимать решение о прерывании конвейера (short-circuiting)

Ключевые цели использования Middleware

1. Модульность и композиция

Middleware позволяет разбить сложную логику обработки запросов на независимые, переиспользуемые компоненты:

// Пример регистрации middleware в Program.cs
app.UseAuthentication();    // Аутентификация
app.UseAuthorization();     // Авторизация
app.UseRouting();           // Маршрутизация
app.UseEndpoints(...);      // Конечные точки

Каждый компонент решает одну задачу, что соответствует принципу единой ответственности (SRP).

2. Гибкость конвейера обработки

Порядок middleware критически важен и полностью настраиваем:

// Правильный порядок (пример)
app.UseExceptionHandler();  // Обработка исключений - первый!
app.UseHttpsRedirection();
app.UseStaticFiles();       // Статические файлы до аутентификации
app.UseAuthentication();
app.UseAuthorization();
app.UseCustomMiddleware();  // Кастомная логика

3. Cross-Cutting Concerns (Сквозная функциональность)

Middleware идеален для реализации функциональности, необходимой многим компонентам:

• Логирование и мониторинг
• Обработка исключений и ошибок
• Кэширование HTTP-ответов
• Сжатие данных (gzip, brotli)
• Валидация запросов
• Корс-политики (CORS)

Техническая реализация в ASP.NET Core

Базовая структура Middleware

public class CustomMiddleware
{
    private readonly RequestDelegate _next;
    
    public CustomMiddleware(RequestDelegate next)
    {
        _next = next;
    }
    
    public async Task InvokeAsync(HttpContext context)
    {
        // Логика ДО выполнения следующего middleware
        LogRequest(context);
        
        await _next(context); // Вызов следующего компонента
        
        // Логика ПОСЛЕ выполнения следующего middleware
        LogResponse(context);
    }
}

Методы расширения для удобной регистрации

public static class CustomMiddlewareExtensions
{
    public static IApplicationBuilder UseCustomMiddleware(
        this IApplicationBuilder builder)
    {
        return builder.UseMiddleware<CustomMiddleware>();
    }
}

Практические сценарии использования

Аутентификация и авторизация

// Конвейер проверяет credentials и права доступа
app.UseAuthentication();
app.UseAuthorization();

Обработка исключений

// Глобальный перехват ошибок
app.UseExceptionHandler("/error");

Логирование и метрики

app.Use(async (context, next) =>
{
    var stopwatch = Stopwatch.StartNew();
    await next();
    stopwatch.Stop();
    
    logger.LogInformation($"Request took {stopwatch.ElapsedMilliseconds}ms");
});

Кэширование статических файлов

app.UseStaticFiles(new StaticFileOptions
{
    OnPrepareResponse = ctx =>
    {
        ctx.Context.Response.Headers["Cache-Control"] = "public,max-age=3600";
    }
});

Преимущества подхода Middleware

1. Тестируемость — каждый компонент изолирован и легко тестируется
2. Повторное использование — middleware можно打包ить в NuGet пакеты
3. Производительность — минимальные накладные расходы благодаря pipeline
4. Прозрачность — явный порядок обработки в конфигурации
5. Гибкость — возможность ветвления логики на основе условий

Отличие от фильтров (Filters)

Важно различать:

• Middleware — работает на уровне HTTP-конвейера, до маршрутизации
• Фильтры — применяются к конкретным контроллерам/действиям, после маршрутизации

// Middleware срабатывает для ВСЕХ запросов
app.UseMiddleware<GlobalLoggingMiddleware>();

// Фильтры применяются к выбранным контроллерам
[ServiceFilter(typeof(AuditActionFilter))]
public class AccountController : Controller

Эволюция в .NET 6+ и Minimal APIs

В современных версиях ASP.NET Core middleware стал еще лаконичнее:

var app = builder.Build();

app.UseHttpsRedirection();
app.UseAuthorization();

app.MapGet("/api/users", () => 
{
    // Endpoint middleware автоматически применяется
    return Results.Ok(users);
});

app.Run();

Заключение

Middleware — это не просто технический механизм, а философия построения модульных, поддерживаемых и масштабируемых веб-приложений. Он обеспечивает:

• Четкое разделение ответственности между компонентами
• Предсказуемый поток выполнения через явный конвейер
• Упрощенное внедрение сквозной функциональности
• Легкую отладку и мониторинг благодаря поэтапной обработке

Именно middleware делает ASP.NET Core одним из самых производительных и гибких фреймворков для создания современных веб-приложений и API.