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

作者：Steve Smith 和 Rick Anderson

ASP.NET Core：

• 支援 .NET 的開放式 Web 介面 (OWIN)。
• 具有適用於 Microsoft.Owin.* (Katana) 程式庫的 .NET Core 相容取代項目。

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: https://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 Key Guidelines and Common Keys (OWIN 索引鍵指導方針和共用索引鍵)。

要求資料 (OWIN 1.0.0 版)

要求資料 (OWIN 1.1.0 版)

回應資料 (OWIN 1.0.0 版)

其他資料 (OWIN 1.0.0 版)

共同索引鍵

SendFiles 0.3.0 版

Opaque 0.3.0 版

WebSocket 0.3.0 版

其他資源

• 請參閱 GitHub 上的原始程式碼，以了解轉換層支援的 OWIN 金鑰。
• 中介軟體
• 伺服器