Core 1.0中的管道-中间件模式
ASP.NET Core 1.0中的管道-中间件模式
SP.NET Core 1.0借鉴了Katana项目的管道设计(Pipeline)。日志记录、用户认证、MVC等模块都以中间件(Middleware)的方式注册在管道中。显而易见这样的设计非常松耦合并且非常灵活,你可以自己定义任意功能的Middleware注册在管道中。这一设计非常适用于“请求-响应”这样的场景——消息从管道头流入最后反向流出。
在本文中暂且为这种模式起名叫做“管道-中间件(Pipeline-Middleware)”模式吧。
本文将描述”管道-中间件模式”的“契约式”设计和“函数式”设计两种方案。
一、什么是管道-中间件模式?
在此模式中抽象了一个类似管道的概念,所有的组件均以中间件的方式注册在此管道中,当请求进入管道后:中间件依次对请求作出处理,然后从最后一个中间件开始处理响应内容,最终反向流出管道。
二、契约式设计
契约式设计是从面向对象的角度来思考问题,根据管道-中间件的理解,中间件(Middleware)有两个职责:
1
2
3
4
5
|
public interface IMiddleware { Request ProcessRequest(Request request); Response ProcessResponse(Response response); } |
管道(Pipeline)抽象应该能够注册中间件(Middleware):
1
2
3
4
5
6
7
8
9
|
public interface IApplicationBuilder { void Use(IMiddleware middleware); void UseArrange(List<IMiddleware> middlewares); Context Run(Context context); } |
实现IApplicationBuilder:
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
|
public class ApplicationBuilder : IApplicationBuilder { public IWindsorContainer Container { get ; private set ; } private readonly List<IMiddleware> _middlewares; public ApplicationBuilder(IWindsorContainer container) { Contract.Requires(container!= null , "container!=null" ); _middlewares= new List<IMiddleware>(); Container = container; } public void Use(IMiddleware middleware) { Contract.Requires(middleware != null , "middleware!=null" ); _middlewares.Add(middleware); } public void UseArrange(List<IMiddleware> middlewares) { Contract.Requires(middlewares != null , "middlewares!=null" ); _middlewares.AddRange(middlewares); } public Context Run(Context context) { Contract.Requires(context!= null , "context!=null" ); var request=context.Request; var response=context.Response; foreach ( var middleware in _middlewares) { request = middleware.ProcessRequest(request); } _middlewares.Reverse(); foreach ( var middleware in _middlewares) { response = middleware.ProcessResponse(response); } return new Context(request,response); } } |
Run()方法将依次枚举Middleware并对消息的请求和响应进行处理,最后返回最终处理过的消息。
接下来需要实现一个Middleware:
1
2
3
4
5
6
7
8
9
10
11
12
13
14
|
public class DefaultMiddleware:IMiddleware { public Request ProcessRequest(Request request) { request.Process( "default request" , "processed by defaultMiddleware" ); return request; } public Response ProcessResponse(Response response) { response.Process( "default response" , "processed by defaultMiddleware" ); return response; } } |
为了将Middleware注册进管道,我们还可以写一个扩展方法增加代码的可读性:
1
2
3
4
5
6
7
8
9
10
11
12
|
public static void UseDefaultMiddleware( this IApplicationBuilder applicationBuilder) { applicationBuilder.Use<DefaultMiddleware>(); } public static void Use<TMiddleware>( this IApplicationBuilder applicationBuilder) where TMiddleware:IMiddleware { var middleware = applicationBuilder.Container.Resolve<TMiddleware>(); applicationBuilder.Use(middleware); } |
写个测试看看吧:
写第二个Middleware:
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
|
public class GreetingMiddleware:IMiddleware { public Request ProcessRequest(Request request) { request.Process( "hello, request" , "processed by greetingMiddleware" ); return request; } public Response ProcessResponse(Response response) { response.Process( "hello, request" , "processed by greetingMiddleware" ); return response; } } |
编写测试:
三、函数式设计方案
此方案也是Owin和ASP.NET Core采用的方案,如果站在面向对象的角度,第一个方案是非常清晰的,管道最终通过枚举所有Middleware来依次处理请求。
站在函数式的角度来看,Middleware可以用Func<Context, Context>来表示,再来看看这张图:
一个Middleware的逻辑可以用Func<Func<Context, Context>, Func<Context, Context>>来表示,整个Middleware的逻辑可以用下面的代码描述:
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
|
public Func<Func<Context, Context>, Func<Context, Context>> Process() { Func<Func<Context, Context>, Func<Context, Context>> middleware = next => { Func<Context, Context> process = context => { /*process request*/ next(context); /*process response*/ return context; }; return process; }; return middleware; } |
这一过程是理解函数式方案的关键,所有Middleware可以聚合为一个Func<Context,Context>,为了易于阅读,我们可以定义一个委托:
1
|
public delegate Context RequestDelegate(Context context); |
给定初始RequestDelegate,聚合所有Middleware:
1
2
3
4
5
6
7
8
9
10
11
12
13
|
public IApplication Build() { RequestDelegate request = context => context; _middlewares.Reverse(); foreach ( var middleware in _middlewares) { request = middleware(request); } return new Application(request); } |
自定义一个函数式Middleware:
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
|
public class DefaultMiddleware:IMiddleware { public Func<RequestDelegate, RequestDelegate> Request() { Func<RequestDelegate, RequestDelegate> request = next => { return context => { context.Request.Process( "default request" , "processed by defaultMiddleware" ); next(context); context.Response.Process( "default response" , "processed by defaultMiddleware" ); return context; }; }; return request; } } |
所有代码提供下载:https://git.oschina.net/richieyangs/Pipeline.Middleware.git
Core 1.0中的管道-中间件模式的更多相关文章
- ASP.NET Core 1.0中的管道-中间件模式
ASP.NET Core 1.0借鉴了Katana项目的管道设计(Pipeline).日志记录.用户认证.MVC等模块都以中间件(Middleware)的方式注册在管道中.显而易见这样的设计非常松耦合 ...
- 探索ASP.Net Core 3.0系列二:聊聊ASP.Net Core 3.0 中的Startup.cs
原文:探索ASP.Net Core 3.0系列二:聊聊ASP.Net Core 3.0 中的Startup.cs 前言:.NET Core 3.0 SDK包含比以前版本更多的现成模板. 在本文中,我将 ...
- 避免在ASP.NET Core 3.0中为启动类注入服务
本篇是如何升级到ASP.NET Core 3.0系列文章的第二篇. Part 1 - 将.NET Standard 2.0类库转换为.NET Core 3.0类库 Part 2 - IHostingE ...
- 在ASP.NET Core 2.0中使用CookieAuthentication
在ASP.NET Core中关于Security有两个容易混淆的概念一个是Authentication(认证),一个是Authorization(授权).而前者是确定用户是谁的过程,后者是围绕着他们允 ...
- 【译】.NET Core 3.0 中的新变化
.NET Core 3.0 是 .NET Core 平台的下一主要版本.本文回顾了 .Net Core 发展历史,并展示了它是如何从基本支持 Web 和数据工作负载的版本 1,发展成为能够运行 Web ...
- 如何在ASP.NET Core 2.0中使用Razor页面
如何在ASP.NET Core 2.0中使用Razor页面 DotNetCore2017-11-22 14:49 问题 如何在ASP.NET Core 2.0中使用Razor页面 解 创建一个空的项 ...
- asp.net core 3.0 中使用 swagger
asp.net core 3.0 中使用 swagger Intro 上次更新了 asp.net core 3.0 简单的记录了一下 swagger 的使用,那个项目的 api 比较简单,都是匿名接口 ...
- 探索 ASP.Net Core 3.0系列三:ASP.Net Core 3.0中的Service provider validation
前言:在本文中,我将描述ASP.NET Core 3.0中新的“validate on build”功能. 这可以用来检测您的DI service provider是否配置错误. 具体而言,该功能可检 ...
- [转]【译】.NET Core 3.0 中的新变化
.NET Core 3.0 是 .NET Core 平台的下一主要版本.本文回顾了 .Net Core 发展历史,并展示了它是如何从基本支持 Web 和数据工作负载的版本 1,发展成为能够运行 Web ...
随机推荐
- 深入探讨MFC消息循环和消息泵
首先,应该清楚MFC的消息循环(::GetMessage,::PeekMessage),消息泵(CWinThread::PumpMessage)和MFC的消息在窗口之间的路由是两件不同的事情.在MFC ...
- 安装logstash,elasticsearch,kibana三件套(转)
logstash,elasticsearch,kibana三件套 elk是指logstash,elasticsearch,kibana三件套,这三件套可以组成日志分析和监控工具 注意: 关于安装文档, ...
- 如何在Android Studio上使用Github
首先,登陆到Github上并创建一个新repository.在屏幕右上角,点击“+”标记,并且选择“New repository”. 现在完成这个表格以新建一个叫做testproject的新repos ...
- jquery中怎么删除<ul>中的整个<li>包括节点
.$('ul li').remove(); .$('ul li').each(function(){ $(this).remove(); }); .$("ul").find(&qu ...
- EndNote是一款着名的参考文献管理软件
EndNote是一款着名的参考文献管理软件,我们可以通过该软件创建个人参考文献库,此外对公司DCC.法务和专 利部门十分的有用,甚至对我们写SOP 也有些帮忙,并且该软件可以在其中加入文本.图像.表格 ...
- 程序缩小到托盘后系统就无法关机(解决方案)——处理WM_QUERYENDSESSION消息,并把它标识为处理过了
程序缩小到托盘后系统就无法关机(解决方案) 老帅 程序最小化到托盘后,会出现系统无法关闭的问题,常见于WinXP系统中,这里提供一个解决方案!一.解决 ...
- C++ STL中Map的相关排序操作:按Key排序和按Value排序 - 编程小径 - 博客频道 - CSDN.NET
C++ STL中Map的相关排序操作:按Key排序和按Value排序 - 编程小径 - 博客频道 - CSDN.NET C++ STL中Map的相关排序操作:按Key排序和按Value排序 分类: C ...
- DOM - Element 对象
http://www.runoob.com/dom/dom-element.html Element 对象 Element 对象代表 XML 文档中的一个元素.元素可以包含属性.其他元素或文本.如果一 ...
- linux signal之初学篇
前言 本博文只总结signal的应用,对signal的kernel实现暂不讨论. 1. linux signal是什么? signal是linux提供的用于进程间通信的一种IPC机制. 2. 如何发送 ...
- freemarker自己定义标签(二)
freemarker自己定义标签 1.自己定义标签 通过自己定义标签,写一个反复指定字符串 2.实现源代码 <html> <head> <meta http-equiv= ...