zoukankan      html  css  js  c++  java
  • 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

  • 相关阅读:
    关于二进制包安装MySQL出现yum安装保护多库场景解决
    关于 Fatal NI connect error 12170 错误
    调优排故笔记1-利用等待事件及相关文件和视图-Oracle内核揭秘
    MySQL的四种隔离级别
    Oracle绑定变量
    接口加密测试
    接口测试用例设计
    学习总结——接口测试中抓包工具的使用
    学习总结——JMeter做WebService接口功能测试
    JMeter做http接口压力测试
  • 原文地址:https://www.cnblogs.com/zd1994/p/7820338.html
Copyright © 2011-2022 走看看