【转】ABP源码分析三十五：ABP中动态WebAPI原理解析

古城微笑少年丶 2022-11-19 09:51 352阅读 0赞

动态WebAPI应该算是ABP中最Magic的功能之一了吧。开发人员无须定义继承自ApiController的类，只须重用Application Service中的类就可以对外提供WebAPI的功能，这应该算是对DRY的最佳诠释了. 如下图所示，一行代码就为所有实现了IApplicationService的类型，自动创建对应的动态WebAPI.

![64288d8ebb00dc0f0b96af66fe1e774a.png][]

这么Magic的功能是如何实现的呢？

本文为你揭开其Magic的外表。你会发现，实现如此Magic的功能，最关键的代码只有四行。

--------------------

先思考一个问题：如果不从ASP.NET WebApi 的ApiController继承，我们能实现ASP.NET WebAPi吗？

答案：不可以. 从APIController继承来实现我们自己的HttpController是实现ASP.NET WebApi的前提。

那么问题又来了。我们在使用ABP框架的时候，没有创建任何从APIController继承的类。那么从APIController继承的类在哪里?和ApplicationService中的类又有怎样的关系？

先给出答案：ABP框架自动给ApplicationService中的类创建了“HttpController”，他们从APIController继承。

基于上面的分析，要实现WebApi有三个问题需要解决：如何定义HttpController？路由的规则如何设置？如何激活和调用HttpController中的Action？接下来逐一解答。

--------------------

如何定义HttpController？

ABP中ApplicationService并不是从APIController继承，或实现IHttpController接口。为解决HttpController类型缺失的问题，ABP首先为所有的ApplicationService动态的创建一个DynamicApiController<T> ，这个类继承自AbpApiController，其中T是接口继承自IApplicationService。

但是DynamicApiController<T> 是一个空的类，其没有任何Action. 这样的HttpController类显然无用的。那么如何给这些动态生成的DynamicApiController<T>对象根据T（ApplicationService接口）中对应的方法添加相对应的Action？

看似复杂的问题，ABP以一种巧妙的办法解决了，关键就在AbpWebApiModule中的4行代码（下面59-62行）。这里简单解释一下ABP的做法：

1. 通过Castle创建DynamicApiController<T>的代理类，

2. 为代理类动态添加ApplicationService接口（这里就是指T，也就是让代理类实现了接口T，这样通过代理类就可以访问接口T中定义的方法），

3. 同时为代理类添加拦截器。

