ASP.NET MVC三个重要的描述对象：ControllerDescriptor和ActionDescriptor的创建

不论是用于描述Controller的ControllerDescriptor，还是用于描述Action方法的ActionDescriptor，都具有同步和异步两个版本，那么这些不同类型的ControllerDescriptor的ActionDescriptor是在什么情况下创建的呢？

一、ControllerActionInvoker与AsyncControllerActionInvoker

ControllerDescriptor的创建设计到一个重要的名为ActionInvoker的组件，顾名思义，ActionInvoker专门用于Action方法的执行。我们会在本书第7章“Action方法的执行”中对ActionInvoker进行深入介绍，在这里我们只需要对其作一个简单的了解。

ActionInvoker实现了具有如下定义的IActionInvoker接口，唯一的方法实现了对指定Action方法的执行，而作为Controller的默认基类的Controller具有一个ActionInvoker属性，该属性表示的ActionInvoker被真正用于定义在该Controller类型中的所有Action方法的执行。

public interface IActionInvoker
{
    bool InvokeAction(ControllerContext controllerContext, string actionName);
}

public abstract class Controller
{
    //其它成员
    public IActionInvoker ActionInvoker { get; set; }
}

而具有如下定义的System.Web.Mvc.Async.IAsyncActionInvoker接口是ActionInvoker的异步版本。IAsyncActionInvoker继承了IActionInvoker接口，并在此基础上定义了两个BeginInvokeAction/EndInvokeAction方法用于Action方法的异步执行。

public interface IAsyncActionInvoker : IActionInvoker
{
    IAsyncResult BeginInvokeAction(ControllerContext controllerContext,  string actionName, AsyncCallback callback, object state);
    bool EndInvokeAction(IAsyncResult asyncResult);
}

ASP.NET MVC真正用于Action方法同步和异步执行的ActionInvoker分别是ControllerActionInvoker和AsyncControllerActionInvoker。如下面的代码片断所示，ControllerActionInvoker定义了一个受保护的方法GetControllerDescriptor用于根据指定的Controller上下文获取相应的ControllerDescriptor，它的子类AsyncControllerActionInvoker对这个方法进行了重写。

public class ControllerActionInvoker : IActionInvoker
{
    //其它成员
    protected virtual ControllerDescriptor GetControllerDescriptor( ControllerContext controllerContext);
}

public class AsyncControllerActionInvoker : ControllerActionInvoker,  IAsyncActionInvoker, IActionInvoker
{
    //其它成员
    protected override ControllerDescriptor GetControllerDescriptor( ControllerContext controllerContext);
}

我们所有要了解的是在默认情况下（没有对Controller类型的ActionInvoker属性进行显式设置）采用的ActionInvoker类型是哪个。ASP.NET MVC对Conroller采用的ActionInvoker类型的选择机制是这样的：

• 通过当前的DependencyResolver以IAsyncActionInvoker接口去获取注册的ActionInvoker，如果返回对象不为Null，则将其作为默认的ActionInvoker。
• 通过当前的DependencyResolver以IActionInvoker接口去获取注册的ActionInvoker，如果返回对象不为Null，则将其作为默认的ActionInvoker。
• 创建AsyncControllerActionInvoker对象作为默认的ActionInvoker。

在默认的情况下，当前的DependencyResolver直接通过对指定的类型进行反射来提供对应的实例对象，所以对于前面两个步骤返回的对象均为Null，所以默认创建出来的ActionInvoker类型为AsyncControllerActionInvoker。我们可以通过如下一个简单的实例来验证这一点。在通过Visual Studio的ASP.NET MVC项目模板创建的空Web应用中，我们创建了如下一个默认的HomeController，在Action方法Index中直接通过ContentResult将ActionInvoker属性的类型名称呈现出来。

public class HomeController : Controller
{
    public ActionResult Index()
    {
        return Content("默认ActionInvoker类型:" + this.ActionInvoker.GetType().FullName);
    }
}

当运行该Web应用时，会在浏览器上产生如下的输出结果，我们可以清楚地看到默认采用的ActionInvoker类型正是AsyncControllerActionInvoker。

