Опиши шаги обработки HTTP-запроса

Обработка HTTP-запроса в ASP.NET Core: от сетевого стека до контроллера

Обработка HTTP-запроса в ASP.NET Core — это многоэтапный конвейер, известный как Middleware Pipeline (конвейер промежуточного ПО). Каждый запрос проходит через последовательность компонентов, каждый из которых может обработать запрос, передать его дальше или вернуть ответ. Вот основные шаги:

1. Получение запроса и запуск хоста

При запуске приложения инициализируется Kestrel (кросс-платформенный веб-сервер по умолчанию) или другой сервер (IIS, HTTP.sys). Хост настраивает конвейер middleware в Program.cs:

var builder = WebApplication.CreateBuilder(args);
var app = builder.Build();

// Настройка конвейера middleware
app.UseHttpsRedirection();
app.UseAuthentication();
app.UseAuthorization();
app.MapControllers();

app.Run();

2. Конвейер Middleware

Запрос последовательно проходит через зарегистрированные компоненты middleware. Порядок важен! Типичные компоненты:

• Exception Handling Middleware (UseExceptionHandler) — перехватывает исключения на ранних этапах
• Static Files Middleware (UseStaticFiles) — обслуживает статические файлы (CSS, JS, изображения)
• Routing Middleware (UseRouting) — определяет, какой контроллер и действие обработают запрос
• Authentication Middleware (UseAuthentication) — проверяет аутентификацию пользователя
• Authorization Middleware (UseAuthorization) — проверяет права доступа
• Endpoints Middleware (UseEndpoints) — выполняет выбранный endpoint

Пример пользовательского middleware:

app.Use(async (context, next) =>
{
    // Логирование до обработки
    logger.LogInformation($"Request: {context.Request.Path}");
    
    await next(); // Передача следующему middleware
    
    // Логирование после обработки
    logger.LogInformation($"Response: {context.Response.StatusCode}");
});

3. Маршрутизация (Routing)

Маршрутизация сопоставляет URL запроса с конкретным действием контроллера. В ASP.NET Core используется система на основе атрибутов:

[ApiController]
[Route("api/[controller]")]
public class ProductsController : ControllerBase
{
    [HttpGet("{id:int}")] // Обрабатывает GET /api/products/5
    public IActionResult GetProduct(int id)
    {
        // Логика обработки
    }
}

Маршрутизатор анализирует шаблоны, извлекает параметры и выбирает подходящий endpoint.

4. Привязка модели (Model Binding)

Перед вызовом метода действия выполняется Model Binding — процесс преобразования данных запроса (из тела, query-параметров, заголовков) в параметры метода:

[HttpPost]
public IActionResult CreateProduct(
    [FromBody] ProductDto product, // Из тела запроса (JSON)
    [FromQuery] int categoryId,    // Из query string
    [FromHeader] string apiKey)    // Из заголовков
{
    // Все параметры автоматически связаны
}

5. Валидация модели

После привязки выполняется Model Validation с использованием DataAnnotations:

public class ProductDto
{
    [Required]
    [StringLength(100)]
    public string Name { get; set; }
    
    [Range(1, 10000)]
    public decimal Price { get; set; }
}

// В контроллере:
if (!ModelState.IsValid)
{
    return BadRequest(ModelState);
}

6. Выполнение действия контроллера

После успешной валидации вызывается метод действия, который выполняет бизнес-логику:

[HttpPut("{id}")]
public async Task<IActionResult> UpdateProduct(
    int id, 
    [FromBody] ProductDto dto)
{
    var product = await repository.GetByIdAsync(id);
    if (product == null)
        return NotFound();
    
    // Бизнес-логика
    product.Name = dto.Name;
    product.Price = dto.Price;
    
    await repository.UpdateAsync(product);
    return Ok(product);
}

7. Фильтры (Filters)

На разных этапах выполняются фильтры, которые перехватывают выполнение:

• Authorization Filters — проверка прав доступа
• Resource Filters — обработка до/после выполнения
• Action Filters — логика до/после вызова действия
• Exception Filters — обработка исключений
• Result Filters — обработка результатов

Пример фильтра:

public class LogActionFilter : IActionFilter
{
    public void OnActionExecuting(ActionExecutingContext context)
    {
        // До вызова действия
    }
    
    public void OnActionExecuted(ActionExecutedContext context)
    {
        // После вызова действия
    }
}

8. Формирование ответа

Контроллер возвращает IActionResult, который определяет тип ответа:

• Ok(), BadRequest(), NotFound() — стандартные HTTP-ответы
• Json() — JSON-ответ
• File() — файл для скачивания
• View() — представление (в MVC)
• ObjectResult — произвольный объект с сериализацией

9. Обратный проход по конвейеру

Ответ проходит через middleware в обратном порядке, позволяя компонентам выполнить пост-обработку (логирование, кэширование, компрессия).

10. Отправка ответа клиенту

Kestrel сериализует ответ в HTTP-формат и отправляет клиенту через сетевой стек.

Ключевые оптимизации:

• Асинхронная обработка — все этапы поддерживают async/await для масштабирования
• Модель хоста — унифицированная модель для веб-приложений и сервисов
• DI-контейнер — встроенная поддержка зависимостей на всех уровнях
• Модель endpoint — явное определение маршрутов для улучшения производительности

Конвейер ASP.NET Core спроектирован для максимальной гибкости: разработчики могут добавлять, удалять или заменять компоненты, создавая оптимальную конфигурацию для конкретного сценария.