9.1.3 .net framework通过业务逻辑层自动生成WebApi的做法

首先需要说明的是这是.net framework的一个组件，而不是针对.net core的。目前工作比较忙，因此.net core的转换正在编写过程中，有了实现会第一时间贴出来。

接下来进入正题。对于大型的分层系统，会有一个应用程序层，应用程序层的主要作用是封装业务领域层的业务逻辑层，并对界面展示层提供服务。界面展示层例如有Web网站、移动应用、WPF等等，例如下图。

很多情况下，业务领域层中间的业务逻辑层方法和应用服务层的服务接口几乎是一致的。在业务逻辑方法编写完成后，编程人员，也会重复性的编写应用服务层。该层难度不大，但是属于重复性劳动并且工作量不小。对于一个有敬业精神的程序员来说，问题就来了，写一大堆不加思考的、工作量大的代码，还不如写一个框架自动通过业务逻辑层生成WebApi。

为了简化编程人员的工作量，减少错误的出现，我们编写了这个框架，就是通过业务逻辑层的方法自动生成应用服务层的服务。

 

其实ABP也有这个东西，但是发现ABP中的实现与Castle Windsor结合太紧密了，用了些Castle Windsor的特性。我等用Unity作为DI/IoC的无法借鉴。

 

要了解这个自动生成WebApi的框架，我们得简要的讲解下.net framework下webapi的请求处理过程。

Web API是微软的主导的一种面向服务的实现方式，已经集成在visual studio的模板中，是一种比较成熟的SOA数据服务方式。Web API的服务提供方式实现过程由三个步骤组成：路由匹配阶段；控制器选择和构建阶段；执行器选择和执行阶段。

 

 

 

 

 

 

 

 

 

 

缺省情况下，一个mvc项目包含webapi，会在app_start目录下有一个webapiconfig.cs文件。这个文件是webapi路由的设置，我们假设按照controller和action的名称进行路由，写法见下（尤其是routetemplate行）： 

        public static void Register(HttpConfiguration config)
        {
            // Web API 配置和服务

            // Web API 路由
            config.MapHttpAttributeRoutes();

            config.Routes.MapHttpRoute(
                name: "DefaultApi",
                routeTemplate: "api/{controller}/{action}/{id}",
                defaults: new { id = RouteParameter.Optional }
            );
        }

  

系统运行过程中，如果框架发现了URI的一个匹配，它会创建一个包含了每个占位符适用的值的字典集合。键是不包含大括号的占位符名称，例如controller、action。值是提取自URI路径或者表单提交的数据。该字典被存储在IHttpRouteData对象中。

在路由匹配阶段，"{controller}"和"{action}"占位符会被像其他占位符一样对待。它们被同其他值一起简单地存储在字典中。http://[server]/[appName]/api/user/get/1，路由字典将包含：

• Controller: user
• Action: get
• Id: 1

 

控制器选择和构建阶段

在一个路径匹配路由规则后，可以获得到Controller和Action，并存放与路由字典中。Web API的消息处理管道由一组HttpMessageHandler经过"首尾相连"而成。WebApi 最终会引导到默认的HttpControllerDispatcher处理，其中HttpControllerDispatcher实现了HttpMessageHandler接口。HttpControllerDispatcher实现了目标HttpController对象的激活、执行。

• HttpControllerDispatcher接收请求之后，会获取IHttpControllerSelector的实现（缺省是DefaultHttpControllerSelector），然后调用SelectController方法，创建HttpController的描述类HttpControllerDescriptor。
• HttpControllerDispatcher接下来调用HttpControllerDescriptor对象的CreateController方法得到激活的HttpController对象。对于这个HttpControllerDescriptor对象来说，当它的CreateController方法被调用之后，它会获取注册的IHttpControllerActivator对象（缺省是DefaultHttpControllerActivator），并调用其Create方法实现针对目标HttpController对象的激活并将激活的对象返回。
• DefaultHttpControllerActivator对象根据HttpController类型去获取代表目标HttpController实例的对象。如果后者返回一个具体的HttpController对象，该对象将直接作为方法的返回值，否则DefaultHttpControllerActivator直接采用反射的形式创建目标HttpController对象并返回。

 

