MVC Filter是典型的AOP(面向切面编程)应用,在ASP.NET MVC中的4个过滤器类型,如下:
但是默认实现它们的过滤器只有三种,分别是ActionFilter(方法),Authorize(授权),HandleError(错误处理)。
- 特性(Attribute)是用于在运行时传递程序中各种元素(比如类、方法、结构、枚举、组件等)的行为信息的声明性标签。您可以通过使用特性向程序添加声明性信息。一个声明性标签是通过放置在它所应用的元素前面的方括号([ ])来描述的。
- 特性(Attribute)用于添加元数据,如编译器指令和注释、描述、方法、类等其他信息。.Net 框架提供了两种类型的特性:预定义特性和自定义特性
Filter的默认实现方式就是带有Attribute后缀的,有了Attribute,我们就可以将我们的Filter像标签一样的贴在方法或者控制器的上方
Web Api: System.Web.Http.Filters.ActionFilterAttribute 继承该类
- OnActionExecuting 执行前
- OnActionExecuted 执行后
- OnResultExecuting 返回前
- OnResultExecuted 返回后
Mvc: System.Web.Mvc.ActionFilterAttribute 继承该类
- OnActionExecuting 执行前
- OnActionExecutingAsync 执行前(异步)
- OnActionExecuted 执行后
- OnActionExecutedAsync 执行后(异步)
1、Action过滤器在ASP.NET MVC中创建MvcApp项目,创建文件夹Filter,然后新建类MyActionFilterAttribute(为了遵循默认的约定,名称以Attribute结尾),继承自ActionFilterAttribute类。ActionFilterAttribute类有如下4个方法。
using System;namespace System.Web.Mvc
{[AttributeUsage(AttributeTargets.Class | AttributeTargets.Method, Inherited = true, AllowMultiple = false)]public abstract class ActionFilterAttribute : FilterAttribute, IActionFilter, IResultFilter{protected ActionFilterAttribute();public virtual void OnActionExecuted(ActionExecutedContext filterContext);public virtual void OnActionExecuting(ActionExecutingContext filterContext);public virtual void OnResultExecuted(ResultExecutedContext filterContext);public virtual void OnResultExecuting(ResultExecutingContext filterContext);}
}
实现MyActionFilterAttribute类:
using System;
using System.Web.Mvc;namespace MvcApp.Filter
{public class MyActionFilterAttribute : ActionFilterAttribute{public override void OnActionExecuting(ActionExecutingContext filterContext){//1、获取请求的类名和方法名string strController = filterContext.RouteData.Values["controller"].ToString();string strAction = filterContext.RouteData.Values["action"].ToString();//2、用另一种方式获取请求的类名和方法名string strController2 = filterContext.ActionDescriptor.ControllerDescriptor.ControllerName;string strAction2 = filterContext.ActionDescriptor.ActionName;filterContext.HttpContext.Response.Write("控制器:" + strController + "<br/>");filterContext.HttpContext.Response.Write("控制器:" + strController2 + "<br/>");filterContext.HttpContext.Response.Write("Action:" + strAction + "<br/>");filterContext.HttpContext.Response.Write("Action:" + strAction2 + "<br/>");filterContext.HttpContext.Response.Write("Action执行前:" + DateTime.Now.ToString("yyyy-MM-dd hh:mm:ss fff") + "<br/>");base.OnActionExecuting(filterContext);}public override void OnActionExecuted(ActionExecutedContext filterContext){filterContext.HttpContext.Response.Write("Action执行后:" + DateTime.Now.ToString("yyyy-MM-dd hh:mm:ss fff") + "<br/>");base.OnActionExecuted(filterContext);}}
}
对于过滤器,我们可以把它们加在3个地方,一个是控制器上面(控制器下面的所有Action),一个是Action上面(指定标识的Action),另一个就是全局位置(所有控制器中的Action)。这里只演示在Action上面和Home控制器中:
[MyActionFilter]
public ActionResult Index()
{return View();
}
2、Result过滤器
新建MyResultFilterAttribute类,继承ActionFilterAttribute:
using System;
using System.Web.Mvc;namespace MvcApp.Filter
{public class MyResultFilterAttribute : ActionFilterAttribute{/// <summary>/// 加载“视图”前执行/// </summary>/// <param name="filterContext"></param>public override void OnResultExecuting(ResultExecutingContext filterContext){filterContext.HttpContext.Response.Write("加载视图前执行 OnResultExecuting" + DateTime.Now.ToString("yyyy-MM-dd hh:mm:ss fff") + "<br/>");base.OnResultExecuting(filterContext);}/// <summary>/// 加载“视图”后执行/// </summary>/// <param name="filterContext"></param>public override void OnResultExecuted(ResultExecutedContext filterContext){filterContext.HttpContext.Response.Write("加载视图后执行 OnResultExecuted" + DateTime.Now.ToString("yyyy-MM-dd hh:mm:ss fff") + "<br/>");base.OnResultExecuted(filterContext);}}
}
这里把MyResultFilter过滤器加在控制器上面,相当于给Home控制器中的所有的Action方法添加了MyResultFilter过滤器。
using MvcApp.Filter;
using System.Web.Mvc;namespace MvcApp.Controllers
{[MyResultFilter]public class HomeController : Controller{[MyActionFilter]public ActionResult Index(){return View();}}
}
3、AuthorizeAttribute过滤器
创建MyAuthorizeAttribute类,继承AuthorizeAttribute类:
using System.Web.Mvc;namespace MvcApp.Filter
{/// <summary>/// 授权过滤器/// </summary>public class MyAuthorizeAttribute : AuthorizeAttribute{public override void OnAuthorization(AuthorizationContext filterContext){filterContext.HttpContext.Response.Write("OnAuthorization<br/>");//注释掉父类方法,因为父类里的OnAuthorization方法会调用ASP.NET的授权验证机制//base.OnAuthorization(filterContext);}}
}
在控制器Home中的Index上添加MyAuthorize过滤器:
[MyAuthorize]
[MyActionFilter]
public ActionResult Index()
{return View();
}
通常Authorize过滤器也是在全局过滤器上面的,主要用来做登录验证或者权限验证,在App_Start目录下的FilterConfig类的RegisterGlobalFilters方法中添加:
public class FilterConfig
{public static void RegisterGlobalFilters(GlobalFilterCollection filters){//filters.Add(new HandleErrorAttribute());//添加全局授权过滤器filters.Add(new MyAuthorizeAttribute());}
}
在全局中注册过滤器,则所有控制器的所有行为(Action)都会执行这个过滤器。
运行结果,如下图:
4、Exception过滤器
创建MyHandleErrorAttribute类,继承HandleErrorAttribute类:
using System;
using System.Web.Mvc;namespace MvcApp.Filter
{/// <summary>/// 异常处理过滤器/// </summary>public class MyHandleErrorAttribute : HandleErrorAttribute{public override void OnException(ExceptionContext filterContext){ //1、获取异常对象Exception ex = filterContext.Exception;//2、记录异常日志//3、重定向友好页面filterContext.Result = new RedirectResult("~/error.html");//4、标记异常已经处理完毕filterContext.ExceptionHandled = true;base.OnException(filterContext);}}
}
在Action上面添加MyHandleError过滤器:
[MyHandleError]
public ActionResult GetErr()
{int a = 0;int b = 1 / a;return View();
}
创建异常错误友好提示页面error.html。
<body>自定义错误页面
</body>
运行会自动跳转到error.html页面。
如果页面没有跳转,就需要去Web.config配置文件中的<system.web>节点下面添加如下配置节点,开启自定义错误:
<customErrors mode="On"></customErrors>
通常这样的异常处理是放在全局过滤器上面的,只要任意Action方法报错就会执行MyHandleError过滤器中的代码。
修改App_Start目录下面的FilterConfig类:
public class FilterConfig
{public static void RegisterGlobalFilters(GlobalFilterCollection filters){//filters.Add(new HandleErrorAttribute());//添加全局授权过滤器filters.Add(new MyAuthorizeAttribute());//添加全局异常处理过滤器filters.Add(new MyHandleErrorAttribute());}
}
Global.asax下的代码:
using System;
using System.Collections.Generic;
using System.Linq;
using System.Web;
using System.Web.Mvc;
using System.Web.Optimization;
using System.Web.Routing;namespace MvcApp
{public class MvcApplication : System.Web.HttpApplication{protected void Application_Start(){AreaRegistration.RegisterAllAreas();FilterConfig.RegisterGlobalFilters(GlobalFilters.Filters);RouteConfig.RegisterRoutes(RouteTable.Routes);BundleConfig.RegisterBundles(BundleTable.Bundles);}}
}