ASP.NET MVC5学习笔记之Filter基本介绍

Filter是ASP.NET MVC框架提供的基于AOP(面向方面)设计，提供在Action执行前后做一些非业务逻辑通用处理,如用户验证，缓存等。现在来看看Filter相关的一些类型信息。

一.基本类型

1. Filter类型，描述筛选器信息的元数据类型，具体定义如下:

     public class Filter
     {
         //     表示一个用于指定筛选器的默认顺序的常数。
         public const int DefaultOrder = -;

         public Filter(object instance, FilterScope scope, int? order);

         public object Instance { get; protected set; }

         public int Order { get; protected set; }

         public FilterScope Scope { get; protected set; }
     }

通过代码了解可以了解到它封装了筛选器的实例(Instance属性)，调用的顺序(Order属性)和应用的范围(Scope属性)。Order值越小，调用优先级越高。Scope通过FilterScope枚举定义,它的定义如下：

 public enum FilterScope
  {

         First = ,
         Global = ,
         Controller = ,
         Action = ,
         Last = ,
 }

当两个同类型的Filter的Order相同时，则Scope来决定调用顺序，和Order一样，值越小，调用优先级越高。Scope通常是在FilterProvier中指定的。

2. FilterAttribute类型

对于Controller和Action Leve的Filter通常是以属性(Attribute)的应用，ASP.NET MVC提供了一个Filter属性基类FilterAttribute,定义如下:

 [AttributeUsage(AttributeTargets.Class | AttributeTargets.Method, Inherited = true, AllowMultiple = false)]
     public abstract class FilterAttribute : Attribute, IMvcFilter
     {

         protected FilterAttribute();
         public bool AllowMultiple { get; }
         public int Order { get; set; }
     }

属性AllowMultiple和Order是接口IMvcFilter的成员,定义如下:

  public interface IMvcFilter
     {
         bool AllowMultiple { get; }
         int Order { get; }
     }

AllowMultiple表示是否可指定筛选器特性的多个实例， Order属性设置Filter执行顺序，最终会传给Filter类型.

3.ActionFilterAttribute类型

ActionFilterAttribute一般用于在Action上或ActionResult创建Filter的基类,定义如下:

  [AttributeUsage(AttributeTargets.Class | AttributeTargets.Method, Inherited = true, AllowMultiple = false)]
     public abstract class ActionFilterAttribute : FilterAttribute, IActionFilter, IResultFilter
     {
         // The OnXxx() methods are virtual rather than abstract so that a developer need override
         // only the ones that interest him.

         public virtual void OnActionExecuting(ActionExecutingContext filterContext)
         {
         }

         public virtual void OnActionExecuted(ActionExecutedContext filterContext)
         {
         }

         public virtual void OnResultExecuting(ResultExecutingContext filterContext)
         {
         }

         public virtual void OnResultExecuted(ResultExecutedContext filterContext)
         {
         }
     }

二.特定Filter介绍

 1. IAuthenticationFilter

　　IAuthenticationFilter是MVC5新增加Filter类型，允许实现自定义的身份验证。通过前面的介绍，我们知道它执行在最前面。接口定义如下:

 public interface IAuthenticationFilter
     {

         void OnAuthentication(AuthenticationContext filterContext);

         void OnAuthenticationChallenge(AuthenticationChallengeContext filterContext);
     }

　 由于前面的小节已介绍，这里不再赘述. Controller类实现了该接口， 仅提供了虚方法实现

2. IAuthorizationFilter

　 该接口执行在Action方法和ActionFilter之前，提供用户授权或其它检查的机会.它的接口定义如下:

  public interface IAuthorizationFilter
     {
         void OnAuthorization(AuthorizationContext filterContext);
     }

　 有一系列类实现了该接口:

　　

　　a. ValidateAntiForgeryTokenAttribute

　　ValidateAntiForgeryTokenAttribute 是为防止CSRF(Cross-Site Request Forgery)跨站请求伪造攻击而设计，关于CSRF这里不介绍了，这个属性和HtmlHelper.AntiForgeryToken方法协作，在HtmlHelper.AntiForgeryToken中，生成一个加密的Token放在cookie里，同时在Form里生成一个隐藏的字段，保存与Token相匹配的值，当页面提交时，ValidateAntiForgeryTokenAttribute将验证cookie设置值与Form隐藏字段的值是否匹配，不匹配的话就说明请求是伪造的

