大橙子网站建设,新征程启航
为企业提供网站建设、域名注册、服务器等服务
ASP.NET中Middleware的作用是什么,相信很多没有经验的人对此束手无策,为此本文总结了问题出现的原因和解决方法,通过这篇文章希望你能解决这个问题。
目前创新互联已为上千余家的企业提供了网站建设、域名、网站空间、绵阳服务器托管、企业网站设计、万柏林网站维护等服务,公司将坚持客户导向、应用为本的策略,正道将秉承"和谐、参与、激情"的文化,与客户和合作伙伴齐心协力一起成长,共同发展。
Middleware的注册和配置
在ASP.NET5中,request请求管线(Pipeline)的访问是在Startup类中进行的,该类时一个约定类,并且里面的ConfigureServices方法、Configure方法、以及相应的参数也是事先约定的,所以不能进行改动。
Middleware中的依赖处理:ConfigureServices方法
在ASP.NET5中的各种默认的Middleware中,都使用了依赖注入的功能,所以在使用Middleware中的功能时,需要提前将依赖注入所需要的类型及映射关系都注册到依赖注入管理系统中,即IServiceCollection集合,而ConfigureServices方法接收的就一个IServiceCollection类型的参数,该参数就是所有注册过类型的集合,通过原生的依赖注入组件进行管理(关于ASP.NET5中的依赖注入,我们会在单独章节中进行讲解),在该方法内,我们可以向该集合中添加新的类型和类型映射关系,示例如下:
// Add MVC services to the services container. services.AddMvc();
示例中的代码用于向系统添加Mvc模块相关的Service类型以支撑MVC功能,该方法是一个扩展方法,用于在集合中添加与MVC相关的多个类型。
Middleware的注册和配置:Configure方法
Configure方法的签名如下:
public void Configure(IApplicationBuilder app, IHostingEnvironment env, ILoggerFactory loggerfactory) { // ... }
Configure方法接收了三个参数:IApplicationBuilder类型的参数用于构建整个应用程序的配置信息,IHostingEnvironment类的env参数用于访问系统环境变量相关的内容,ILoggerFactory类型的loggerfactory用于日志相关的内容处理,其中IApplicationBuilder类型的参数最为重要,该参数实例app上有一系列的扩展方法用于将各种Middleware注册到request请求管线(Pipeline)中。这种方式和之前ASP.NET中的HTTP管线的主要区别是:新版本中的组合模型替换了旧版本中的事件模型。这也就要求,在新版ASP.NET中,Middleware组件注册的顺序是非常重要的,因为后一个组件可能要使用到前一个组件,所以必须按照依赖的先后顺序进行注册,举例如下,当前MVC项目的模板代码示例如下
// Add static files to the request pipeline. app.UseStaticFiles(); // Add cookie-based authentication to the request pipeline. app.UseIdentity(); // Add MVC to the request pipeline. app.UseMvc(routes =>{ /*...*/});
示例中的UseStaticFiles、UseIdentity、UseMvc都是IApplicationBuilder上的扩展方法,在扩展方法中,都会通过调用扩展方法app.UseMiddleware方法,最终再调用app.Use方法来注册新的Middleware,该方法定义如下:
public interface IApplicationBuilder { //... IApplicationBuilder Use(Func
通过代码,可以看出,middleware是Func
public delegate Task RequestDelegate(HttpContext context);
通过源码,我们可以看出,RequestDelegate是一个委托函数,其接收HttpContext类型的实例,并返回一个Task类型的异步对象。也就是说RequestDelegate是一个可以返回自身RequestDelegate类型函数的函数,整个ASP.NET也就是利用这种方式构建了管线(Pipelien)的组成,在这里,每个middleware都链式到下一个middleware上,并在整个过程中可以对HttpConext对象进行修改或维护,当然,HttpContext中就包括了我们常操作的HttpRequest和HttpResponse实例对象。
注意:HttpContext、HttpRequest、HttpResponse在ASP.NET 5中都是重新定义的新类型。
Middleware的定义
既然每个middleare都是Func
构造函数的***个参数必须是处理管线中的下一个处理函数,即RequestDelegate;
必须有一个 Invoke 函数, 并接受上下文参数(即HttpContent), 然后返回 Task;
示例如下:
public class MiddlewareName { RequestDelegate _next; public MiddlewareName(RequestDelegate next) { _next = next;// 接收传入的RequestDelegate实例 } public async Task Invoke(HttpContext context) { // 处理代码,如处理context.Request中的内容 Console.WriteLine("Middleware开始处理"); await _next(context); Console.WriteLine("Middleware结束处理"); // 处理代码,如处理context.Response中的内容 } }
通过该模板代码可以看到,首先一个Middleware的构造函数要接收一个RequestDelegate的实例,先保存在一个私有变量里,然后通过调用Invoke方法(并接收HttpContent实例)并返回一个Task,并且在调用Invoke的方法中,要通过await _next(context);语句,链式到下一个Middleware上,我们的处理代码主要就是在链式语句的前后执行相关的代码。
举个例子,如果我们要想记录页面的执行时间,首先,我们先定义一个TimeRecorderMiddleware,代码如下:
public class TimeRecorderMiddleware
{
RequestDelegate _next;
public TimeRecorderMiddleware(RequestDelegate next)
{
_next = next;
}
public async Task Invoke(HttpContext context)
{
var sw = new Stopwatch();
sw.Start();
await _next(context);
var newDiv = @"
页面处理时间:{0} 毫秒
";
var text = string.Format(newDiv, sw.ElapsedMilliseconds);
await context.Response.WriteAsync(text);
}
}
Middleware的注册有很多种方式,如下是实例型注册代码:
app.Use(next => new TimeRecorderMiddleware(next).Invoke);
或者,你也可以使用UseMiddleware扩展方法进行注册,示例如下:
app.UseMiddleware(); //app.UseMiddleware(typeof(TimeRecorderMiddleware)); 两种方式都可以
当然,你也可以定义一个自己的扩展方法用于注册该Middleware,代码如下:
public static IApplicationBuilder UseTimeRecorderMiddleware(this IApplicationBuilder app)
{
return app.UseMiddleware(); }
***在Startup类的Configure方法内进行注册,代码如下:
public void Configure(IApplicationBuilder app, IHostingEnvironment env, ILoggerFactory loggerfactory) { app.UseTimeRecorderMiddleware(); // 要放在前面,以便进行统计,如果放在Mvc后面的话,就统计不了时间了。 // 等等 }
编译,重启,并访问页面,在页面的底部即可看到页面的运行时间提示内容。
常用Middleware功能的使用
app.UseErrorPage()
在IHostingEnvironment.EnvironmentName为Development的情况下,才显示错误信息,并且错误信息的显示种类,可以通过额外的ErrorPageOptions参数来设定,可以设置全部显示,也可以设置只显示Cookies、Environment、ExceptionDetails、Headers、Query、SourceCode SourceCodeLineCount中的一种或多种。
app.UseErrorHandler("/Home/Error")
捕获所有的程序异常错误,并将请求跳转至指定的页面,以达到友好提示的目的。
app.UseStaticFiles()
开启静态文件也能走该Pipeline管线处理流程的功能。
app.UseIdentity()
开启以cookie为基础的ASP.NET identity认证功能,以支持Pipeline请求处理。
直接使用委托定义Middleware的功能
由于Middleware是Func
public void Configure(IApplicationBuilder app, IHostingEnvironment env, ILoggerFactory loggerfactory) { app.Use(new Func
做个简便的Middleware基类
虽然有约定方法,但有时候我们在开发的时候往往会犯迷糊,想不起来到底是什么样的约定,所以,在这里我们可以定义一个抽象基类,然后以后所有的Middleware在定义的时候都继承该抽象类并重载Invoke方法即可,从而可以避免约定忘记的问题。代码如下:
/// /// 抽象基类 /// public abstract class AbstractMiddleware { protected RequestDelegate Next { get; set; } protected AbstractMiddleware(RequestDelegate next) { this.Next = next; } public abstract Task Invoke(HttpContext context); } /// /// 示例Middleware /// public class DemoMiddleware : AbstractMiddleware { public DemoMiddleware(RequestDelegate next) : base(next) { } public async override Task Invoke(HttpContext context) { Console.WriteLine("DemoMiddleware Start."); await Next.Invoke(context); Console.WriteLine("DemoMiddleware End."); } }
使用方法和上面的一样。
终止链式调用或阻止所有的Middleware
在有些情况下,当然根据某些条件判断以后,可能不在需要继续往下执行下去了,而是想知己诶返回结果,那么你可以在你的Middleware里忽略对await next.Invoke(content);的调用,直接使用·Response.WriteAsync·方法输出内容。
另外,在有些情况下,你可能需要实现类似之前版本中的handler的功能,即不经常任何Pipeline直接对Response进行响应,新版ASP.NET里提供了一个run方法用于实现该功能,只需要在Configure方法里调用如下代码即可实现类似的内容输出
app.Run(async context => { context.Response.ContentType = "text/html"; await context.Response.WriteAsync("Hello World!"); });
关于ASP.NET 5 Runtime的内容,请访问:https://msdn.microsoft.com/en-us/magazine/dn913182.aspx
遗留问题
在Mvc项目中,所有的依赖注入类型都是通过IServiceProvider实例来获取的,目前可以通过以下形式获取该实例:
var services = Context.RequestServices; // Controller中 var services = app.ApplicationServices; // Startup中
获取了该实例以后,即可通过如下方法来获取某个类型的对象:
var controller = (AccountController)services.GetService(typeof(AccountController)); // 要判断获取到的对象是否为null
如果你引用了Microsoft.Framework.DependencyInjection命名空间的话,还可以使用如下三种扩展方法:
var controller2 = (AccountController)services.GetService(); // 要判断获取到的对象是否为null //如下两种方式,如果获取到的AccountController实例为null的话,就会字段抛异常,而不是返回null var controller3 = (AccountController)services.GetRequiredService(typeof(AccountController)); var controller4 = (AccountController)services.GetRequiredService();
看完上述内容,你们掌握ASP.NET中Middleware的作用是什么的方法了吗?如果还想学到更多技能或想了解更多相关内容,欢迎关注创新互联行业资讯频道,感谢各位的阅读!