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
  • 相关阅读:
    <转载>c#多线程:线程池和异步编程
    <转载>讲故事谈.NET委托:一个C#睡前故事
    IIS 7.0 成员管理配置
    呵呵，新开博！
    PHP函数中文文档
    请不要做浮躁的人对程序员的忠告
    php新闻发布完成
    JS调试工具
    PHP配置FCKEditor
    ACEGI配置总结(1)
  • 原文地址：https://www.cnblogs.com/zd1994/p/7820338.html
Copyright © 2011-2022 走看看