Action 方法的执行(一)

    public interface IAsyncController : IController
    {
        IAsyncResult BeginExecute(RequestContext requestContext, AsyncCallback callback, object state);
        void EndExecute(IAsyncResult asyncResult);
    }
}

    public abstract class ControllerDescriptor : ICustomAttributeProvider, IUniquelyIdentifiable
    {
        //根据 ControllerContext 和 Action的名称获取指定的 Action的描述信息
        public abstract ActionDescriptor FindAction(ControllerContext controllerContext, string actionName)
        
        //获取指定Controller 下定义的所有的有效的 Action的信息
        public abstract ActionDescriptor[] GetCanonicalActions();
        
        //ICustomAttributeProvider 接口方法，获取指定Controller类型上使用的所有特性(Attribute) 的信息，参数 inherit 表示是否进行递归查找
        public virtual object[] GetCustomAttributes(bool inherit);
        //同属 ICustomAttributeProvider 接口方法，返回指定类型标识的自定义属性数组
        public virtual object[] GetCustomAttributes(Type attributeType, bool inherit);
        
        //获取 Controller 类型上使用的过滤器属性
        public virtual IEnumerable<FilterAttribute> GetFilterAttributes(bool useCache);
        
        //ICustomAttributeProvider接口方法，判断指定类型的自定义属性是否存在
        public virtual bool IsDefined(Type attributeType, bool inherit);
      
        //控制器的名称
        public virtual string ControllerName;
        //控制器的类型
        public abstract Type ControllerType { get; }
        //IuniquelyIdentifiable接口成员
        public virtual string UniqueId;//当前类型的唯一标识，由控制器名称、控制器类型以及当前类的类型生成
}

//属性部分
public MethodInfo[] ActionMethods { get; private set; }//当前Controller下所有Action方法集合

public HashSet<MethodInfo> StandardRouteMethods { get; private set; }//所有 Action 方法的 HashSet集合

public MethodInfo[] AliasedMethods{get;}//所有具有别名的Action方法的集合
 
public ILookup<string, MethodInfo> NonAliasedMethods{get;private set;};//所有没有别名的方法的集合

private StandardRouteActionMethodCache CreateStandardRouteCache()//Action 方法缓存，该类是该类内部的一个私有类，内部仅具有两个属性，分别表示无别名的 Action 方法的集合和具有别名方法的集合。

//方法部分
protected void Initialize(Type controllerType);//负责对上述的属性进行初始化

protected abstract bool IsValidActionMethod(MethodInfo methodInfo);//判断给定方法是否为有效的 Action方法，基本的判定标准即上面说的那些

//根据给定的 Action 名称获取对应的ActionMethod，在该方法中首先从缓存的具有别名的方法集合和无别名的方法集合中筛选中具有指定名称的方法，然后改根据请求的方法(Post、Get等)对上一步得到的集合进行筛选，移除不满足的项
protected List<MethodInfo> FindActionMethods(ControllerContext controllerContext, string actionName);

//获取指定 Method 的 ActionName，如果方法没有别名则直接返回它本身的名称，如果方法有 ActionNameSelector 属性修饰，则返回其Name属性
public string GetActionName(MethodInfo methodInfo)

//根据指定的 ActionName 获取对应的 ActionMethod，内部调用 FindActionMethods,如果不存在，返回 null,具有多个时抛出 AmbiguousMatchException 异常
public MethodInfo FindActionMethod(ControllerContext controllerContext, string actionName)

    delegate ActionDescriptor ActionDescriptorCreator(string actionName, ControllerDescriptor controllerDescriptor);}

public abstract class ActionDescriptor : ICustomAttributeProvider, IUniquelyIdentifiable
{
 /*****************************属性部分*********************************/
 //当前 Action 方法的名称
 public abstract string ActionName { get; }
 
 //当前 Action 所在的 Controller相关的 ControllerDescriptor
 public abstract ControllerDescriptor ControllerDescriptor { get; }
 