执行器选择和调用阶段

ApiController是HttpController的基类。ApiController中的ExecuteAsync方法实现了Action的选择和执行。

• 首先执行GetActionSelector()方法，获取IHttpActionSelector的实现ApiControllerActionSelector，ApiControllerActionSelector调用SelectAction方法，构建用来描述HttpAction的HttpActionDescriptor..
• 然后创建Action的上下文，HttpActionContext。
• 最后执行GetActionInvoker方法，获取IHttpActionInvoker。紧接着调用ActionInvoker的InvokeActionAsync方法，执行Action并反馈HttpResponseMessage格式的数据。

至此，整个从路由到执行并返回结果的整个流程就结束了。

 

上面洋洋洒洒介绍了整个WeApi的路由和执行过程，下面我们就根据这个流程来确定如何加入我们修改的内容，以通过业务逻辑层的方法自动实现WebApi。业务逻辑层是一个个的逻辑实现类，类中包含了一个个的业务逻辑方法，例如UserService类包含了GetUser方法。我们最终的实现就是生成http://[server]/[appName]/User/GetUser的WebApi调用方式。做法是：

• 替换IHttpControllerSelector的实现DefaultHttpControllerSelector，将Controller的查找重定向到逻辑层的逻辑类
• 替换IHttpActionSelector的实现ApiControllerActionSelector，将Action的查找重定向到逻辑类的方法
• 替换IHttpActionInvoker的实现ApiControllerActionInvoker，将Action执行重定向到方法的执行

 

在替换之前，我们预先做了部分处理，在所有程序集中查找所有以AppService结尾的逻辑类，并将逻辑类生成为DynamicApiControllerInfo，注册进DynamicApiControllerManager中，逻辑类中的GetUser等方法生成为DynamicApiActionInfo，存放在DynamicApiControllerInfo的Actions属性中。该方式可以避免每次查找Controller和Action都要做反射的做法，提高系统执行效率。

这里，我们约定所有以AppService结尾的逻辑类都要自动生成WebApi，也可以根据情况写成继承IApplicationService接口的类自动生成WebApi。

    public static class DynamicApiBuilder
    {
        public static void Build()
        {
            IEnumerable<Type> types = ReflectionHelper.GetSubTypes<object>().Where(type => !type.IsAbstract && type.IsPublic && type.FullName.EndsWith("AppService"));

            foreach (Type type in types)
            {
                DynamicApiControllerInfo controllerInfo = GenerateApiControllerInfo(type);

                DynamicApiControllerManager.Register(controllerInfo);
            }
        }

        private static DynamicApiController GenerateApiController()
        {
            DynamicApiController controller = new DynamicApiController();

            return controller;
        }

        private static DynamicApiControllerInfo GenerateApiControllerInfo(Type type)
        {
            //10位是AppService
            DynamicApiControllerInfo controllerInfo = new DynamicApiControllerInfo(type);

            foreach (MethodInfo methodInfo in GetMethodsOfType(type))
            {
                DynamicApiActionInfo actionInfo = new DynamicApiActionInfo(methodInfo.Name, GetNormalizedVerb(methodInfo), methodInfo);

                controllerInfo.Actions.Add(actionInfo.ActionName, actionInfo);
            }

            return controllerInfo;
        }

        private static IEnumerable<MethodInfo> GetMethodsOfType(Type type)
        {
            var allMethods = new List<MethodInfo>();

            FillMethodsRecursively(type, BindingFlags.Public | BindingFlags.Instance, allMethods);
            //method.DeclaringType != typeof(ApplicationService) &&
            return allMethods.Where(method => method.DeclaringType != typeof(object) && !IsPropertyAccessor(method));
        }

        private static void FillMethodsRecursively(Type type, BindingFlags flags, List<MethodInfo> members)
        {
            members.AddRange(type.GetMethods(flags).Where(m => !members.Exists(mm => m.Name == mm.Name)));

            foreach (var interfaceType in type.GetInterfaces())
            {
                FillMethodsRecursively(interfaceType, flags, members);
            }
        }

        private static bool IsPropertyAccessor(MethodInfo method)
        {
            return method.IsSpecialName && (method.Attributes & MethodAttributes.HideBySig) != 0;
        }
    }

 

