[译]ASP.NET Core 2.0 中间件
问题
如何创建一个最简单的ASP.NET Core中间件?
答案
使用VS创建一个ASP.NET Core 2.0的空项目,注意Startup.cs中的Configure()方法:
public void Configure(IApplicationBuilder app, IHostingEnvironment env)
{
app.Run(async (context) =>
{
await context.Response.WriteAsync("Hello World! (Run)");
});
}
比较好的创建请求管道的方法是使用IApplicationBuilder上的扩展方法:
public static void RunHelloWorld(this IApplicationBuilder app)
{
app.Run(async (context) =>
{
await context.Response.WriteAsync("Hello World! (Run)");
});
}
public void Configure(IApplicationBuilder app, IHostingEnvironment env)
{
app.RunHelloWorld();
}
运行,此时页面显示:

上面我们使用IApplicationBuilder.Run()来配置中间件,另外一种方法是IApplicationBuilder.Use():
public static void UseHelloWorld(this IApplicationBuilder app)
{
app.Use(async (context, next) =>
{
await context.Response.WriteAsync("Hello World! (Use)\n");
await next();
});
}
public void Configure(IApplicationBuilder app, IHostingEnvironment env)
{
app.UseHelloWorld();
app.RunHelloWorld();
}
运行,此时页面显示:

将中间件作为单独的类定义是更好的实践方法:
public class HelloWorldMiddleware
{
private readonly RequestDelegate _next; public HelloWorldMiddleware(RequestDelegate next)
{
_next = next;
} public async Task Invoke(HttpContext context)
{
await context.Response.WriteAsync("Hello World! (Use in Class)\n");
await _next(context);
}
} public static class UseHelloWorldInClassExtensions
{
public static IApplicationBuilder UseHelloWorldInClass(this IApplicationBuilder app)
{
return app.UseMiddleware<HelloWorldMiddleware>();
}
}
public void Configure(IApplicationBuilder app, IHostingEnvironment env)
{
app.UseHelloWorld();
app.UseHelloWorldInClass();
app.RunHelloWorld();
}
运行,此时页面显示:

