大家是怎么做APP接口的版本控制的?欢迎进来看看我的方案。升级版的Versioning资料

本文主要介绍大家是怎么做APP接口的版本控制的?欢迎进来看看我的方案。升级版的Versioning资料 方法和在新技术下所面对的“挑战”,方便大家深入理解大家是怎么做APP接口的版本控制的?欢迎进来看看我的方案。升级版的Versioning资料 过程。本文也将分享大家是怎么做APP接口的版本控制的?欢迎进来看看我的方案。升级版的Versioning资料 所遇到的问题和应对策略,怎么解决怎么做的问题。
通过深入本文可以理解代码原理,进行代码文档的下载,也可以查看相应 Demo 部署效果。

背景

APP不同于网站,网站程序一发版,所有用户看到的都是最新的页面、调用最新的接口,没有新老版本一说。APP一旦下载到用户手机上,用户不更新你拿他一点办法都没有,但是随着业务的调整,同一个接口的请求参数和输出JSON有变化的话,就需要考虑老版本的兼容问题了。

举个例子:某APP的1.0.0版,服务端用户信息接口(api/User/UserInfo)输出的JSON如下

{   "status": 200,   "message": "ok",   "data": {     "userId": 10001,     "userNickName": "oppoic",     "userName": "汪杰",     "userEmail": "oppoic@163.com",     "userBlog": "https://www.cnblogs.com/oppoic/",     "userPic": "https://pic.cnblogs.com/avatar/401362/20180415232220.png"   } }

1.0.0版上线之后,产品迭代增加需求:一级菜单加一个付费用户入口,APP一打开就要动态判断当前用户是否付费。几个研发一商量,把用户是否vip的状态放到用户信息接口最合适。修改后服务端用户信息接口(api/User/UserInfo)输出如下

{   "status": 200,   "message": "ok",   "data": {     "user": {       "id": 10001,       "nickName": "oppoic",       "name": "汪杰",       "email": "oppoic@163.com",       "blog": "https://www.cnblogs.com/oppoic/",       "pic": "https://pic.cnblogs.com/avatar/401362/20180415232220.png"     },     "vip": true   } }

修改前后的JSON有如下变化:

1)增加了是否vip字段;

2)为了结构更清晰,原来的userId、userName、userPic等属性移到到user对象下;

接口改好了之后APP端通过data.vip就可以判断当前用户是否vip了,同时也把原来data.userName改成了data.user.name等等。都改好后升了一个版本号,由原来的1.0.0改成了1.0.1发到了各大商店。

但是一上线就出问题了:升级1.0.1的用户打开个人信息页面正常,但是未升级的1.0.0用户打开个人信息页面报错

VM211:1 Uncaught TypeError: Cannot read property 'name' of undefined at <anonymous>:1:16

原因是服务端个人信息接口的输出JSON改了,只能适配1.0.1的新版APP,无法满足老用户了。

有人说需求变了我就改服务端接口名称,老用户调老接口,新用户调新接口。这个方法是可以,但是接口多了简直就是一场灾难,项目从此无法维护。

路由方案

通过配置路由来区分不同版本的接口

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

APP端请求:api/v1/User/UserInfo,这种方案缺点如下:

1)版本号通常都是三段式的,例:1.0.1,硬套这个的话,服务端要建个命名空间带“.”的文件,C#对“.”支持不太友好。如果要改成1_0_1或1-0-1服务端是可以了,但APP端又得转下格式,怎么都有点别扭;

2)这个路由配得太死,1.0.1就是1.0.1的路由,APP端带1.0.2来就调不通。实际场景中后端没法完全对应APP版本,APP甚至连审核不通过重新提交都需要修改版本号,后端必须能向前兼容;

3)最后一个问题最致命:方法不可以复用,1.0.1版本的UserController里写了10个方法,1.0.2版只改了其中1个方法,还得把其他9个方法都原样搬过来。