接下来实现DynamicApiControllerSelector，替换缺省的DefaultHttpControllerSelector。这个程序的主要做法是从路由信息RouteData中获取当前的Controller和Action等信息。根据Controller信息从DynamicApiControllerManager中获取已注册的DynamicApiControllerInfo，创建Controller的描述类DynamicApiControllerDescriptor。DynamicApiControllerManager就是预处理部分，将DynamicApiControllerInfo注册的类。

    public class DynamicApiControllerSelector : DefaultHttpControllerSelector
    {
        private readonly HttpConfiguration _Configuration;

        public DynamicApiControllerSelector(HttpConfiguration configuration)
            : base(configuration)
        {
            _Configuration = configuration;
        }

        public override HttpControllerDescriptor SelectController(HttpRequestMessage request)
        {
            if (request == null)
            {
                return base.SelectController(null);
            }

            var routeData = request.GetRouteData();
            if (routeData == null)
            {
                return base.SelectController(request);
            }

            //Get Area/Controller/Action from route
            object objArea;
            if (!routeData.Values.TryGetValue("area", out objArea))
            {
                return base.SelectController(request);
            }
            object objController;
            if (!routeData.Values.TryGetValue("controller", out objController))
            {
                return base.SelectController(request);
            }
            object objAction;
            if (!routeData.Values.TryGetValue("action", out objAction))
            {
                return base.SelectController(request);
            }

            string areaName = (string)objArea;
            string controllerName = (string)objController;
            string actionName = (string)objAction;

            //Normalize serviceNameWithAction
            if (actionName.EndsWith("/"))
            {
                actionName = actionName.Substring(0, actionName.Length - 1);
                routeData.Values["action"] = actionName;
            }

            DynamicApiControllerInfo controllerInfo = DynamicApiControllerManager.Get(areaName, controllerName);

            //Create the controller descriptor
            var controllerDescriptor = new DynamicApiControllerDescriptor(_Configuration, controllerInfo.AreaName, controllerInfo.ControllerName);
            controllerDescriptor.Properties["__MicroLibraryDynamicApiControllerInfo"] = controllerInfo;
            return controllerDescriptor;
        }
    }

 

