Добавление в конвейер с помощью метода Use¶

Для добавления компонентов в конвейер можно использовать метод расширения Use().
Как и в случае с Run(), в методе Use() указывается лямбда-функция, которая выполняется, когда запрос доходит до компонента. В функцию передаются два параметра:

• HttpContext, предоставляющий текущий запрос и ответ;
• указатель на остальную часть конвейера в виде Func<Task>.

Используя указатель, можно контролировать, будет ли выполняться остальная часть конвейера, и, если будет, то когда. Такой подход делает доступным различные сценарии. Например. можно реализовать проверку работоспособности в едином компоненте, а не при помощи ветвления:

public void Configure(IApplication app)
{
    app.Use(async (HttpContext context, Func<Task> next) =>
    {
        if (context.Request.Path.StartsWithSegments("/ping"))
        {
            context.Response.ContentType = "text/plain";
            await context.Response.WriteAsync("pong");
        }
        else
        {
            await next();
        }
    });

    app.UseStaticFiles();
}

Еще один вариант использования Use() — изменение каждого запроса или ответа, проходящего через него. Например, если мы хотим добавлять в каждый ответ некие заголовки безопасности, такие как HSTS (или иные)¹.

Предположим, мы хотим добавить такой заголовок, X-Content-Type-Options: nosniff. Используем метод расширения Use() для перехвата запроса и добавления заголовка в каждый ответ.

public void Configure(IApplicationBuilder app)
{
    app.Use(async (HttpContext context, Func<Task> next) =>
    {
        context.Response.OnStarting(() =>
        {
            context.Response.Headers["X-Content-Type-Options"] = "nosniff";
            return Task.CompletedTask;
        });
        await next();
    });

    app.UseStaticFiles();
    app.UseRouting();
    app.UseEndpoints(endpoints => endpoints.MapControllers());
}

Комментарии

Комментарии