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

Steve Smith a Rick Anderson

ASP.NET Core:

• Podporuje rozhraní OWIN (Open Web Interface for .NET).
• Má náhradu za knihovny Microsoft.Owin.* (Katana)kompatibilní s .NET Core.

OWIN umožňuje oddělení webových aplikací od webových serverů. Definuje standardní způsob použití middlewaru v kanálu ke zpracování požadavků a přidružených odpovědí. ASP.NET Core a middleware může spolupracovat s aplikacemi, servery a middlewarem založenými na OWIN.

OWIN poskytuje oddělenou vrstvu, která umožňuje používat dvě architektury s různorodé objektové modely společně. Balíček Microsoft.AspNetCore.Owin poskytuje dvě implementace adaptéru:

• ASP.NET Core do OWIN
• Z OWIN do ASP.NET Core

To umožňuje ASP.NET Core, aby se hostoval nad serverem nebo hostitelem kompatibilním s OWIN nebo aby se ostatní komponenty kompatibilní s OWIN spouštěl nad ASP.NET Core.

Zobrazení nebo stažení ukázkového kódu (stažení)

Spuštění middlewaru OWIN v kanálu ASP.NET Core

ASP.NET součástí balíčku je podpora OWIN Microsoft.AspNetCore.Owin core. Podporu OWIN můžete do svého projektu importovat instalací tohoto balíčku.

Middleware OWIN odpovídá specifikaci OWIN, která vyžaduje rozhraní, a musí být nastaveny konkrétní klíče Func<IDictionary<string, object>, Task> (například owin.ResponseBody ). Následující jednoduchý middleware OWIN zobrazí "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);
}

Vzorový podpis vrátí a Task přijímá , jak vyžaduje IDictionary<string, object> OWIN.

Následující kód ukazuje, jak přidat OwinHello middleware (viz výše) do kanálu ASP.NET Core pomocí UseOwin metody rozšíření.

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

Můžete nakonfigurovat další akce, které se budou provádět v rámci kanálu OWIN.

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

Spuštění ASP.NET Core na serveru založeném na OWIN a použití jeho podpory webSocketů

Dalším příkladem toho, jak lze funkce serverů založených na OWIN využít ASP.NET Core, je přístup k funkcím, jako jsou WebSockety. Webový server .NET OWIN použitý v předchozím příkladu má integrovanou podporu webových soketů, kterou může využít aplikace ASP.NET Core. Následující příklad ukazuje jednoduchou webovou aplikaci, která podporuje webové sokety a vrací všechno odeslané na server prostřednictvím protokolu WebSocket.

public class Startup
{
    public void Configure(IApplicationBuilder app)
    {
        app.Use(async (context, next) =>
        {
            if (context.WebSockets.IsWebSocketRequest)
            {
                WebSocket webSocket = await context.WebSockets.AcceptWebSocketAsync();
                await EchoWebSocket(webSocket);
            }
            else
            {
                await next();
            }
        });

        app.Run(context =>
        {
            return context.Response.WriteAsync("Hello World");
        });
    }

    private async Task EchoWebSocket(WebSocket webSocket)
    {
        byte[] buffer = new byte[1024];
        WebSocketReceiveResult received = await webSocket.ReceiveAsync(
            new ArraySegment<byte>(buffer), CancellationToken.None);

        while (!webSocket.CloseStatus.HasValue)
        {
            // Echo anything we receive
            await webSocket.SendAsync(new ArraySegment<byte>(buffer, 0, received.Count), 
                received.MessageType, received.EndOfMessage, CancellationToken.None);

            received = await webSocket.ReceiveAsync(new ArraySegment<byte>(buffer), 
                CancellationToken.None);
        }

        await webSocket.CloseAsync(webSocket.CloseStatus.Value, 
            webSocket.CloseStatusDescription, CancellationToken.None);
    }
}

Prostředí OWIN

Prostředí OWIN můžete vytvořit pomocí HttpContext .

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

Klíče OWIN

OWIN závisí na objektu pro komunikaci informací prostřednictvím výměny IDictionary<string,object> požadavků a odpovědí HTTP. ASP.NET Core implementuje klíče uvedené níže. Viz primární specifikace, rozšířenía pokyny pro klíče OWIN a běžné klíče.

Data požadavku (OWIN v1.0.0)

Data požadavku (OWIN v 1.1.0)

Data odpovědi (OWIN v 1.0.0)

Jiná data (OWIN v 1.0.0)

Běžné klíče

SendFiles v0.3.0

Neprůhledné v0.3.0

WebSocket v0.3.0

Další zdroje informací

• Middleware
• Servery