Функции запросов в ASP.NET Core

Автор: Стив Смит (Steve Smith)

Под API HttpContext, который приложения и промежуточное ПО используют для обработки запросов, находится уровень абстракции, называемый интерфейсами возможностей. Интерфейс каждой функции предоставляет детализированное подмножество функциональности, предоставляемой через HttpContext. Эти интерфейсы можно добавлять, изменять, заключать в оболочки, заменять или даже удалять по требованию сервера или ПО промежуточного слоя по мере обработки запроса, не создавая полностью новую реализацию HttpContext. Их также можно использовать для имитации функций при тестировании.

Коллекции функций

Свойство Features из HttpContext предоставляет доступ к коллекции интерфейсов функций для текущего запроса. Так как коллекция функций является изменяемой даже внутри контекста запроса, ПО промежуточного слоя можно использовать для изменения этой коллекции и добавления поддержки дополнительных функций. Некоторые расширенные функции доступны только при доступе к связанному интерфейсу через коллекцию функций.

Интерфейсы функциональных возможностей

ASP.NET Core определяет в Microsoft.AspNetCore.Http.Features несколько интерфейсов для стандартных функций HTTP, которые являются общими для многих серверов и ПО промежуточного слоя, чтобы отслеживать поддерживаемые ими функции. Серверы и ПО промежуточного слоя могут также предоставлять собственные интерфейсы с дополнительными функциональными возможностями.

Большинство интерфейсов функций поддерживают необязательные облегченные функции, а связанные с ними API HttpContext возвращают варианты по умолчанию, если реализация функции отсутствует. Несколько интерфейсов далее определены как обязательные, так как они реализуют основные функции запросов и ответов, которые необходимы для обработки запроса.

Следующие интерфейсы функций относятся к Microsoft.AspNetCore.Http.Features:

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

IHttpResponseFeature: определяет структуру HTTP-ответа, включая код состояния, заголовки и текст ответа. Эта функция необходима для обработки запросов.

IHttpAuthenticationFeature: содержит объект ClaimsPrincipal, который в настоящее время связан с запросом.

IFormFeature: используется для разбора и кэширования входящих HTTP-запросов и многочастных форм.

IHttpConnectionFeature: определяет свойства идентификатора подключения и локальных и удаленных адресов и портов.

IHttpRequestIdentifierFeature: добавляет свойство, которое можно реализовать для уникальной идентификации запросов.

IHttpRequestLifetimeFeature: определяет поддержку прерывания подключений или обнаружение преждевременного завершения запроса, например отключение клиента.

IHttpUpgradeFeature: определяет поддержку обновлений HTTP, что позволяет клиенту указать дополнительные протоколы, которые требуется использовать, когда серверу нужно сменить протоколы.

IHttpWebSocketFeature: определяет API для поддержки WebSockets.

IItemsFeature: сохраняет коллекцию Items для состояния приложения для каждого запроса.

IQueryFeature: анализирует и кэширует строку запроса.

IRequestCookiesFeature: анализирует и кэширует значения заголовка запроса Cookie .

IResponseCookiesFeature: определяет, как файлы cookie ответа применяются к заголовку Set-Cookie .

IServiceProvidersFeature: предоставляет доступ к IServiceProvider со службами запроса с ограниченной областью действия.

ISessionFeature: определяет абстракции ISessionFactory и ISession для поддержки пользовательских сеансов. ISessionFeature реализуется с помощью SessionMiddleware (см. статью Сеанс в ASP.NET Core).

ITlsConnectionFeature: определяет API для получения сертификатов клиента.

ITlsTokenBindingFeature: определяет методы для работы с параметрами привязки маркера TLS.

Дополнительные ресурсы

• Реализации веб-сервера в ASP.NET Core
• Промежуточное ПО ASP.NET Core