默认ActionInvoker类型:System.Web.Mvc.Async.AsyncControllerActionInvoker

为了进一步验证基于DependencyResolver对ActionInvoker的提供机制，我们将在《ASP.NET MVC Controller激活系统详解：IoC的应用[下篇]》创建的基于Ninject的自定义NinjectDependencyResolver应用在这里。如下面的代码片断所示，在初始化NinjectDependencyResolver的时候，我们将IActionInvoker和IAsyncActionInvoker影射到两个自定义ActionInvoker类型，即FooActionInvoker和FooAsyncActionInvoker，它们分别继承自ControllerActionInvoker和AsyncControllerActionInvoker。

public class NinjectDependencyResolver : IDependencyResolver
{
    public IKernel Kernel { get; private set; }
    public NinjectDependencyResolver()
    {
        this.Kernel = new StandardKernel();
        AddBindings();
    }
    private void AddBindings()
    {
        this.Kernel.Bind<IActionInvoker>().To<FooActionInvoker>();
        this.Kernel.Bind<IAsyncActionInvoker>().To<FooAsyncActionInvoker>();
    }
    public object GetService(Type serviceType)
    {
        return this.Kernel.TryGet(serviceType);
    }
    public IEnumerable<object> GetServices(Type serviceType)
    {
        return this.Kernel.GetAll(serviceType);
    }
}
public class FooActionInvoker : ControllerActionInvoker
{}
public class FooAsyncActionInvoker : AsyncControllerActionInvoker
{}

在Global.asax中对NinjectDependencyResolver进行注册后运行我们的程序，会在浏览器中得到如下的输出结果。IAsyncActionInvoker和FooAsyncActionInvoker进行了影射，NinjectDependencyResolver可以通过IAsyncActionInvoker提供一个FooAsyncActionInvoker实例。

默认ActionInvoker类型:Artech.Mvc.FooAsyncActionInvoker

现在我们对NinjectDependencyResolver的定义稍加修改，将针对IAsyncActionInvoker接口的类型影射删除，只保留针对IActionInvoker的映射。

public class NinjectDependencyResolver : IDependencyResolver
{
    //其它成员
    private void AddBindings()
    {
        this.Kernel.Bind<IActionInvoker>().To<FooActionInvoker>();
        //this.Kernel.Bind<IAsyncActionInvoker>().To<FooAsyncActionInvoker>();
    }
}

再次运行我们的程序则会得到如下的输出结果。由于NinjectDependencyResolver只能通过IActionInvoker接口提供具体的ActionInvoker，所以最终被创建的是一个FooActionInvoker对象。这个实例演示告诉我们：当我们需要使用到自定义的ActionInvoker的时候，可以通过自定义DependencyResolver以IoC的方式提供具体的ActionInvoker实例。

默认ActionInvoker类型:Artech.Mvc.FooActionInvoker

二、ActionInvoker与ControllerDescriptor/ActionDescriptor

ControllerDescriptor和ActionDescriptor最终是为Model绑定服务的，而Model绑定是Action执行的一个环节，所以ControllerDescriptor最终是由相应的ActionInvoker创建的。总的来说，用于同步Action执行的ControllerActionInvoker创建ReflectedControllerDescriptor，而用于异步Action执行的AsyncControllerActionInvoker则创建ReflectedAsyncControllerDescriptor。ActionInvoker和ControllerDescriptor之间的关系可以通过如下图所示的UML来表示。

对于ReflectedControllerDescriptor来说，包含其中的ActionDescriptor类型均为ReflectedActionDescriptor。而ReflectedAsyncControllerDescriptor描述的Controller可以同时包含同步和异步的Action方法，所以它可以包含任何类型的ActionDescriptor。

具体来说，如果Action方法的返回类型为Task，对应的ActionDescriptor是一个TaskAsyncActionDescriptor对象。如果Action方法名称包含“Async”后缀，并且存在一个对应的以“Completed”后缀的方法，则对应的ActionDescriptor是一个ReflectedAsyncActionDescriptor对象；如果对应Completed方法不存在，对应的FindAction方法会直接抛出一个InvalidOperationException异常。在其它情况下的Action方法均是同步的，所以对应的ActionDescriptor类型为ReflectedActionDescriptor。ControllerDescriptor与ActionDescriptor之间的关系如下图所示的UML来表示。