下一步就是实现DynamicApiActionSelector，替换缺省的ApiControllerActionSelector。DynamicApiActionSelector重写了SelectAction方法，主要做法是Controller的上下文HttpControllerContext中获取当前的DynamicApiControllerInfo，创建Action的描述类DynamicApiActionDescriptor。

    public class DynamicApiActionSelector : ApiControllerActionSelector
    {
       public override HttpActionDescriptor SelectAction(HttpControllerContext controllerContext)
        {
            object controllerInfoObj;
            if (!controllerContext.ControllerDescriptor.Properties.TryGetValue("__MicroLibraryDynamicApiControllerInfo", out controllerInfoObj))
            {
                return GetDefaultActionDescriptor(controllerContext);
            }

            //Get controller information which is selected by HttpControllerSelector.
            var controllerInfo = controllerInfoObj as DynamicApiControllerInfo;
            MicroLibraryExceptionHelper.IsNull(controllerInfo, this.GetType().FullName, TraceLogType.Error, "DynamicApiControllerInfo in ControllerDescriptor.Properties is not a " + typeof(DynamicApiControllerInfo).FullName + " class.");

            string areaName = (string)controllerContext.RouteData.Values["area"];
            string controllerName = (string)controllerContext.RouteData.Values["controller"];
            string actionName = (string)controllerContext.RouteData.Values["action"];

            return GetActionDescriptorByActionName(controllerContext, controllerInfo, actionName);
        }

        private HttpActionDescriptor GetActionDescriptorByActionName(HttpControllerContext controllerContext, DynamicApiControllerInfo controllerInfo, string actionName)
        {
            //Get action information by action name
            DynamicApiActionInfo actionInfo;
            MicroLibraryExceptionHelper.FalseThrow(controllerInfo.Actions.TryGetValue(actionName, out actionInfo), this.GetType().FullName, TraceLogType.Error, "在Api Controller：" + controllerInfo.ControllerName + "中，没有对应的Action：" + actionName);
            MicroLibraryExceptionHelper.FalseThrow(actionInfo.Verb.IsEqualTo(controllerContext.Request.Method), this.GetType().FullName, TraceLogType.Error, "在Api Controller：" + controllerInfo.ControllerName + "中的Action：" + actionName + "的HttpVerb不正确，应该为：" + actionInfo.Verb);

            return new DynamicApiActionDescriptor(controllerContext.ControllerDescriptor, actionInfo.Method);
        }

        private HttpActionDescriptor GetDefaultActionDescriptor(HttpControllerContext controllerContext)
        {
            return base.SelectAction(controllerContext);
        }
    }

 

需要说明的是，我们只是按照ActionName来确定最终的Action。还可以按照HttpVeb来确定Actin的方式，我们没有使用该方式，因此没有实现，可以参照如下代码实现：

        private HttpVerb GetNormalizedVerb(MethodInfo methodInfo)
        {
            if (methodInfo.IsDefined(typeof(HttpGetAttribute)))
            {
                return HttpVerb.Get;
            }

            if (methodInfo.IsDefined(typeof(HttpPostAttribute)))
            {
                return HttpVerb.Post;
            }

            if (methodInfo.IsDefined(typeof(HttpPutAttribute)))
            {
                return HttpVerb.Put;
            }

            if (methodInfo.IsDefined(typeof(HttpDeleteAttribute)))
            {
                return HttpVerb.Delete;
            }

            if (methodInfo.IsDefined(typeof(HttpOptionsAttribute)))
            {
                return HttpVerb.Options;
            }

            if (methodInfo.IsDefined(typeof(HttpHeadAttribute)))
            {
                return HttpVerb.Head;
            }

            return HttpVerb.Get;
        }

        private HttpActionDescriptor GetActionDescriptorByCurrentHttpVerb(HttpControllerContext controllerContext, DynamicApiControllerInfo controllerInfo)
        {
            //Check if there is only one action with the current http verb
            var actionsByVerb = controllerInfo.Actions.Values.Where(action => action.Verb.IsEqualTo(controllerContext.Request.Method));

            MicroLibraryExceptionHelper.TrueThrow(actionsByVerb.Count() == 0, this.GetType().FullName, TraceLogType.Error, "在Api Controller：" + controllerInfo.ServiceName + "中，没有HttpVerb: " + controllerContext.Request.Method + "的Action");
            MicroLibraryExceptionHelper.TrueThrow(actionsByVerb.Count() > 1, this.GetType().FullName, TraceLogType.Error, "在Api Controller：" + controllerInfo.ServiceName + "中，HttpVerb: " + controllerContext.Request.Method + "的Action有多个");

            //Return the single action by the current http verb
            return new DynamicApiActionDescriptor(controllerContext.ControllerDescriptor, actionsByVerb.First().Method);
        }

 

