Открытый веб-интерфейс для .NET (OWIN) в ASP.NET Core

Авторы: Стив Смит (Steve Smith) и Рик Андерсон (Rick Anderson)

ASP.NET Core:

• поддерживает открытый веб-интерфейс для .NET (OWIN);
• Имеет совместимые замены для библиотек Microsoft.Owin.* (Katana).

OWIN позволяет ослабить зависимость веб-приложений от веб-сервера. Он определяет стандартный способ использования ПО промежуточного в конвейере для обработки запросов и связанных с ними откликов. Приложения ASP.NET Core и ПО промежуточного слоя могут взаимодействовать с приложениями, серверами и ПО промежуточного слоя, основанными на OWIN.

OWIN обеспечивает разделительный уровень, позволяющий совместно использовать две платформы с разнородными объектными моделями. Пакет Microsoft.AspNetCore.Owin содержит две реализации адаптера:

• ASP.NET Core в OWIN
• OWIN в ASP.NET Core

Это позволяет размещать ASP.NET Core поверх сервера или узла, совместимого с OWIN, а также запускать другие совместимые с OWIN компоненты поверх ASP.NET Core.

Просмотреть или скачать образец кода (описание загрузки)

Выполнение ПО промежуточного слоя OWIN в конвейере ASP.NET Core

Поддержка OWIN для ASP.NET Core развертывается в составе пакета Microsoft.AspNetCore.Owin. Вы можете импортировать поддержку OWIN в проект, установив этот пакет.

ПО промежуточного слоя OWIN соответствует спецификации OWIN, где требуется задать интерфейс Func<IDictionary<string, object>, Task> и определенные ключи (такие как owin.ResponseBody). Следующее простое ПО промежуточного слоя OWIN отображает сообщение "Hello World":

public Task OwinHello(IDictionary<string, object> environment)
{
    string responseText = "Hello World via OWIN";
    byte[] responseBytes = Encoding.UTF8.GetBytes(responseText);

    // OWIN Environment Keys: http://owin.org/spec/spec/owin-1.0.0.html
    var responseStream = (Stream)environment["owin.ResponseBody"];
    var responseHeaders = (IDictionary<string, string[]>)environment["owin.ResponseHeaders"];

    responseHeaders["Content-Length"] = new string[] { responseBytes.Length.ToString(CultureInfo.InvariantCulture) };
    responseHeaders["Content-Type"] = new string[] { "text/plain" };

    return responseStream.WriteAsync(responseBytes, 0, responseBytes.Length);
}

Сигнатура примера возвращает Task и принимает IDictionary<string, object>, как того требует OWIN.

Приведенный ниже код показывает, как добавить ПО промежуточного слоя OwinHello (показано выше) в конвейер ASP.NET Core с помощью метода расширения UseOwin.

public void Configure(IApplicationBuilder app)
{
    app.UseOwin(pipeline =>
    {
        pipeline(next => OwinHello);
    });
}

В конвейере OWIN можно настроить и другие действия.

app.UseOwin(pipeline =>
{
    pipeline(next =>
    {
        return async environment =>
        {
            // Do something before.
            await next(environment);
            // Do something after.
        };
    });
});

Среда OWIN

Вы можете создать среду OWIN с помощью HttpContext.

   var environment = new OwinEnvironment(HttpContext);
   var features = new OwinFeatureCollection(environment);

Ключи OWIN

OWIN использует объект IDictionary<string,object> для передачи сведений через систему обмена запросами и откликами HTTP. ASP.NET Core реализует указанные ниже ключи. См. основную спецификацию, расширения, а также статью Рекомендации по ключам OWIN и общие ключи.

Данные запроса (OWIN версии 1.0.0)

Данные запроса (OWIN версии 1.1.0)

Данные отклика (OWIN версии 1.0.0)

Другие данные (OWIN версии 1.0.0)

Общие ключи

SendFiles версии 0.3.0

Непрозрачная версия 0.3.0

WebSocket v0.3.0

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

• См. источник на GitHub для ключей OWIN, поддерживаемых на уровне перевода.
• Middleware
• Servers