ASP.NET Core 支援 OWIN（即 Open Web Server Interface for .NET 的首字母縮寫），OWIN的目標是用於解耦Web Server和Web Application。此外， OWIN為中介軟體定義了一個標準方法用來處理單個請求以及相關聯的響應。ASP.NET Core 的程式和中介軟體可以和 OWIN-based 應用程式、伺服器以及中介軟體相互互動。

章節：

在 ASP.NET 管道中執行 OWIN 中介軟體

ASP.NET Core 對於 OWIN 的支援基於 Microsoft.AspNetCore.Owin 包。你可以在你的應用程式把這個包作為一個依賴匯入到你的 project.json

  "dependencies": {
    "Microsoft.AspNetCore.Server.IISIntegration": "1.0.0",
    "Microsoft.AspNetCore.Server.Kestrel": "1.0.0",
    "Microsoft.AspNetCore.Owin": "1.0.0"                    //手動高亮
  },

OWIN 中介軟體遵循 OWIN 標準， OWIN 標準定義了一系列 Func<IDictionary<string, object>, Task>

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);
}
 

OWIN 最簡單的方法簽名是接收一個 IDictionary<string, object> 輸入引數並且返回 Task 結果。

新增 OWIN 中介軟體到 ASP.NET 管道是最簡單的辦法是使用 UseOwin 擴充套件方法完成。參考上面所示的 OwinHello 方法，將它新增到管道是一個簡單的事情：

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

當然你也可以在 OWIN 管道中配置其他 actions 來替代。

注意
響應頭資訊只能在第一次寫入響應流的時機之前修改。

注意
因為效能原因同時呼叫多個 UseOwin 是不被鼓勵的。 OWIN 元件如果能組合在一起將運作是最好的。

app.UseOwin(pipeline =>
{
    pipeline(next =>
    {
        // do something before
        return OwinHello;
        // do something after
    });
});

在基於 OWIN 的伺服器上宿主 ASP.NET

基於 OWIN 的伺服器可以宿主 ASP.NET 應用程式，Nowin 就是其中之一，一個.NET 的 OWIN Web 伺服器。在本文的例子中，我已經包含一個非常簡單的專案並引用 Nowin 並用它來建立一個能夠自託管 ASP.NET 核心的一個簡單的伺服器。

using System;
using System.Collections.Generic;
using System.Linq;
using System.Net;
using System.Threading.Tasks;
using Microsoft.AspNetCore.Hosting.Server;
using Microsoft.AspNetCore.Hosting.Server.Features;
using Microsoft.AspNetCore.Http.Features;
using Microsoft.AspNetCore.Owin;
using Microsoft.Extensions.Options;
using Nowin;

namespace NowinSample
{
    public class NowinServer : IServer                  //手動高亮
    {
        private INowinServer _nowinServer;
        private ServerBuilder _builder;

        public IFeatureCollection Features { get; } = new FeatureCollection();

        public NowinServer(IOptions<ServerBuilder> options)
        {
            Features.Set<IServerAddressesFeature>(new ServerAddressesFeature());
            _builder = options.Value;
        }

        public void Start<TContext>(IHttpApplication<TContext> application)
        {
            // Note that this example does not take into account of Nowin's "server.OnSendingHeaders" callback.
            // Ideally we should ensure this method is fired before disposing the context. 
            Func<IDictionary<string, object>, Task> appFunc = async env =>
            {
                // The reason for 2 level of wrapping is because the OwinFeatureCollection isn't mutable
                // so features can't be added
                var features = new FeatureCollection(new OwinFeatureCollection(env));

                var context = application.CreateContext(features);
                try
                {
                    await application.ProcessRequestAsync(context);
                }
                catch (Exception ex)
                {
                    application.DisposeContext(context, ex);
                    throw;
                }

                application.DisposeContext(context, null);
            };

            // Add the web socket adapter so we can turn OWIN websockets into ASP.NET Core compatible web sockets.
            // The calling pattern is a bit different
            appFunc = OwinWebSocketAcceptAdapter.AdaptWebSockets(appFunc);

            // Get the server addresses
            var address = Features.Get<IServerAddressesFeature>().Addresses.First();

            var uri = new Uri(address);
            var port = uri.Port;
            IPAddress ip;
            if (!IPAddress.TryParse(uri.Host, out ip))
            {
                ip = IPAddress.Loopback;
            }

            _nowinServer = _builder.SetAddress(ip)
                                    .SetPort(port)
                                    .SetOwinApp(appFunc)
                                    .Build();
            _nowinServer.Start();
        }

