具有 ASP.NET Core 的 Open Web Interface for .NET (OWIN)

由 史蒂夫·史密斯 和 里克·安德森

ASP.NET 核心：

• 支援 .NET 的開放式 Web 介面 (OWIN)。
• 具有與Microsoft.Owin.* (Katana) 程式庫相容的替代方案。

OWIN 可讓 Web 應用程式獨立於網頁伺服器。 它會定義中介軟體要在管線中用來處理要求和相關聯回應的標準方式。 ASP.NET Core 應用程式和中介軟體可以與以 OWIN 為基礎的應用程式、伺服器及中介軟體進行交互操作。

OWIN 提供分離層，可讓兩個利用不同物件模型的架構一起使用。 Microsoft.AspNetCore.Owin 套件提供兩個配接器實作：

• ASP.NET Core 至 OWIN
• OWIN 至 ASP.NET Core

這可讓 ASP.NET Core 裝載在 OWIN 相容的伺服器/主機之上，或讓其他 OWIN 相容的元件在 ASP.NET Core 之上執行。

檢視或下載範例程式代碼 （如何下載）

在 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 1.0.0 版)

要求資料 (OWIN 1.1.0 版)

回應資料 (OWIN 1.0.0 版)

其他資料 (OWIN 1.0.0 版)

常用鍵

發送文件 v0.3.0

不透明 v0.3.0

WebSocket v0.3.0 版

其他資源

• 請參閱轉譯層中支援的 OWIN 金鑰 GitHub 上的來源 。
• Middleware
• Servers