Open Web Interface for .NET (OWIN) と ASP.NET Core

作成者: Steve Smith と Rick Anderson

ASP.NET コア:

• Open Web Interface for .NET (OWIN) をサポートします。
• Microsoft.Owin.* (Katana) ライブラリの .NET Core 互換の代替機能を備えている。

OWIN により、Web アプリを Web サーバーから切り離すことが可能になります。 ミドルウェアをパイプラインで使用し、要求と関連する応答を処理するための標準的な方法を定義します。 ASP.NET Core アプリケーションとミドルウェアは、OWIN ベースのアプリケーション、サーバー、およびミドルウェアと相互運用できます。

OWIN には、さまざまなオブジェクト モデルを使用する 2 つのフレームワークを併用できる分離レイヤーがあります。 Microsoft.AspNetCore.Owin パッケージには 2 つのアダプター実装が用意されています。

• 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 ミドルウェアは、 インターフェイスと特定のキー (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 拡張メソッドを使用して 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 環境

HttpContext を使用して OWIN 環境を構築できます。

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

OWIN キー

OWIN は、HTTP 要求/応答の交換を通じて情報を伝達するために IDictionary<string,object> オブジェクトに依存しています。 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 (英語)

その他の技術情報

• 翻訳レイヤーでサポートされている OWIN キーについては 、GitHub のソース を参照してください。
• ミドルウェア
• サーバー