        public void Dispose()
        {
            _nowinServer?.Dispose();
        }
    }
}

IServer 是一個需要 Features 屬性和 Start 方法的介面。

Start 的職責是配置和啟動伺服器，在本示例中是通過一系列 fluent API 呼叫IServerAddressesFeature硬編碼伺服器地址來監聽請求。注意 fluent 的 builder 變數指定了請求會被方法 appFunc 所處理。Func 方法在每一個請求被處理前呼叫。

我們同樣會新增 IWebHostBuilder 擴充套件來使得 Nowin 伺服器易於新增和配置。

using System;
using Microsoft.AspNetCore.Hosting.Server;
using Microsoft.Extensions.DependencyInjection;
using Nowin;
using NowinSample;

namespace Microsoft.AspNetCore.Hosting
{
    public static class NowinWebHostBuilderExtensions
    {
        public static IWebHostBuilder UseNowin(this IWebHostBuilder builder)        //手動高亮
        {
            return builder.ConfigureServices(services =>
            {
                services.AddSingleton<IServer, NowinServer>();
            });
        }

        public static IWebHostBuilder UseNowin(this IWebHostBuilder builder, Action<ServerBuilder> configure)
        {
            builder.ConfigureServices(services =>
            {
                services.Configure(configure);
            });
            return builder.UseNowin();
        }
    }
}

上述操作就緒以後，所有的需要使用自定義伺服器執行 ASP.NET 應用程式的設定都在下面的 project.json 檔案的命令中：

using System;
using System.Collections.Generic;
using System.IO;
using System.Linq;
using System.Threading.Tasks;
using Microsoft.AspNetCore.Hosting;

namespace NowinSample
{
    public class Program
    {
        public static void Main(string[] args)
        {
            var host = new WebHostBuilder()
                .UseNowin()                                     //手動高亮
                .UseContentRoot(Directory.GetCurrentDirectory())
                .UseIISIntegration()
                .UseStartup<Startup>()
                .Build();

            host.Run();
        }
    }
}

瞭解更多關於 ASP.NET Servers。

在 OWIN-based 伺服器上執行 ASP.NET Core 並使用 WebSockets 支援

如何基於OWIN的伺服器功能，可以通過ASP.NET核心加以利用另一個例子是獲得像WebSockets的功能。在前面的例子中使用的.NET OWIN Web伺服器具有內建的網路插座，可通過一個ASP.NET的核心應用加以利用的支援。下面的例子顯示了支援網路套接字和簡單的回顯然後直接通過WebSockets傳送到伺服器的任何一個簡單的Web應用程式。

    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);
        }
    }
}

這個 例子 和前一個配置一樣使用相同 NowinServer 唯一的區別是在該應用程式是如何在其 Configure 方法是如何配置的。用 一個簡單的 websocket 客戶端的演示實際效果：

OWIN 鍵值

OWIN 依賴一個 IDictionary<string,object> 物件用來在一個完整的 HTTP 請求/響應互動中通訊資訊。ASP.NET Core 實現所有的 OWIN 規範中列出的要求的必需和可選的以及自身實現的鍵。在OWIN規範不要求任何鍵是可選的，並且可以僅在某些情況下可以使用。 在使用 OWIN 鍵的時候，參閱 OWIN Key Guidelines and Common Keys 是一個好習慣。

請求資料 (OWIN v1.0.0)

請求資料 (OWIN v1.1.0)

響應資料 (OWIN v1.0.0)

其他資料 (OWIN v1.0.0)

通用鍵值

傳送檔案 v0.3.0

Opaque v0.3.0

WebSocket v0.3.0

附錄資源

返回目錄