 //Asp.net mvc 自定义的基于 Dictinary 的线程安全的缓存集合，后面会介绍
 internal ActionMethodDispatcherCache DispatcherCache{get{..};set{..}
 
  public virtual string UniqueId{};//IUniquelyIdentifiable 接口成员，当前类型实例的唯一标识
  由当前类型、ControllerDescriptor、ActionName三者计算产生

/***************************** 方法部分 ***********************************/

/ICustomAttributeProvider 接口方法，功能不在赘述，但这里并没有提供具体的实现，前两个返回的均为空的 object[]
public virtual object[] GetCustomAttributes(bool inherit);

public virtual object[] GetCustomAttributes(Type attributeType, bool inherit);

public virtual bool IsDefined(Type attributeType, bool inherit);

//其它方法
public abstract object Execute(ControllerContext controllerContext, IDictionary<string, object> parameters);//ActionDescriptor 类型的核心方法，Action 方法的返回的 ActionResult 便是由该方法的返回结果处理转换产生的

//根据跟定的 ParameterInfo 去 parameters中寻找指定的参数值，key 为 parameterInfo.Name,查找失败、参数类型不匹配、查找值为空但参数不能为空时抛出异常
internal static object ExtractParameterFromDictionary(ParameterInfo parameterInfo, IDictionary<string, object> parameters, MethodInfo methodInfo);

//作用同上面的方法，但在出现上述抛出异常的情况时会使用默认值替代而不是抛出异常，这里的默认值有两种，一种是直接在方法参数后使用等号赋值的，如Say(string name = "tom"),另外一种是在 model 类的属性上使用 DefaultValueAttribute 设置的默认值，前者具有更高的优先级
internal static object ExtractParameterOrDefaultFromDictionary(ParameterInfo parameterInfo, IDictionary<string, object> parameters);

//获取所有定义在当前 Action 上的过滤器Filters
public virtual IEnumerable<FilterAttribute> GetFilterAttributes(bool useCache);

//获取所有的参数信息
public abstract ParameterDescriptor[] GetParameters();

public override object Execute(ControllerContext controllerContext, IDictionary<string, object> parameters)
        {
            if (controllerContext == null)
            {
                throw new ArgumentNullException("controllerContext");
            }
            if (parameters == null)
            {
                throw new ArgumentNullException("parameters");
            }

            // Performance sensitive so avoid Linq or delegates.
            ParameterInfo[] parameterInfos = MethodInfo.GetParameters();
            object[] parametersArray = new object[parameterInfos.Length];
            for (int i = 0; i < parameterInfos.Length; i++)
            {
                ParameterInfo parameterInfo = parameterInfos[i];
                object parameter = ExtractParameterFromDictionary(parameterInfo, parameters, MethodInfo);
                parametersArray[i] = parameter;
            }

            ActionMethodDispatcher dispatcher = DispatcherCache.GetDispatcher(MethodInfo);
            object actionReturnValue = dispatcher.Execute(controllerContext.Controller, parametersArray);
            return actionReturnValue;
        }

//属性部分
public event EventHandler Finished;//异步操作完成时的回调事件

public OperationCounter OutstandingOperations { get; private set; }//当前执行的异步操作的计数器

public IDictionary<string, object> Parameters { get; private set; }//异步操作与回调操作之间参数传递的集合

public int Timeout{get;set;}//异步操作的超时时间，单位为毫秒，默认值为 45*1000

//方法部分
public virtual void Finish()；//异步操作完成时的回调函数

public virtual void Sync(Action action);异步操作的执行函数，内部调用 SynchronizationContext 实例的同名方法

public abstract class ParameterDescriptor : ICustomAttributeProvider
    {
        //参数所属的 Action 的 ActionDescriptor
        public abstract ActionDescriptor ActionDescriptor { get; }

        //参数绑定信息，例如参数值的获取路径(Querstring、Form表单等)、参数是否需要进行绑定，是否具有某些前缀等信息
        public virtual ParameterBindingInfo BindingInfo{get;}

        //参数默认值
        public virtual object DefaultValue}{get;}
        
        //参数名称
        public abstract string ParameterName { get; }

        //参数类型
        public abstract Type ParameterType { get; }

        //以下为 ICustomAttributeProvider 接口方法
        public virtual object[] GetCustomAttributes(bool inherit);
        
        public virtual object[] GetCustomAttributes(Type attributeType, bool inherit);
       
        public virtual bool IsDefined(Type attributeType, bool inherit);
    }