　　b.ValidateInputAttribute

　　表示对请示输入进行验证的标识，防止网站的恶意攻击，如XSS

　　它是设置Controller.ValidateRequest属性，具体的验证在HttpRequest.ValidateInput方法中

　　c.ChildActionOnlyAttribute

　　标识Action只能作为子Action调用, 当调用Html.Action方法会一个当前Action的ViewContext放到RouteData中,key 为ParentActionViewContextToken,ChildActionOnlyAttribute检查RouteData的Key中是否存在ParentActionViewContextToken

　　d.AuthorizeAttribute

　　检查用户是否通过验证(IPrincipal.IIdentity.IsAuthenticated)，用户或角色是否在声明的列表中,另外如查Controller 或Action标识为AllowAnonymousAttribute将跳过验证

　　e.RequireHttpsAttribute

　　检查当前的连接HttpContext.Request.IsSecureConnection

3. IActionFilter与IResultFilter

　 这两个接口分别定义的方法执行在Action执行前后和ActionResult执行前后

 public interface IActionFilter
     {
         void OnActionExecuting(ActionExecutingContext filterContext);
         void OnActionExecuted(ActionExecutedContext filterContext);
     }

 public interface IResultFilter
     {
         void OnResultExecuting(ResultExecutingContext filterContext);
         void OnResultExecuted(ResultExecutedContext filterContext);
     }

　　相关的继承体系如下所示:

　　a. OutputCacheAttribute

　　缓存Action的执行结果，可以指定多种缓存策略和参数，基本的使用见这里http://www.asp.net/mvc/tutorials/older-versions/controllers-and-routing/improving-performance-with-output-caching-cs

　　主Action和子Action处理策略有点不同，具体见这里的分析http://www.cnblogs.com/majiang/archive/2012/11/23/2784881.html

　　另外值得一提的是，当你缓存的内容也许有部分片断需要更新， 比如电子商务的产品展示页面，有一个页面浏览数要实时更新，这个时候可以利用HttpResponse.WriteSubstitution方法动态更新这个字段,可以参考这里http://www.asp.net/mvc/tutorials/older-versions/controllers-and-routing/adding-dynamic-content-to-a-cached-page-cs

　　b. AsyncTimeoutAttribute

　　设置异步操作的超时时间，在OnActionExecuting中Controller的AsyncManager的Timeout属性

4. IExceptionFilter  

　　在Action或其它Filter执行过程中，处理抛出的特定异常

 public interface IExceptionFilter
     {
         void OnException(ExceptionContext filterContext);
     }

继承体系如下所示:

　　

　　a. HandleErrorAttribute

　　　　声明异常处理，你可以声明一个异常处理类型(默认是Exception,也就是可以处理所有异常)，声明错误处理页面(默认是Error),另外有两点值得注意:

　　　　1. 未开启自定义异常错误模式时，这个属性不启作用

　　　　　　<system.web>

　　　　　　　　<customErrors mode="On"></customErrors>
　　　　　　</system.web>

　　　　2. 只处理http状态码是500的错误

　　　　详细请参见这里http://freshbrewedcode.com/jonathancreamer/2011/11/29/global-handleerrorattribute-in-asp-net-mvc3/

　　b. OutputCacheAttribute

　　　　前面已介绍，这里是发生异常对子Action的缓存做些清理工作.

5. IOverrideFilter

　　　 这个接口是MVC5新加的，允许你在更低一级的范围清除或覆盖上一级的Filter。定义接口下:

 public interface IOverrideFilter
     {
         Type FiltersToOverride { get; }
     }

只有一个属性，只明要覆写的Filter类型，具体的类族关系如下图:

　　

关于详细使用参见以下链接

http://weblogs.asp.net/imranbaloch/archive/2013/09/25/new-filter-overrides-in-asp-net-mvc-5-and-asp-net-web-api-2.aspx

http://www.davidhayden.me/blog/filter-overrides-in-asp-net-mvc-5

参考

Filtering in ASP.NET MVC

http://msdn.microsoft.com/en-us/library/gg416513(v=vs.98).aspx

Understanding ASP.NET MVC Filters and Attributes

http://www.dotnet-tricks.com/Tutorial/mvc/b11a280114-Understanding-ASP.NET-MVC-Filters-and-Attributes.html

ASP.NET MVC框架揭密