ASP.NET WebAPI 10 Action的选择(二)

在本系列的第二篇简要的讲述了Action的选择条件本篇深入讲述一下Action选择的过程在上一篇中我们已经讲到了Controller的激活过程中已经说到了设置Controller的ControllerContext，再接着就是调用HttpController的ExectuteAsync方法.在该方法中大致可以分成两步：选择HttpActionDescriptor，参数绑定，执行Aciton。

 

HttpActionDescriptor

如HttpControllerDescriptor一样，HttpActionDescriptor也保存了Action的基本信息。并提供了执行的方法(ExecuteAsync)。

 

public abstract class HttpActionDescriptor

 { 

public abstract string ActionName { get; } 

public HttpConfiguration Configuration { get; set; } 

public HttpControllerDescriptor ControllerDescriptor { get; set; } 

public virtual ConcurrentDictionary<object, object> Properties { get; } 

public abstract Type ReturnType { get; } 

public virtual Collection<Net.Http.HttpMethod> SupportedHttpMethods { get; } 

public abstract Task<object> ExecuteAsync(HttpControllerContext controllerContext, IDictionary<string, object> arguments, CancellationToken cancellationToken); 

public virtual Collection<T> GetCustomAttributes<T>() where T : class; 

public virtual Collection<T> GetCustomAttributes<T>(bool inherit) where T : class; 

public virtual Collection<Filters.IFilter> GetFilters(); 

 }

 

与HttpControllerDescriptor一样，Configuration也是引用GlobalConfiguration.Configuration，ActionName与ReturnType分别表示Action的名称与返回值。SupportedHttpMethods表示Action能够支持的HttpMethod集合。HttpActionDescriptor同样具有一个只读属性Properties，可以用它来添加数据到HttpActionDescriptor上。

 

在WebAPI中对HttpActionDescriptor的默认派生类是ReflectedHttpActionDescriptor。

 

public class ReflectedHttpActionDescriptor : HttpActionDescriptor

 { 

public MethodInfo MethodInfo { get; set; } 

}

 

 

 

对于HttpActionDescriptor,ReflectedHttpActionDescriptor只增加了一个MethodInfo，我们从ReflectedHttpActionDescriptor的命名与MethodInfo属性就可以想到ReflectedHttpActionDescriptor采用反射的方式去执行Action。

 

HttpParameterDescriptor

对于Action的参数，它不仅要参与Action的选择，同时在进行WebAPI在对参数绑定的时候也有较复杂的逻辑，所以WebAPI对Action的参数也进行了封装，即HttpParameterDescriptor。

 

public abstract class HttpParameterDescriptor

 { 

public HttpActionDescriptor ActionDescriptor { get; set; } 

public HttpConfiguration Configuration { get; set; } 

public virtual object DefaultValue { get; } 

public virtual bool IsOptional { get; } 

public virtual ParameterBindingAttribute ParameterBinderAttribute { get; set; } 

public abstract string ParameterName { get; } 

public abstract Type ParameterType { get; } 

public virtual string Prefix { get; } 

public ConcurrentDictionary<object, object> Properties { get; } 

public virtual Collection<T> GetCustomAttributes<T>() where T : class; 

 }

 

 

 

 

在HttpActionDescriptor的GetParameters方法就是返回Action下的HttpParameterDescriptor集合。

WebAPI中HttpParameterDescriptor的派生类是ReflectedHttpParameterDescriptor。

 

 

HttpActionSelector

HttpActionSelector也是WebAPI中的"标准化组件"顾名思义它是来查找Action的。

 

public interface IHttpActionSelector

{ 

ILookup<string, HttpActionDescriptor> GetActionMapping(HttpControllerDescriptor controllerDescriptor); 

HttpActionDescriptor SelectAction(HttpControllerContext controllerContext); 

}

 

 

 

与HttpControllerSelector,IHttpActionSelector也提供了两方法： GetActionMapping, SelectAction，分别用来返回Controller下的所有Action与请求的Action。

 

因为反射在解析方法的时候是相对耗时的操作，所以ReflectionActionDescriptor也做了缓存。