讨论
中间件是一个拦截HTTP请求和响应消息的组件。我们通过创建这些组件链,来为我们的应用程序创建一个请求管道。
我们通过Configure()方法的IApplicationBuilder参数来创建这个请求管道,IApplicationBuilder参数有如下方法:
- Run():添加中间件并终止请求管道(也就是说不再调用下一个中间件)。
- Use():添加中间件,使用lambda表达式或者一个具体的类。
- Map():根据请求路径添加中间件。
Run
这个方法接受RequestDelegate委托作为参数,当委托方法被调用时接受HttpContext参数。这个委托方法返回void,因为它会终止请求管道。
Use
这个方法接受Func委托作为参数,此委托方法有两个参数,分别是HttpContext和指向下一个中间件的next,返回空(Task)。如果没有调用下一个中间件,就会终止请求管道(和Run效果一样)。
UserMiddleware
当通过单独类创建中间件时,我们使用UseMiddleware方法,并将具体的实现类型作为泛型参数。
在中间件类中,有两个部分很重要:
1. 构造函数接受RequestDelegate。当调用此委托时会将当前请求传入下一个中间件。
2. 它拥有一个Invoke方法,接收HttpContext参数并返回空(Task)。当需要用到中间件时,框架会主动调用这个方法。
注:在单独类中实现中间件,并用UseMiddleware封装起来是最佳实践。
扩展方法
需要注意扩展方法的不同之处,RunXXX不会返回值,而UseXXX会返回值(IApplicationBuilder)。这是因为Run()终止请求管道,而Use()可能会链接到其他的中间件。
顺序
中间件按照它们在Configure()方法出现的顺序依次被调用。而返回到客户端的响应也会经历相同的中间件管道。
源代码下载
原文:https://tahirnaushad.com/2017/08/14/asp-net-core-middleware/
[译]ASP.NET Core 2.0 中间件的更多相关文章
- [译]ASP.NET Core 2.0 系列文章目录
基础篇 [译]ASP.NET Core 2.0 中间件 [译]ASP.NET Core 2.0 带初始参数的中间件 [译]ASP.NET Core 2.0 依赖注入 [译]ASP.NET Core 2 ...
- [译]ASP.NET Core 2.0 带初始参数的中间件
问题 如何在ASP.NET Core 2.0向中间件传入初始参数? 答案 在一个空项目中,创建一个POCO(Plain Old CLR Object)来保存中间件所需的参数: public class ...
- [译]ASP.NET Core 2.0 全局配置项
问题 如何在 ASP.NET Core 2.0 应用程序中读取全局配置项? 答案 首先新建一个空项目,并添加两个配置文件: 1. appsettings.json { "Section1&q ...
- [译]ASP.NET Core 2.0 机密配置项
问题 如何在ASP.NET Core 2.0中保存机密配置项(不用将其暴露给源代码管理器)? 答案 创建一个ASP.NET Core 2.0空项目,在项目节点上点击右键,并点击菜单项 - 管理用户机密 ...
- [译]ASP.NET Core 2.0 会话状态
问题 如何在ASP.NET Core 2.0中存储会话状态? 答案 创建一个空项目,修改Startup类的ConfigureServices()方法,添加会话状态服务和它后台的存储服务: public ...
- [译]ASP.NET Core 2.0 本地文件操作
问题 如何在ASP.NET Core 2.0中受限地访问本地目录和文件信息? 答案 新建一个空项目,修改Startup类,添加访问本地文件所需的服务: public void ConfigureSer ...
- [译]ASP.NET Core 2.0 网址重定向
问题 如何在ASP.NET Core 2.0中实现网址重定向? 答案 新建一个空项目,在Startup.cs文件中,配置RewriteOptions参数并添加网址重定向中间件(UseRewriter) ...
- [译]ASP.NET Core 2.0 路由引擎
问题 ASP.NET Core 2.0的路由引擎是如何工作的? 答案 创建一个空项目,为Startup类添加MVC服务和请求中间件: public void ConfigureServices(ISe ...
- [译]ASP.NET Core 2.0 路由引擎之网址生成
问题 如何在ASP.NET Core 2.0中由路由引擎来生成网址? 答案 新建一个空项目,修改Startup.cs文件,添加MVC服务和中间件: public void ConfigureServi ...
随机推荐
- 201521123052《Java程序设计》第7周学习总结
1. 本周学习总结 参考资料: XMind 2. 书面作业 1.ArrayList代码分析 1.1 解释ArrayList的contains源代码 public boolean contains(Ob ...
- 201521123051 《Java程序设计》 第二周学习总结
1. 本周学习总结 1.学会使用码云:学会如何将项目同步到码云中以及从码云上的项目保存到本地. 2.各数据类型的使用. 3.运算符和表达式的使用. 4.string创建之后不可在修改. 5.Java程 ...
- 201521123017 《Java程序设计》第12周学习总结
1. 本周学习总结 2. 书面作业 Q1.字符流与文本文件:使用 PrintWriter(写),BufferedReader(读) 1.1 生成的三个学生对象,使用PrintWriter的printl ...
- 一、React Native 搭建开发环境(1)(Mac OS - IOS项目)
React Native是Facebook推出的一个开发IOS和安卓APP的技术.至于更多的详情,这里不再描述,大家可以自行百度它的定义. 目的: 由于我想在一台电脑上同时开发IOS和Android两 ...
- Sql Server——基础
前言: 在了解数据库之前,我们应该首先了解一下和数据库有关的知识,如:什么是数据,什么又是数据库等. 数据:描述事物的符号记录称为数据,它是数据库中存储的基本对象. 数据库(Datebase):数 ...
- java基础知识4--数组的常用方法(Array)
先说一个idea编辑器的问题,编辑器的光标变成黑色光标无法移动,按一下insert键就好了. 数组是线性数据存储结构.它用牺牲自动扩展大小来换取与集合相比的唯一优势--查询效率的提升.本身是一种引用类 ...
- Hibernate映射乱码
1.修改数据库字符集:将数据库默认编码设置为UTF-8 CHARSET=utf8 2.配置Hibernate环境时将数据库URL设置成: jdbc:mysql://localhost:3306/dbN ...
- centos 7(Linux) 下yum安装mysql
1:查询centos7 中是否有可安装的mysql.命令查询 yum list mysql* 没有可安装的mysql软件... 2:sudo rpm -Uvh http://dev.mysql.com ...
- spring 面向切面(AOP)
AOP为Aspect Oriented Programming的缩写,意为:面向切面编程,通过预编译方式和运行期动态代理实现程序功能的统一维护的一种技术. AOP与OOP是面向不同领域的两种设计思想. ...
- 【DDD】领域驱动设计实践 —— Application层实现
本文是DDD框架实现讲解的第二篇,主要介绍了DDD的Application层的实现,详细讲解了service.assemble的职责和实现.文末附有github地址.相比于<领域驱动设计> ...