首页 > 代码库 > Web API过滤器
Web API过滤器
Web API包含在操作方法执行之前或之后添加额外的逻辑的过滤器。过滤器可用于提供横切特性,比如日志记录、异常处理、性能测量、身份验证和授权等等。
过滤器可以应用于Web API控制器或一个或多个操作方法上的属性。每个过滤器是必须实现System.Web.Http.Filters命名空间中的IFilter接口的类。然而,System.Web.Http.Filters命名空间还包括其他其他可用于创建特定过滤器的接口和类。
下表列出了可用于创建Web API过滤器的重要的接口和类。
过滤器类型 | 接口 | 类 | 描述 |
简单的过滤 | IFilter | - | 定义一个过滤器中使用的方法 |
Action方法过滤器 | IActionFilter | ActionFilterAttribute | 用于添加额外的逻辑操作方法执行之前或之后。 |
身份验证过滤器 | IAuthenticationFilter | - | 用于迫使用户或客户执行操作方法之前验证。 |
授权过滤器 | IAuthorizationFilter | AuthorizationFilterAttribute | 用来限制特定的用户或组访问操作方法。 |
异常过滤器 | IExceptionFilter | ExceptionFilterAttribute | 用于处理Web API所有未处理的异常。 |
覆盖过滤器 | IOverrideFilter | - | 用于定制其他过滤器的行为。 |
正如你所看到的,上面的表列举了一些过滤器器类型的类以及接口。接口包含了您的自定义属性类中必须实现的方法,而过滤器类则已经实现了这些方法。这些方法便于Web API可以覆盖添加额外的逻辑。例如,ActionFilterAttribute类包括可以覆盖的方法。我们只需要覆盖想要覆盖的方法,但是如果你使用IActionFilter属性,你必须实现的所有方法。
访问MSDN了解System.Web.Http.Filters命名空间下的所有可用的类和接口。
让我们创建一个用来记录日志的LogAttribute类,来展示Action过滤器。
首先,创建一个继承自ActionFilterAttribute类的LogAttribute类,如下所示。
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
|
public class LogAttribute : ActionFilterAttribute { public LogAttribute() { } public override void OnActionExecuting(HttpActionContext actionContext) { Trace.WriteLine( string .Format( "Action Method {0} executing at {1}" , actionContext.ActionDescriptor.ActionName, DateTime.Now.ToShortDateString()), "Web API Logs" ); } public override void OnActionExecuted(HttpActionExecutedContext actionExecutedContext) { Trace.WriteLine( string .Format( "Action Method {0} executed at {1}" , actionExecutedContext.ActionContext.ActionDescriptor.ActionName, DateTime.Now.ToShortDateString()), "Web API Logs" ); } } |
在上面的例子中,LogAttribute来源于ActionFilterAttribute类并覆盖OnActionExecuting和OnActionExecuted方法用来记录日志到跟踪侦听器。(你也可以使用你自己的日志类来记录日志到文本文件或其他介质。)
创建LogAttribute类的另一种方法是通过实现IActionFilter接口并派生属性类,如下所示。
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
|
public class LogAttribute : Attribute, IActionFilter { public LogAttribute() { } public Task<HttpResponseMessage> ExecuteActionFilterAsync(HttpActionContext actionContext, CancellationToken cancellationToken, Func<Task<HttpResponseMessage>> continuation) { Trace.WriteLine( string .Format( "Action Method {0} executing at {1}" , actionContext.ActionDescriptor.ActionName, DateTime.Now.ToShortDateString()), "Web API Logs" ); var result = continuation(); result.Wait(); Trace.WriteLine( string .Format( "Action Method {0} executed at {1}" , actionContext.ActionDescriptor.ActionName, DateTime.Now.ToShortDateString()), "Web API Logs" ); return result; } public bool AllowMultiple { get { return true ; } } } |
在上面的例子中,继承于属性类使其是一个属性,实现IActionFilter使LogAttribute类是一个Action过滤器。
现在,您可以在控制器或操作方法中应用[Log]属性如下所示。
1
2
3
4
5
6
7
8
9
10
11
12
|
[Log] public class StudentController : ApiController { public StudentController() { } public Student Get() { //provide implementation } } |
现在,它将记录所有StudentController的请求。因此您可以用这种方法对横切关注点创建过滤器。
出处:http://www.yuanjiaocheng.net/webapi/webapi-filters.html#Web API过滤器
Web API过滤器