OWIN与Katana

Posted *Hunter

tags:

篇首语:本文由小常识网(cha138.com)小编为大家整理,主要介绍了OWIN与Katana相关的知识,希望对你有一定的参考价值。

一、OWIN

二、Katana

三、Middleware中间件

一、OWIN

1,OWIN介绍

OWIN是Open Web Server Interface for .Net的首字母缩写。OWIN在.Net Web Server与Web Application之间定义了一套标准接口。OWIN的目标用于解耦Web Server与Web Application。OWIN只是一个契约、规范,而非代码的实现(Katana实现了OWIN)

2,OWIN规范

1)OWIN定义了Host、Server、Middleware、Application四层

①Host:主要负责应用程序的配置和启动进程,包括初始化OWIN Pipeline(管道,包含了Middleware)、运行Server

②Server:绑定套接字并监听Http请求,然后将Request和Response的Body、Header封装成符合OWIN规范的字典并发送到OWIN Middleware Pipeline中处理

②Middleware:中间件、组件,位于Server与Application之间,用来处理发送到Pipeline中的请求

④Application:具体的应用程序代码

2)Application Delegate(应用程序委托),用于Server与Middleware的交互。他并不是严格意义上的接口,而是一个委托并且每个OWIN中间件组件必须提供。

3)Environment Dictionary(环境字典),对http请求的封装

request data:

Required
Key Name
Value Description
Yes
"owin.RequestBody"
请求体。Stream类型
Yes
"owin.RequestHeaders"
请求头。IDictionary<string, string[]>类型
Yes
"owin.RequestMethod"
包含请求的HTTP请求方法(例如,“GET”,“POST”)的字符串。
Yes
"owin.RequestPath"
包含请求路径的字符串。 该路径必须是相对于应用程序委托的“根”的
Yes
"owin.RequestPathBase"
包含与应用程序委托的“根”对应的请求路径部分的字符串
Yes
"owin.RequestProtocol"
包含协议名称和版本的字符串(例如“HTTP / 1.0”或“HTTP / 1.1”)。
Yes
"owin.RequestQueryString"
包含HTTP请求URI的查询字符串组件的字符串,不含前导“?”(例如,“foo = bar&baz = quux”)。 该值可能是一个空字符串。
Yes
"owin.RequestScheme"
包含用于请求的URI方案(例如“http”,“https”)的字符串

response data:

Required
Key Name
Value Description
Yes
"owin.ResponseBody"
响应体。Stream类型
Yes
"owin.ResponseHeaders"
响应头。IDictionary<string, string[]>类型
No
"owin.ResponseStatusCode"
包含RFC 2616第6.1.1节中定义的HTTP响应状态代码的可选项。 默认值是200。
No
"owin.ResponseReasonPhrase"
包含原因短语的可选字符串关联给定的状态码。 如果没有提供,则服务器应该按照RFC 2616第6.1.1节的规定提供默认值
No
"owin.ResponseProtocol"
包含协议名称和版本的可选字符串(例如“HTTP / 1.0”或“HTTP / 1.1”)。 如果没有提供,则“owin.RequestProtocol”键的值是默认值。

other data:

Required
Key Name
Value Description
Yes
"owin.CallCancelled"
指示请求是否被取消/中止
Yes
"owin.Version"
表示OWIN版本的字符串“1.0”

 

二、Katana

1,Katana介绍

①Katana实现了OWIN的Layers

②Pileline中的Middleware是链式执行的,有开发人员控制

③层

 

2,使用ASP.NET/IIS托管Katana-based应用程序

nuget Microsoft.Owin.Host.SystemWeb

添加Startup启动类将Middleware中间件注册到Pileline中

using System;
using System.Threading.Tasks;
using Microsoft.Owin;
using Owin;

[assembly: OwinStartup(typeof(Katana.Systen.Web.Startup))]

