Katana概述

OWIN

owin是web services和framework组件之间的抽象。抽象包括两个核心要素：

1. environment dictionary 这个数据结构存储处理HTTP请求必须的状态和相关的服务器状态。定义如下：

    IDictionary<string, object>
   

2. application delegate 服务于OWIN application中所有组件的主主要接口。定义下：

    Func<IDictionary<string, object>, Task>;
   

使用OWIN的例子

安装Microsoft.Owin.Host.SystemWeb包(可以使基于OWIN的应用程序运行在IIS上)

public class Startup
{
   public void Configuration(IAppBuilder app)
   {
      app.Run(context =>
      {
         context.Response.ContentType = "text/plain";
         return context.Response.WriteAsync("Hello World!");
      });
   }
}

安装OwinHost包(使用Katana的HttpListener-base server)

Katana的架构

Host

host负责:

• 管理底层的进程
• 构造OWIN pipline处理请求

目前Katana提供了3中host方式：

1. IIS/ASP.NET 使用HttpModule和HttpHandler的方式，OWIN piplines可以运行在IIS上。需要安装Microsoft.AspNet.Host.SystemWeb NuGet包。

    namespace OWINTest
    {
        public class Startup1
        {
            public void Configuration(IAppBuilder app)
            {
                // 有关如何配置应用程序的详细信息，请访问 http://go.microsoft.com/fwlink/?LinkID=316888
                app.Run(context =>
                {
                    context.Response.ContentType = "text/plain";
                    return context.Response.WriteAsync("Hello, world.");
                });
            }
        }
   
    }
   

2. Custom Host 使用自定义进行进行托管applications

安装Microsoft.Owin.SelfHost包，使用控制台程序作为宿主，运行StartUp1

	namespace Test
	{
	    class Program
	    {
	        static void Main(string[] args)
	        {
	            using (Microsoft.Owin.Hosting.WebApp.Start<Startup1>("http://localhost:9000"))
	            {
	                Console.WriteLine("Press [enter] to quit...");
	                Console.ReadLine();
	            }
	        }
	    }

	}

1. OwinHost.exe 提供了运行app的简单启动方式

Server

server负责打开一个network socket，监听request，通过开发者指定的OWIN pipline(pipline的确定是在application的StartUp类中)发送请求。Katana项目提供了两种实现：

• Microsoft.Owin.Host.SystemWeb：IIS和ASP.NET pipline合作作为host与server。Katana 注册一个HttpModule和HttpHandler拦截请求，发送请求到指定的OWIN pipline

• Microsoft.Owin.Host.HttpListener：使用.NET Framework的HttpListener类打开一个socket，发送请求到指定的OWIN pipline。当前OwinHost.ext和Katana self-host选择它作为默认的server。

Middleware

server接收客户端的请求，通过开发者在StartUp中指定的OWIN组件构成的pipline传递请求。这些pipline组件就是middleware

Applications

OWIN和Katana是一种解耦server和host的编程模型和框架的抽象。当构建一个Web Api应用时，开发者框架继续使用ASP.NET Web API框架，而不用关心应用程序是否运行在使用Katana项目组件构成的OWIN pipline上。与OWIN相关的代码尽在StartUp类中，在此开发者使用UseXX注册一系列的组件，构成OWIN pipline，每个组件处理都进入的请求。这与现在System.Web中的HTTP modules具有相同的效果