理想的效果应该是这样:APP请求接口的时候把版本号(这个版本号就是上架各大商店的版本号)放到请求header里,服务端根据版本号找控制器,找到了直接调用,没有的话就向前找;同时方法也要向前找,带着这些需求寻找解决方案。

versioning

找下网络上的方案,aspnet-api-versioning用的最多,原来不止我一个人有这个需求。这个Versioning是微软出的,同时支持Core,简直靠谱,建个Web API项目试试

 大家是怎么做APP接口的版本控制的?欢迎进来看看我的方案。升级版的Versioning

NuGet安装

Web API:Install-Package Microsoft.AspNet.WebApi.Versioning

Core:Install-Package Microsoft.AspNetCore.Mvc.Versioning

修改WebApiConfig.cs

public static class WebApiConfig {     public static void Register(HttpConfiguration config)     {         config.MapHttpAttributeRoutes();          config.Routes.MapHttpRoute(             name: "DefaultApi",             routeTemplate: "api/{controller}/{action}/{id}",             defaults: new { id = RouteParameter.Optional }         );          config.AddApiVersioning(c =>         {             c.ReportApiVersions = true;//是否在请求头中返回受支持的版本信息             c.ApiVersionReader = new HeaderApiVersionReader("version");//header里版本号的键名             c.AssumeDefaultVersionWhenUnspecified = true;//请求没有指明版本的情况下是否使用默认的版本             c.DefaultApiVersion = new ApiVersion(1, 0);//默认的版本号         });     } }

新建两个UserController

大家是怎么做APP接口的版本控制的?欢迎进来看看我的方案。升级版的Versioning

代码

namespace webApiVersioning.Controllers.v1 {     [ApiVersion("1.0")]     public class UserController : ApiController     {         [HttpGet]         public string Get()         {             return "1.0";         }     } }

namespace webApiVersioning.Controllers.v2 {     [ApiVersion("2.0")]     public class UserController : ApiController     {         [HttpGet]         public string Get()         {             return "2.0";         }     } }

header里version分别传1.0和2.0效果如下

大家是怎么做APP接口的版本控制的?欢迎进来看看我的方案。升级版的Versioning 大家是怎么做APP接口的版本控制的?欢迎进来看看我的方案。升级版的Versioning

从输出来看,前端调用相同的接口,通过传递不同的version参数触发了服务端不同控制器的方法。但是缺点明显:

1)版本号没法配置成三段式的,现在所有商店里APP的版本都是三段式的;

2)跟上面的路由方案一样,没法向前找控制器。verson传3.0,不会自动找到2.0的控制器,不够灵活;

3)更不支持向前找方法。。。

终极方案

微软出的Versioning既然不能满足需求就自己实现一个,难点就一个:根据APP端传来的版本号触发对应的控制器。

版本号好获取,控制器也可以建个User{version}Controller,那怎么做到APP端带101的版本号请求UserController,服务端根据传的101自动转到User101Controller呢?

利用搜索引擎找到了System.Web.Http.Dispatcher命名空间下的DefaultHttpControllerSelector类,下面有个GetControllerName方法

// 摘要: //     获取指定 System.Net.Http.HttpRequestMessage 的控制器的名称。 // // 参数: //   request: //     HTTP 请求消息。 // // 返回结果: //     指定 System.Net.Http.HttpRequestMessage 的控制器的名称。 public virtual string GetControllerName(HttpRequestMessage request)

根据请求request获取指定控制器名称,那岂不是可以请求UserController,实际触发User101Controller了。建一个CustomHeaderControllerSelector继承DefaultHttpControllerSelector类,重写下GetControllerName方法试一试

public class CustomHeaderControllerSelector : DefaultHttpControllerSelector {     public CustomHeaderControllerSelector(HttpConfiguration cfg) : base(cfg)     { }      public override string GetControllerName(HttpRequestMessage request)     {         var controllerRequest = base.GetControllerName(request);//User         return controllerRequest + "101";//User101     } }

注册到Global.asax里

public class WebApiApplication : System.Web.HttpApplication {     protected void Application_Start()     {         GlobalConfiguration.Configure(WebApiConfig.Register);         GlobalConfiguration.Configuration.Services.Replace(typeof(IHttpControllerSelector), new CustomHeaderControllerSelector(GlobalConfiguration.Configuration));     } }

新建一个User101Controller

public class User101Controller : ApiController {     [HttpGet]     public string UserInfo()     {         return "101";     } }

项目里并没有UserController,请求下试试

大家是怎么做APP接口的版本控制的?欢迎进来看看我的方案。升级版的Versioning

可以看出,请求的是UserController,触发的是User101Controller,完美了。再建一个User102Controller

public class User102Controller : ApiController {     [HttpGet]     public string UserInfo()     {         return "102";     } }

完善下GetControllerName方法

public override string GetControllerName(HttpRequestMessage request) {     var controllerRequest = base.GetControllerName(request);     if (request.Headers.Contains("version"))     {         var headerVersion = request.Headers.GetValues("version").First();         if (string.IsNullOrEmpty(headerVersion))             return controllerRequest;         else             return controllerRequest + headerVersion.Replace(".", "");     }     return controllerRequest; }

分别请求下试试

大家是怎么做APP接口的版本控制的?欢迎进来看看我的方案。升级版的Versioning大家是怎么做APP接口的版本控制的?欢迎进来看看我的方案。升级版的Versioning

至此,已经实现了和微软的Versioning一模一样的功能,并且还支持了三段式的版本号。

下一个问题:如何向前找控制器?例:APP版本号到了1.0.2,但是1.0.2这个版本服务端只改了一个控制器的,大部分控制器都没有1.0.2版,如何调用1.0.2实际触发1.0.1呢?

场景:APP 1.0.1版上线,服务端有两个控制器 User101Controller、Employee101Controller。1.0.2版User控制器有接口变化,加了一个User102Controller,Employee控制器无变化不加,1.0.2上线后服务端就有3个控制器了,APP端调所有接口传的都是当前版本号1.0.2,访问User触发的是User102Controller,访问Employee触发的是Employee101Controller,这就是所谓的向前兼容。

如何实现呢?还是在GetControllerName方法里做文章

大家是怎么做APP接口的版本控制的?欢迎进来看看我的方案。升级版的Versioning

如图DefaultHttpControllerSelector里还有另一个虚方法GetControllerMapping,这个方法可以获取当前项目里所有的控制器名称。这就简单了:获取到的是User101、User102,如果请求来的是User102直接返回User102,如果请求来的是User103,那么挨个比大小,还是返回User102。此方法可行,但是思考了一下,每次请求过来都要做如下操作:

1)获取项目所有控制器;

2)截取控制器名称后的版本号;

3)排序;

