使用 OWIN 作为 ASP.NET Web API 的宿主

ASP.NET Web API 是一种框架，用于轻松构建可以访问多种客户端（包括浏览器和移动设备）的 HTTP 服务。 ASP.NET Web API 是一种用于在 .NET Framework 上构建 RESTful 应用程序的理想平台。

ASP.NET Web API 是 OWIN 兼容的，因此可以在 OWIN 服务器上运行。

接下来使用 Xamarin Studio 创建一个 OWIN 兼容的 C# 类库，也就是 OWIN 中定义的“应用 (Application)” ，然后在不同的 OWIN 服务器/宿主上运行。

创建 OWIN 兼容的 Web API 类库

打开 Xamarin Studio，新建一个 C# 类库项目，如下图：

然后向项目中添加 Microsoft.AspNet.WebApi.Owin 包，相关依赖的包会自动添加，

最终项目依赖的包如下表，如果没有在 packages.config 文件中列出，可以再次手工添加上去。

Microsoft.AspNet.WebApi.Client
Microsoft.AspNet.WebApi.Core
Microsoft.AspNet.WebApi.Owin
Microsoft.Owin
Newtonsoft.Json
Owin

我们的目的是创建 OWIN 兼容的 Web API 应用，自然要先添加一个 OWIN 约定的 Startup 类，来配置我们的 OWIN 应用。

向项目中添加一个 Startup 类，代码如下:

public class Startup {

    public void Configuration(IAppBuilder appBuilder) {

        // 创建 Web API 的配置

        var config = new HttpConfiguration();

        // 启用标记路由

        config.MapHttpAttributeRoutes();

        // 默认的 Web API 路由

        config.Routes.MapHttpRoute(

            name: "DefaultApi",

            routeTemplate: "api/{controller}/{id}",

            defaults: new { id = RouteParameter.Optional }

        );

        // 将路由配置附加到 appBuilder

        appBuilder.UseWebApi(config);

    }

}

按照 Web API 项目的约定，在项目中添加一个名称为 Controllers 的文件夹，然后新建一个 ValuesController 类，设置其基类为 System.Web.Http.ApiController ，作为示例，其内容与 Visual Studio 自带的 Web API Controller 模板一致，如下所示：

public class ValuesController : ApiController {

    // GET api/values

    public IEnumerable<string> Get() {

        return new string[] { "value1", "value2" };

    }

    // GET api/values/5

    public string Get(int id) {

        return "value";

    }

    // POST api/values

    public void Post([FromBody]string value) {

    }

    // PUT api/values/5

    public void Put(int id, [FromBody]string value) {

    }

    // DELETE api/values/5

    public void Delete(int id) {

    }

}

在 OWIN 环境下运行 Web API

OWIN 目前有兩個比较成熟的服务器：

Katana 微软的 OWIN 服务器，如果没有指定 OWIN 服务器，则作为默认的 OWIN 服务器。
Nowin 社区版 OWIN 服务器，纯 C# 实现，可以运行在 .NET 和 Mono 运行。

使用 Katana 服务器运行

在 Katana 下运行 OWIN 应用是很容易的，新建一个命令行程序项目，项目名称为： Owin02_WebApi_Katana ，然后向项目中添加下面的 NuGet 包：

Microsoft.AspNet.WebApi.Client
Microsoft.AspNet.WebApi.Core
Microsoft.AspNet.WebApi.Owin
Microsoft.AspNet.WebApi.OwinSelfHost
Microsoft.Owin
Microsoft.Owin.Host.HttpListener
Microsoft.Owin.Hosting
Newtonsoft.Json
Owin

在默认的 Program.cs 文件的 Main 方法中，添加下面的代码：

public static void Main(string[] args) {

    var baseAddress = "http://localhost:9000/";

    var startOpts = new StartOptions(baseAddress) {

        // katana http listener

        ServerFactory = "Microsoft.Owin.Host.HttpListener"

    };

    using (WebApp.Start<Owin02_WebApi.Startup>(startOpts)) {

        var client = new HttpClient {

            BaseAddress = new Uri(baseAddress, UriKind.Absolute)

        }; 

        var requestTask = client.GetAsync("api/values");

        requestTask.Wait();

        var response = requestTask.Result;

        Console.WriteLine(response);

        var readTask = response.Content.ReadAsStringAsync();

        readTask.Wait();

        Console.WriteLine(readTask.Result);

        Console.ReadLine();

    }

}

现在运行 Owin02_WebApi_Katana 项目，命令行显示如下：

也可以通过浏览器来访问 http://localhost:9000/api/values ，得到的结果如下：

使用 Nowin 服务器运行

OWIN 兼容的应用可以在任何 OWIN 服务器上运行，下面就看看如何在 Nowin 上运行。

最简单的方法是将上面代码中 StartOptions 的 ServerFactory 属性设置为 Nowin ，然后在添加 Nowin 包就可以运行了：

var baseAddress = "http://localhost:9000/";

var startOpts = new StartOptions(baseAddress) {

    // Nowin

    ServerFactory = "Nowin"

};

不过这样会依赖包 Microsoft.Owin.Hosting ，其实 Nowin 自身也提供了 Hosting 的功能，下面就看如何直接从 Nowin 启动。

新建一个 C# 命令行程序，项目名称为 Owin02_WebApi_Nowin ，添加下面的 NuGet 包：

Microsoft.Owin
Nowin
Owin

向 Program.cs 文件中的 Main 方法添加下面的代码：

public static void Main(string[] args) {

    var appBuilder = new AppBuilder();

    Nowin.OwinServerFactory.Initialize(appBuilder.Properties);

    var startup = new Owin02_WebApi.Startup();

    startup.Configuration(appBuilder);

    var builder = new ServerBuilder();

    var ip = "127.0.0.1";

    var port = 8888;

    builder.SetAddress(System.Net.IPAddress.Parse(ip)).SetPort(port)

        .SetOwinApp(appBuilder.Build())

        .SetOwinCapabilities((IDictionary<string, object>)appBuilder.Properties[OwinKeys.ServerCapabilitiesKey]);

    using (var server = builder.Build()) {

        Task.Run(() => server.Start());

        var baseAddress = "http://" + ip + ":" + port + "/";

        Console.WriteLine("Nowin server listening " + baseAddress);

        var client = new HttpClient {

            BaseAddress = new Uri(baseAddress, UriKind.Absolute)

        }; 

        var requestTask = client.GetAsync("api/values");

        requestTask.Wait();

        var response = requestTask.Result;

        Console.WriteLine(response);

        var readTask = response.Content.ReadAsStringAsync();

        readTask.Wait();

        Console.WriteLine(readTask.Result);

        Console.ReadLine();

    }

}

如果没错的话就可以看到和 Owin02_WebApi_Katans 一致的效果了，而且 Nowin 是开源的纯 .NET 实现，在 Mono 的环境下也可以运行，下面是 Mac 系统下的运行截图：