ASP.NET Core 中 .NET 的开放 Web 接口 (OWIN)

作者 ：史蒂夫·史密斯 和 里克·安德森

ASP.NET 核心：

• 支持 .NET 的开放 Web 接口 (OWIN)。
• 具有兼容Microsoft.Owin.*库（Katana）的替代方案。

OWIN 允许 Web 应用从 Web 服务器分离。 它定义了在管道中使用中间件来处理请求和相关响应的标准方法。 ASP.NET Core 应用程序和中间件可以与基于 OWIN 的应用程序、服务器和中间件进行互操作。

OWIN 提供了一个分离层，可一起使用具有不同对象模型的两个框架。 Microsoft.AspNetCore.Owin 包提供了两个适配器实现：

• ASP.NET Core 到 OWIN
• OWIN 到 ASP.NET Core

此方法可将 ASP.NET Core 托管在兼容 OWIN 的服务器/主机上，或在 ASP.NET Core 上运行其他兼容 OWIN 的组件。

查看或下载示例代码 （如何下载）

在 ASP.NET Core 管道中运行 OWIN 中间件

ASP.NET Core 的 OWIN 支持作为 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，并接受 OWIN 所要求的 IDictionary<string, object>。

以下代码显示了如何使用 OwinHello 扩展方法将 UseOwin 中间件（如上所示）添加到 ASP.NET Core 管道。

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 环境

可使用 HttpContext 来构造 OWIN 环境。

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

OWIN 密钥

OWIN 依赖于 IDictionary<string,object> 对象，以在整个 HTTP请求/响应交换中传达信息。 ASP.NET Core 实现以下所列的键。 请参阅 主要规范、扩展和 OWIN 密钥准则和通用密钥。

请求数据 (OWIN v1.0.0)

请求数据 (OWIN v1.1.0)

响应数据 (OWIN v1.0.0)

其他数据 (OWIN v1.0.0)

常用键

SendFiles v0.3.0

不透明 v0.3.0

WebSocket v0.3.0

其他资源

• 请参阅 GitHub 上关于转换层中支持的 OWIN 密钥的源代码。
• Middleware
• Servers