这样当ABP通过Castle获取DynamicApiController<T>实例的时候，其实得到的是DynamicApiController<T>的代理类（关键）。 通过DynamicApiController<T>的代理类调用ApplicationService的接口中的定义的方法的时候（必须通过反射的方式调用，因为接口T中的方法对DynamicApiController<T>实例是不可见的。但实际上是可见的，因为你得到的是从T接口继承的DynamicApiController<T>的代理类实例，而不是DynamicApiController<T>实例本身。），会被拦截器拦截。而拦截器则调用真正的ApplicationService对象来执行方法（这里也很关键，因为代理类中只要方法的声明，没有实现。所以这里需要拦截器将其方法调用拦截并路由到真正的ApplicationService对象上）。对这四行代码不理解的话可先阅读下文：[http://www.cnblogs.com/1zhk/p/5399548.html][http_www.cnblogs.com_1zhk_p_5399548.html] 。

举个例子：

假设有一个ApplicationService的接口是IFooAppication.

第59行，DynamicApiController<IFooAppication>被register到Castle容器中。

第60行，为DynamicApiController<IFooAppication>创建proxy代理，并为该代理添加接口IFooAppication。

第61行，为proxy代理添加拦截器AbpDynamicApiControllerInterceptor<IFooAppication>

![81fbd7dd5e14207d412b68dfa8aff64e.png][]

--------------------

路由的规则如何设置？

通过AbpWebApiModule的InitializeRoutes方法硬编码在Abp.Web.Api的代码中。很明显这里路由使用了\*通配符，也就是所有api/services/XXXX的请求都是有效的，都会进入WebApi的消息管道。

![30585e582b74285602011bf9e5a2a6e0.png][]

如何根据routedata激活和调用具体生成的DynamicApiController<T>对象?

ABP通过AbpWebApiModule的InitializeAspNetServices方法使用自定义的对象替换了默认的IhttpControllerSelector对象，IHttpActionSelector对象，IHttpControllerActivatore对象。如果了解ASP.Net WebApi底层工作原理的开发人员一定对这三个接口应该很熟悉。如果不了解的同学要先做做功课，才能明白后文的内容。

![0748d4f3c5ea08ef86dc8c938f70b1db.png][]

![c8f76292a0f9303c541c99878fac62e6.png][]

至此，大概解释了ABP的动态WebApi的工作原理。

--------------------

以下是对与动态WebAPI相关的接口和对象逐一分析。这些接口和类都围绕着两个中心目标：为动态Controller创建可供ASP.NET WebApi使用的描述器和选择器（Descriptor，Selector），以及构建和保存动态Controller的类型信息。

首先看看ApiController和Configuration

AbpApiController：继承了MVC的ApiController，ABP 中的WebApi Controller直接或间接的都从AbpApiController继承。第二张图，显示了AbpApiController引用了哪些ABP核心类库中的功能模块的对象。

IDynamicApiController：空接口，用于标识其实现是一个动态生成的ApiController。

DynamicApiController<T>：用作所有动态生成的ApiController的基类。

![e1e7f125d4801110eaac02ccb00297ac.png][]

![65bfb49ccc634f9c8abe17b4ba88baf1.png][]

IAbpWebApiModuleConfiguration/AbpWebApiModuleConfiguration : 封装了HttpConfiguration属性，初始化为GlobalConfiguration.Configuration对象。 因为ASP.NET Web API在Web Host下通过ASP.Net的静态类型GlobalConfiguration的Configuration属性获取到的用于配置请求处理管道的HttpConfiguration对象。ABP的动态WebApi本质上仍是ASP.NET Web API，所以这样配置HttpConfiguration是必然的。

![753ac5b06c02b18b7431e51e149c4226.png][]

--------------------

与Controller激活和调用相关的接口和类主要有下面这些。其实都是继承自ASP.NET WebAPi中默认的使用的对象，并重载了一些方法以支持动态APiController的发现，激活和调用。

DynamicHttpControllerDescriptor : 继承自asp.net Webapi系统的HttpControllerDescriptor,与ASP.NET WebAPI 中默认的HttpControllerDescriptor相比，其多了一个IFilter\[\]数组。这样做的原因很简单，因为ABP中的ApiController是动态生成的，是没有标注Filter特性的。所以ABP通过下面这种方式给动态ApiController加上Filter。

![7d7bc15a39498c640b7400b21fae67f1.png][]

DynamicHttpActionDescriptor : 继承自asp.net Webapi系统的ReflectedHttpActionDescriptor,与ASP.NET WebAPI 中默认的HttpActionDescriptor相比，其多了一个IFilter\[\]数组。这样做的原因和上面一致

![f46da7e19e10ff65a3ab0c22068404f5.png][]

AbpHttpControllerSelector : 继承自asp.net Webapi系统的DefaultHttpControllerSelector。通过重写SelectController来返回HttpControllerDescriptor， 这是ABP能动态创建APIController的关键。ASP.Net  WebAPI 中的IHttpControllerSelector对象负责根据HttpRouteData返回HttpControllerDescriptor。HttpControllerDescriptor中封装了controller的类型等信息。这里ABP通过继承DefaultHttpControllerSelector，并重写SelectController方法来根据HttpRouteData中的数据创建HttpControllerDescriptor对象并返回

![978120399631a113a5678590bfc0e698.png][]

AbpApiControllerActivator：实现了IHttpControllerActivator接口，根据controllerType生成具体的controller. 由于ABP系统使用了Castle框架来管理对象。所以有必要实现自己的IHttpControllerActivator以替换ASP.Net系统默认的实现。

![63ded69df83eb0aa0db4a2f34691009f.png][]

AbpApiControllerActionSelector : 继承自ASP.Net WebAPI 的 ApiControllerActionSelector。 通过重写SelectAction来返回HttpActionDescriptor的派生类DynamicHttpActionDescriptor的实例， 这是ABP能执行动态创建的APIController的Action方法的关键。AbpApiControllerActionSelector 通过调用DynamicApiServiceNameHelper的静态方法（传入routedata中的serviceNameWithAction）获取action的那么

DynamicApiServiceNameHelper：静态类，提供四个静态方法。两个方法用于校验servicename是否合规，还有两个方法用于servicename中获取service和action的name。

![f4e5851db70bbefa84c91e7c52e16356.png][]

AbpDynamicApiControllerInterceptor<T> ： 实现了Castle的IInterceptor。作为动态生成的DynamicApiController<T>的拦截器，它拦截所有对action的调用，然后通过反射调用底层真实的IApplicationService对象的方法。

![1b7814014c302d30d0755ced1b85a09b.png][]

--------------------

在传统的asp.net webapi应用中，系统会根据路由信息，通过反射到程序集中去匹配对应的controller的类型信息。而在ABP中，controller的类型信息是初始化的时候直接添加到一个Dictionary集合中的。本文第一幅图中的代码干的就是这件事。完成这个功能模块所涉及的接口和类主要有以下这些。

上图代码中所示，构建DynamicHttpControllerDescriptor 的数据来源于一个DynamicApiControllerInfo对象。那么DynamicApiControllerInfo对象又是在什么时候怎么构建的呢？下图是ABP关于构建applicationService的DynamicApiControllerInfo对象所涉及的类型和接口。

![47800350b50c28e99bcd713e210b0aab.png][]

DynamicApiControllerInfo：ABP用于封装ApiController的信息,下图显示了其所有的属性。其中最关键的属性就是ApiControllerType.其实就是一个DynamicApiController<T>类型，其中的T就是具体的ApplicationService接口的类型。

![8bb5a418410b5bcd0291aaa17bc5a323.png][]

DynamicApiActionInfo：用于封装动态生成的ApiController的Action的信息：actionName，Filters, methondinfo和httpVerb。DynamicApiControllerInfo封装了一个DynamicApiActionInfo的字典对象，用以表示这个Controller可支持的Action列表。

![1d69bdff321eeb91056d880f8a25828f.png][]

DynamicApiControllerManager：提供了一个Dictionary容器管理所有的DynamicApiControllerInfo对象。共有三个方法：Register方法用于将DynamicApiControllerInfo添加到Dictionary容器中，另外两个方法用于返回DynamicApiControllerInfo。

![62477ee4c6c9fc8c573805b03c7cdd29.png][]

DynamicApiControllerBuilder：提供两个方法，一个For<T>方法通过ApiControllerBuilder为某一个application service类创建DynamicApiControllerInfo。另一个ForAll<T>方法通过BatchApiControllerBuilder为某一类application service类（这一类application service会有个共同的接口）创建DynamicApiControllerInfo。

IApiControllerBuilder<T>/ApiControllerBuilder<T>：其内部封装了一个字典对象IDictionary<string, ApiControllerActionBuilder<T>>用于存放T的每个方法对应的ApiControllerActionBuilder对象。最后通过调用Build()方法生成完整的DynamicApiControllerInfo对象。这里注意观察IApiControllerBuilder的代码，他是支持链式编程的，可以通过WithFilters的方法给这个Application Service的API controller添加filter

![4668ffb422a4d03f52099f335777ce9d.png][]

![9eb40e16bbf98009145bf4945930cb06.png][]

IBatchApiControllerBuilder<T>/BatchApiControllerBuilder<T> : 为assembly中符合命名规范的接口批量生成DynamicApiControllerInfo。其最后仍然是通过ApiControllerBuilder逐个为各个application service接口创建DynamicApiControllerInfo.

![ba529827ad4279ad818a34605297ab78.png][]

![ddd8467977038d478ce327f06acd66d9.png][]

如下图，ApiControllerBuilder在构建DynamicApiControllerInfo过程中，需要调用ApiControllerActionBuilder对象去构建该DynamicApiControllerInfo所包含的DynamicApiActionInfo

![cb45dfab5a442d7b8ca33da84f135531.png][]

![657995b1e41aa5ae567fd8c394008c2a.png][]

DynamicApiControllerActionHelper：静态类，用于获取一个type的所有方法（property除外,object的原生方法除外，ApplicationService除外）的列表。

![50e457cc784b9fffee0798f077f47e34.png][]

![07056eca24bc75d6e6b39cd42b718bd7.png][]

DynamicApiVerbHelper：根据方法名按照约定返回httpVerb。

![8f1a772600d3be2e838e1e6be69c4b6a.png][]

IApiControllerActionBuilder/ApiControllerActionBuilder:用于构建DynamicApiActionInfo对象的生成器。这里有一个注意点：如上图，如果action的methodName是以get开头的，默认ABP会标注其httpVerb为Get， 但是有一个例外，如果方法的参数不为primitive 类型和不可为空类型时，ABP会标注其httpVerb为Post。

--------------------

AbiApiExplorer：继承自ApiExplorer类，实现了IApiExplorer接口。其ApiDescriptions属性既包括你自己编写的webApi （39-44行）又包括ABP动态生成的WebApi（47 -）。

ABP通过遍历DynamicApiControllerManager中的DynamicControllerInfo，然后在遍历DynamicControllerInfo的DynamicApiActionInfo，为他们逐个构建ApiDescription实例。

![70b22d935686a0fdea884f387cdec011.png][]

![ed3c6621e0f8b7f893fcf8d06187d372.png][]

返回[ABP源码分析系列文章目录][ABP]

[64288d8ebb00dc0f0b96af66fe1e774a.png]: /images/20221119/b26e8fe73b9048c48a5bb23886865f99.png
[http_www.cnblogs.com_1zhk_p_5399548.html]: http://www.cnblogs.com/1zhk/p/5399548.html
[81fbd7dd5e14207d412b68dfa8aff64e.png]: /images/20221119/ccff52b62e6a4a5da8c627566c737c91.png
[30585e582b74285602011bf9e5a2a6e0.png]: https://img-blog.csdnimg.cn/img_convert/30585e582b74285602011bf9e5a2a6e0.png
[0748d4f3c5ea08ef86dc8c938f70b1db.png]: https://img-blog.csdnimg.cn/img_convert/0748d4f3c5ea08ef86dc8c938f70b1db.png
[c8f76292a0f9303c541c99878fac62e6.png]: https://img-blog.csdnimg.cn/img_convert/c8f76292a0f9303c541c99878fac62e6.png
[e1e7f125d4801110eaac02ccb00297ac.png]: https://img-blog.csdnimg.cn/img_convert/e1e7f125d4801110eaac02ccb00297ac.png
[65bfb49ccc634f9c8abe17b4ba88baf1.png]: https://img-blog.csdnimg.cn/img_convert/65bfb49ccc634f9c8abe17b4ba88baf1.png
[753ac5b06c02b18b7431e51e149c4226.png]: https://img-blog.csdnimg.cn/img_convert/753ac5b06c02b18b7431e51e149c4226.png
[7d7bc15a39498c640b7400b21fae67f1.png]: https://img-blog.csdnimg.cn/img_convert/7d7bc15a39498c640b7400b21fae67f1.png
[f46da7e19e10ff65a3ab0c22068404f5.png]: https://img-blog.csdnimg.cn/img_convert/f46da7e19e10ff65a3ab0c22068404f5.png
[978120399631a113a5678590bfc0e698.png]: https://img-blog.csdnimg.cn/img_convert/978120399631a113a5678590bfc0e698.png
[63ded69df83eb0aa0db4a2f34691009f.png]: https://img-blog.csdnimg.cn/img_convert/63ded69df83eb0aa0db4a2f34691009f.png
[f4e5851db70bbefa84c91e7c52e16356.png]: https://img-blog.csdnimg.cn/img_convert/f4e5851db70bbefa84c91e7c52e16356.png
[1b7814014c302d30d0755ced1b85a09b.png]: https://img-blog.csdnimg.cn/img_convert/1b7814014c302d30d0755ced1b85a09b.png
[47800350b50c28e99bcd713e210b0aab.png]: https://img-blog.csdnimg.cn/img_convert/47800350b50c28e99bcd713e210b0aab.png
[8bb5a418410b5bcd0291aaa17bc5a323.png]: https://img-blog.csdnimg.cn/img_convert/8bb5a418410b5bcd0291aaa17bc5a323.png
[1d69bdff321eeb91056d880f8a25828f.png]: https://img-blog.csdnimg.cn/img_convert/1d69bdff321eeb91056d880f8a25828f.png
[62477ee4c6c9fc8c573805b03c7cdd29.png]: https://img-blog.csdnimg.cn/img_convert/62477ee4c6c9fc8c573805b03c7cdd29.png
[4668ffb422a4d03f52099f335777ce9d.png]: https://img-blog.csdnimg.cn/img_convert/4668ffb422a4d03f52099f335777ce9d.png
[9eb40e16bbf98009145bf4945930cb06.png]: https://img-blog.csdnimg.cn/img_convert/9eb40e16bbf98009145bf4945930cb06.png
[ba529827ad4279ad818a34605297ab78.png]: https://img-blog.csdnimg.cn/img_convert/ba529827ad4279ad818a34605297ab78.png
[ddd8467977038d478ce327f06acd66d9.png]: https://img-blog.csdnimg.cn/img_convert/ddd8467977038d478ce327f06acd66d9.png
[cb45dfab5a442d7b8ca33da84f135531.png]: https://img-blog.csdnimg.cn/img_convert/cb45dfab5a442d7b8ca33da84f135531.png
[657995b1e41aa5ae567fd8c394008c2a.png]: https://img-blog.csdnimg.cn/img_convert/657995b1e41aa5ae567fd8c394008c2a.png
[50e457cc784b9fffee0798f077f47e34.png]: https://img-blog.csdnimg.cn/img_convert/50e457cc784b9fffee0798f077f47e34.png
[07056eca24bc75d6e6b39cd42b718bd7.png]: https://img-blog.csdnimg.cn/img_convert/07056eca24bc75d6e6b39cd42b718bd7.png
[8f1a772600d3be2e838e1e6be69c4b6a.png]: https://img-blog.csdnimg.cn/img_convert/8f1a772600d3be2e838e1e6be69c4b6a.png
[70b22d935686a0fdea884f387cdec011.png]: https://img-blog.csdnimg.cn/img_convert/70b22d935686a0fdea884f387cdec011.png
[ed3c6621e0f8b7f893fcf8d06187d372.png]: https://img-blog.csdnimg.cn/img_convert/ed3c6621e0f8b7f893fcf8d06187d372.png
[ABP]: http://www.cnblogs.com/1zhk/p/5268054.html