三、实例演示：AsyncActionInvoker对ControllerDescriptor的创建

为了让读者对ActionInvoker对ControllerDescriptor的解析机制具有一个深刻的理解，同时也作为对该机制的验证，我们做一个简单的实例演示。通过前面的介绍我们知道在默认的情况下Controller采用AsyncControllerActionInvoker进行Action方法的执行，这个例子就来演示一下它生成的ControllerDescriptor是个怎样的对象。我们通过Visual Studio的ASP.NET MVC项目模板创建一个空Web应用，并创建一个默认的HomeController，然后对其进行如下的修改。

public class HomeController : AsyncController
{
    public void Index()
    {
        MethodInfo method = typeof(AsyncControllerActionInvoker).GetMethod("GetControllerDescriptor", BindingFlags.Instance | BindingFlags.NonPublic);
        ControllerDescriptor controllerDescriptor = (ControllerDescriptor)method.Invoke(this.ActionInvoker, new object[] { this.ControllerContext });
        Response.Write(controllerDescriptor.GetType().FullName + "<br/>");
        CheckAction(controllerDescriptor, "Foo");
        CheckAction(controllerDescriptor, "Bar");
        CheckAction(controllerDescriptor, "Baz");

    }
    private void CheckAction(ControllerDescriptor controllerDescriptor, string actionName)
    {
        ActionDescriptor actionDescriptor = controllerDescriptor.FindAction(this.ControllerContext, actionName);
        Response.Write(string.Format("{0}:{1}<br/>",actionName, actionDescriptor.GetType().FullName));
    }

    public void Foo() { }
    public void BarAsync() { }
    public void BarCompleted() { }
    public Task Baz()
    {
        return new Task(DoNothing);
    }
    public void DoNothing() { }
}

我们首先将HomeController的基类从Controller改为AsyncController，并定义了Foo、BarAsync/BarCompleted和Baz四个方法，我们知道它们对应着Foo、Bar和Baz三个Action，其中Foo是同步Action，Bar和Baz分别是两种不同定义形式（XxxAsync/XxxCompleted和Task）的异步Action。

CheckAction用于根据指定的Action名称从ControllerDescriptor对象中获取用于表示对应Action的ActionDescriptor对象，最终将类型名称呈现出来。在Index方法中，我们通过反射的方式调用当前ActionInvoker（一个AsyncControllerActionInvoker对象）的受保护方法GetControllerDescriptor或者用于描述当前Controller（HomeController）的ControllerDescriptor的对象，并将类型名称呈现出来。最后通过调用CheckAction方法将包含在创建的ControllerDescriptor对象的三个ActionDescriptor类型呈现出来。

当我们运行该程序的时候，在浏览器中会产生如下的输出结果，从中可以看出ControllerDescriptor类型为ReflectedAsyncControllerDescriptor。同步方法Foo对象的ActionDescriptor是一个ReflectedActionDescriptor对象；以XxxAsync/XxxCompleted形式定义的异步方法Bar对应的ActionDescriptor是一个ReflectedAsyncActionDescriptor对象；而返回类型为Task的方法Baz对应的ActionDescriptor类型则是TaskAsyncActionDescriptor。

System.Web.Mvc.Async.ReflectedAsyncControllerDescriptor
Foo:System.Web.Mvc.ReflectedActionDescriptor
Bar:System.Web.Mvc.Async.ReflectedAsyncActionDescriptor
Baz:System.Web.Mvc.Async.TaskAsyncActionDescriptor

 

ASP.NET MVC三个重要的描述对象：ControllerDescriptor
ASP.NET MVC三个重要的描述对象：ActionDescriptor
ASP.NET MVC三个重要的描述对象：ControllerDescriptor与ActionDescriptor的创建机制
ASP.NET MVC三个重要的描述对象：ParameterDescriptor