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也做了缓存。