再下一步就是实现DynamicApiActionInvoker，替换缺省的ApiControllerActionInvoker。DynamicApiActionInvoker实现了InvokeActionAsync方法，主要做法是获取Controller和Action的描述类DynamicApiControllerDescriptor、DynamicApiActionDescriptor。根据Controller的描述类获取DynamicApiControllerInfo，进一步获取ControllerInfo的ServiceType，这就是逻辑类的类型信息。通过我们自己的Ioc管理器IocManager，从DI容器中获取SerivceType的具体实现obj对象。然后从Action描述中获取MethodInfo，执行方法。返回结果信息，返回前在头部增加Access-Control-Allow-Origin等信息。

还有一点说明的是需要在Web.config中进行修改，modules中移除WebDavModule，handlers中移除WebDav和OPTIONSVerbHandler。

    public class DynamicApiActionInvoker : IHttpActionInvoker
    {
        private bool authenticatedFlag = DynamicApiConfiguration.GetConfig().AuthenticatedFlag;

        public Task<HttpResponseMessage> InvokeActionAsync(HttpActionContext actionContext, CancellationToken cancellationToken)
        {
            DynamicApiActionDescriptor actionDescriptor = actionContext.ActionDescriptor as DynamicApiActionDescriptor;
            DynamicApiControllerDescriptor controllerDescriptor = actionContext.ControllerContext.ControllerDescriptor as DynamicApiControllerDescriptor;

            DynamicApiControllerInfo controllerInfo = controllerDescriptor.Properties["__MicroLibraryDynamicApiControllerInfo"] as DynamicApiControllerInfo;

            object obj = IocManager.Instance.Resolve(controllerInfo.ServiceType);

            MicroLibraryExceptionHelper.FalseThrow(Verify(actionContext), this.GetType().FullName, TraceLogType.Error, "Token验证不通过！");

            //todo: 异常处理以及参数顺序问题
            object result = actionDescriptor.MethodInfo.Invoke(obj, actionContext.ActionArguments.Where(kvp => !string.Equals(kvp.Key, "sign", StringComparison.OrdinalIgnoreCase) || !string.Equals(kvp.Key, "appKey", StringComparison.OrdinalIgnoreCase)).Select(kvp => kvp.Value).ToArray());

            return Task.Run<HttpResponseMessage>(() =>
             {
                 string strResult;
                 if (result is String || result is Char)
                 {
                     strResult = obj.ToString();
                 }
                 else
                 {
                     strResult = SerializerHelper.ToJson(result);
                 }

                 var response = new HttpResponseMessage()
                 {
                     Content = new StringContent(strResult, Encoding.GetEncoding("UTF-8"), "application/json")
                 };

                 //需要在web.config中，system.webServer---modules---remove name="WebDavModule"
                 //---handlers---remove name="WebDav"和remove name="OPTIONSVerbHandler"
                 response.Headers.Add("Access-Control-Allow-Origin", "*");
                 response.Headers.Add("Access-Control-Allow-Headers", "X-Requested-With");
                 if (actionContext.Request.Method.Method == "Options")
                 {
                     response.Headers.Add("Access-Control-Allow-Methods", "*");
                     response.Headers.Add("Access-Control-Allow-Headers", "*");
                 }
                 return response;
             });
        }

        private bool Verify(HttpActionContext actionContext)
        {
            if (!authenticatedFlag) return true;

            var attrs = actionContext.ActionDescriptor.GetCustomAttributes<AllowAnonymousAttribute>();
            if (attrs.Any()) return true;

            string appKey = (string)actionContext.ActionArguments["appCode"];

            return DynamicApiHelper.ValidAppSecretSign(actionContext.ActionArguments, appKey);
        }
    }

 

大家可能还注意到我们有Verify方法。这个方法是判断对WebApi是否有权限访问。在这种Rest形式的服务中，服务接口对外部暴露出来，因此对用户调用的授权尤为重要。在Dynamic WebAPI的安全实现过程中，使用了JWT（JsonWebToken）技术，这里就不做赘述了。

 

面向云的.net core开发框架