namespace Katana.Systen.Web
{
    public class Startup
    {
        public void Configuration(IAppBuilder app)
        {
            // 有关如何配置应用程序的详细信息,请访问 https://go.microsoft.com/fwlink/?LinkID=316888

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

3,自托管Katana-based应用程序

nuget Microsoft.Owin.SelfHost

在Main方法中使用Startup配置项构建Pipeline并监听端口

using System;
using System.Collections.Generic;
using System.Linq;
using System.Text;
using System.Threading.Tasks;
using Microsoft.Owin.Hosting;

namespace Katana.SelfHost
{
    class Program
    {
        static void Main(string[] args)
        {
            using (WebApp.Start<Startup>("http://localhost:7000"))
            {
                Console.WriteLine("程序启动");
                Console.ReadLine();
            }

        }
    }
}
Program
using System;
using System.Threading.Tasks;
using Microsoft.Owin;
using Owin;

[assembly: OwinStartup(typeof(Katana.SelfHost.Startup))]

namespace Katana.SelfHost
{
    public class Startup
    {
        public void Configuration(IAppBuilder app)
        {
            // 有关如何配置应用程序的详细信息,请访问 https://go.microsoft.com/fwlink/?LinkID=316888

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

3.1,使用Katana Diagnostic Helpers

将应用程序运行在自定义Host中,将失去IIS中所有的管理、诊断功能,但我们可以使用Katana提供的内置Helper比如Diagnostic helper来获取

nuget Micorost.Owin.Diagnostic

using System;
using System.Collections.Generic;
using System.Linq;
using System.Text;
using System.Threading.Tasks;
using Microsoft.Owin.Hosting;

namespace Katana.SelfHost
{
    class Program
    {
        static void Main(string[] args)
        {
            using (WebApp.Start<DiagnosticStartup>("http://localhost:7000"))
            {
                Console.WriteLine("程序启动");
                Console.ReadLine();
            }

        }
    }
}
Program
using System;
using System.Threading.Tasks;
using Microsoft.Owin;
using Owin;
using System.Diagnostics;

[assembly: OwinStartup(typeof(Katana.SelfHost.DiagnosticStartup))]

namespace Katana.SelfHost
{
    public class DiagnosticStartup
    {
        public void Configuration(IAppBuilder app)
        {
            // 有关如何配置应用程序的详细信息,请访问 https://go.microsoft.com/fwlink/?LinkID=316888

            //将一个WelcomePage Middleware注册到pipeline中
            //(在此输出WelcomePage渲染页面,并且不会执行余下的pipeline middleware组件)
            app.UseWelcomePage("/");
            //将一个错误页注册到pipeline中
            app.UseErrorPage();
            app.Run(context =>
            {
                if (context.Request.Path.ToString().Equals("/error"))
                {
                    Trace.WriteLine(context.Request.Path);
                    throw new Exception("抛出异常");
                }
                return context.Response.WriteAsync("Hello World");
            });
        }
    }
}
DiagnosticStartup

5,使用OwinHost.exe托管Katana-based应用程序

nuget OwinHost

nuget Micosoft.Owin

配置web属性

using System;
using System.Threading.Tasks;
using Microsoft.Owin;
using Owin;

[assembly: OwinStartup(typeof(Katana.OwinHost.WebApp.Startup))]

namespace Katana.OwinHost.WebApp
{
    public class Startup
    {
        public void Configuration(IAppBuilder app)
        {
            // 有关如何配置应用程序的详细信息,请访问 https://go.microsoft.com/fwlink/?LinkID=316888

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

6,几种制定Startup启动项方式

①默认名称约束:Host会去查找root namespace 下名为Startup的类作为启动项

②OwinStartup Attribute:当创建Owin Startup类时,自动会加上Attribute如:

 [assembly: OwinStartup(typeof(Katana.OwinHost.WebApp.Startup))] 

③配置文件:如:

<add key="owin:appStartup" value="Katana.OwinHost.WebApp.Startup">

④如果使用自定一host,那么可以通过 WebApp.Start<DiagnosticStartup>("http://localhost:7000") 来设置启动项

⑤如果使用OwinHost,那么可以通过命名行参数来实现

三、创建自定义Middleware中间件

using System;
using System.Threading.Tasks;
using System.Collections;
using Microsoft.Owin;
using Owin;

[assembly: OwinStartup(typeof(Katana.OwinHost.WebApp.Startup))]

namespace Katana.OwinHost.WebApp
{
    public class Startup
    {
        public void Configuration(IAppBuilder app)
        {
            // 有关如何配置应用程序的详细信息,请访问 https://go.microsoft.com/fwlink/?LinkID=316888
            app.Use(async (context, next) => {

                await context.Response.WriteAsync("begin"+Environment.NewLine);
                await next();
                await context.Response.WriteAsync("end" + Environment.NewLine);

            });

            app.Use<MyMiddleware>();

            app.Run(context => { return context.Response.WriteAsync("holle World" + Environment.NewLine); });
        }
    }
}
using System;
using System.Collections.Generic;
using System.Linq;
using System.Threading.Tasks;
using System.Web;
using Microsoft.Owin;

namespace Katana.OwinHost.WebApp
{
    public class MyMiddleware : OwinMiddleware
    {
        public MyMiddleware(OwinMiddleware next) : base(next) { }

        public override async Task Invoke(IOwinContext context)
        {
            await context.Response.WriteAsync("MyMiddleware-begin" + Environment.NewLine);
            await this.Next.Invoke(context);
            await context.Response.WriteAsync("MyMiddleware-end" + Environment.NewLine);
        }

    }
}

案例下载:http://pan.baidu.com/s/1qXAmu2w

以上是关于OWIN与Katana的主要内容,如果未能解决你的问题,请参考以下文章

OWIN 身份验证管道正确使用 Katana 中间件?

OWIN / Katana 的未处理异常全局处理程序?

将 Owin / Katana 与 ASP.NET Core(实际用例)一起使用是不是仍然相关?

身份验证/授权 MVC 5 和 Web API - Katana/Owin

读.Net Core开源项目源码:Owin Katana 的底层源码分析

Katana 还是Owin ? 本地自承载