4)比大小。

步骤多,有点浪费性能,而且还容易出错。直接使用配置的方式,只比大小,其他步骤都省略。新建PublicConst.cs,把项目所有的控制器和对应的版本号都写到VersionList这个全局变量里

public class PublicConst {     public static List<Vsn> VersionList     {         get         {             return new List<Vsn>()             {                 //注:版本必须【由小到大】添加                 new Vsn() { Controller = "User", Ver = "1.0.1" },                 new Vsn() { Controller = "User", Ver = "1.0.2" },             };         }     } }  public class Vsn {     public string Controller { get; set; }     public string Ver { get; set; } }

现在请求过来是1.0.3,从配置里拿到了1.0.1和1.0.2,常规做法是根据“.”分割,然后挨个比数字大小,还要考虑4段、5段以及段数不一样的版本号比大小,这样代码写着就没边了,还容易出bug。System命名空间下有Version类,调方法就可以比大小,用起来

public static string CompareVersion(string version, List<string> vsns) {     var newestVersion = string.Empty;     if (string.IsNullOrEmpty(version) || vsns.Count == 0)     {         return newestVersion;     }      Version verCurrent = new Version(version);     for (int i = vsns.Count - 1; i >= 0; i--)//倒叙查提高效率:新版的用户比老用户多     {         if (verCurrent >= new Version(vsns[i]))         {             newestVersion = vsns[i];             break;         }     }     return newestVersion; }

按照上面的思路继续改造下GetControllerName方法

public override string GetControllerName(HttpRequestMessage request) {     var controllerRequest = base.GetControllerName(request);     var controllerWithVersion = controllerRequest;     if (request.Headers.Contains("version"))     {         var headerVersion = request.Headers.GetValues("version").First();         if (!string.IsNullOrEmpty(headerVersion))         {             controllerWithVersion = controllerRequest + headerVersion.Replace(".", "");             if (!GetControllerMapping().ContainsKey(controllerWithVersion))             {                 var lsVersion = PublicConst.VersionList.Where(x => x.Controller == controllerRequest).ToList().ConvertAll(t => t.Ver);                 var newestVersion = Utils.CompareVersion(headerVersion, lsVersion);                 if (!string.IsNullOrEmpty(newestVersion))                     controllerWithVersion = controllerRequest + newestVersion.Replace(".", "");                 else                     controllerWithVersion = controllerRequest;             }         }     }     return controllerWithVersion; }

调用试试

大家是怎么做APP接口的版本控制的?欢迎进来看看我的方案。升级版的Versioning

由图可见,已经能向前找控制器了。还剩一个问题:如何向前找方法?场景:APP已经更新到1.0.3了,但是有一个方法一直没有修改,还在1.0.1的控制器里面,1.0.2里面都没有这个方法。这个时候直接调1.0.3的控制器可以定位到1.0.2控制器没问题,但是1.0.2控制器下没有这个方法,如何转到1.0.1控制器,并调用其下面的这个方法呢?

回头看看刚才的接口配置对象VersionList

public static List<Vsn> VersionList {     get     {         return new List<Vsn>()         {             //注:版本必须【由小到大】添加             new Vsn() { Controller = "User", Ver = "1.0.1" },             new Vsn() { Controller = "User", Ver = "1.0.2" },         };     } }

在这个里面配置每个版本控制器里面包含的方法,每次对比版本的时候判断下方法是否存在即可

public static List<Vsn> VersionList {     get     {         return new List<Vsn>()         {             //注:版本必须【由小到大】添加             new Vsn() { Controller = "User", Ver = "1.0.1", Actions = new List<string>(){ "Get","Test"} },
      
new Vsn() { Controller = "User", Ver = "1.0.2", Actions = new List<string>(){ "Get"} },
     };
  }
}

弊端:方法多了,维护太费劲,怎么能实现自动向前找方法呢?这里就要返璞归真了,想想面向对象三大特征:继承、封装和多态

使用继承的方式即可。第一个版本全是虚方法,后面每个版本继承上一个版本,如果接口有修改就override上一个版本的接口即可。

User101Controller代码:

public class User101Controller : ApiController {     [HttpGet]     public virtual string UserInfo()     {         return "101";     }      [HttpGet]     public virtual string Test()     {         return "Test:101";     } }

User102Controller代码:

public class User102Controller : User101Controller {     [HttpGet]     public override string UserInfo()     {         return "102";     } }

请求下试试

大家是怎么做APP接口的版本控制的?欢迎进来看看我的方案。升级版的Versioning

根据VersionList维护的版本号,没有User103就找User102,但是User102下面并没有Test方法,Test方法在User101下面,这个时候由于User102继承了User101,也可以找到User101下的Test方法。

APP 1.0.3版本User控制器没有变化就不建控制器,1.0.4的时候User控制器加了一个Test2方法继续virtual,等待被下一个版本override

public class User104Controller : User102Controller {     [HttpGet]     public virtual string Test2()     {         return "Test2:104";     } }

记得维护到VersionList

public static List<Vsn> VersionList {     get     {         return new List<Vsn>()         {             //注:版本必须【由小到大】添加             new Vsn() { Controller = "User", Ver = "1.0.1" },             new Vsn() { Controller = "User", Ver = "1.0.2" },             new Vsn() { Controller = "User", Ver = "1.0.4" },         };     } }

看下最终成果

大家是怎么做APP接口的版本控制的?欢迎进来看看我的方案。升级版的Versioning大家是怎么做APP接口的版本控制的?欢迎进来看看我的方案。升级版的Versioning

至此,大功告成。

以上是我的方案,仅抛砖引玉,欢迎大家补充。 本文地址:https://www.cnblogs.com/oppoic/p/13367878.html

思考

看下核心的GetControllerName方法

 1 public override string GetControllerName(HttpRequestMessage request)  2 {  3     var controllerRequest = base.GetControllerName(request);  4     var controllerWithVersion = controllerRequest;  5     if (request.Headers.Contains("version"))  6     {  7         var headerVersion = request.Headers.GetValues("version").First();  8         if (!string.IsNullOrEmpty(headerVersion))  9         { 10             controllerWithVersion = controllerRequest + headerVersion.Replace(".", ""); 11             if (!GetControllerMapping().ContainsKey(controllerWithVersion)) 12             { 13                 var lsVersion = PublicConst.VersionList.Where(x => x.Controller == controllerRequest).ToList().ConvertAll(t => t.Ver); 14                 var newestVersion = Utils.CompareVersion(headerVersion, lsVersion); 15                 if (!string.IsNullOrEmpty(newestVersion)) 16                     controllerWithVersion = controllerRequest + newestVersion.Replace(".", ""); 17                 else 18                     controllerWithVersion = controllerRequest; 19             } 20         } 21     } 22     return controllerWithVersion; 23 }

本方案向前找控制器是通过对比版本大小实现的,如果接口访问频率超高(比如APP日活百万),有个优化方案:看看上面代码11行,如果当前请求的控制器不存在就向前找,把线上APP最新版本的控制器都建一遍,直接继承上一个控制器,不需要重写任何方法,这样就不用对比版本了,提升了性能。

另外再看版本号维护类VersionList

public static List<Vsn> VersionList {     get     {         return new List<Vsn>()         {             //注:版本必须【由小到大】添加             new Vsn() { Controller = "User", Ver = "1.0.1" },             new Vsn() { Controller = "User", Ver = "1.0.2" },             new Vsn() { Controller = "User", Ver = "1.0.4" },         };     } }

版本号对比是挨个对比,没法集中对比,所以必须按顺序维护起来,但是如果哪天粗心搞错了,或者添加了重复的版本号怎么处理?在Application_Start项目启动的时候检测下这个VersionList即可。

最后说下版本号,User1110Cotroller到底表示哪个版本?11.1.0还是1.11.0,这块也可以优化下,建成User1_11_0Controller就可以了。

环境

Visual Studio 2017  .NET Framework 4.5.2  Web API

参考

https://www.cnblogs.com/linhuiy/p/12668535.html

https://www.dotnetcurry.com/aspnet/1185/aspnet-web-api-versioning-angularjs-app

https://github.com/aspnet/AspNetWebStack/blob/master/src/System.Web.Http/Dispatcher/DefaultHttpControllerSelector.cs

大家是怎么做APP接口的版本控制的?欢迎进来看看我的方案。升级版的Versioning资料部分资料来自网络,侵权毕设源码联系删除

区块链毕设网(www.qklbishe.com)全网最靠谱的原创区块链毕设代做网站
部分资料来自网络,侵权联系删除!
资源收费仅为搬运整理打赏费用,用户自愿支付 !
qklbishe.com区块链毕设代做网专注|以太坊fabric-计算机|java|毕业设计|代做平台 » 大家是怎么做APP接口的版本控制的?欢迎进来看看我的方案。升级版的Versioning资料

提供最优质的资源集合

立即查看 了解详情