WebAPI多版本管理介绍及实现方案详解

1.什么是 API 的多版本？说白了就是多版本共存的问题。为方便大家理解我就举个例子吧，大家想必都用过Jquery吧，它的1.*版本做到了对低版本IE的支持；2.*版本还保留着ajax，但是不再支持老旧浏览器；3.*版本连ajax都不留了；但是用户不会升级、用户拒绝升级等原因，造成这些旧版本也需要运行，但是新版却已经修改了规范与旧版旧版冲突了。造成这些旧版本也需要运行使用。再例如我们手机有Andr

nic7968

3501人浏览 · 2018-06-26 14:30:22

nic7968 · 2018-06-26 14:30:22 发布

1.什么是 API 的多版本？

说白了就是多版本共存的问题。为方便大家理解我就举个例子吧，大家想必都用过Jquery吧，它的1.*版本做到了对低版本IE的支持；2.*版本还保留着ajax，但是不再支持老旧浏览器；3.*版本连ajax都不留了；但是用户不会升级、用户拒绝升级等原因，造成这些旧版本也需要运行，但是新版却已经修改了规范与旧版旧版冲突了。造成这些旧版本也需要运行使用。再例如我们手机有Android4.0、5.0、6.0、7.0、8.0或IOS8.0、9.0、10、11同时存在于市场也是类似的。

2.出现多版本问题我们通常的做法

旧版接口做成一个分支，除了进行 bug 修改外，旧版本接口不再做改动；新接口代码继续演化升级。在客户端请求的时候带着要请求的接口版本号，在服务器端选择合适的版本代码进行处理。

3.技术处理方案

（1）（最推荐）不同版本用不同的域名：v1.api.jiyuwu.com、v2.api.jiyuwu.com、v3……。

（2）在url、报文头等中带不同的版本信息，用 Nginx 等做反向代理服务器，然后将 http://api.jiyuwu.com/api/V1/Login/1和http://api.jiyuwu.com/api/V2/Login/1转到不同的服务器处理。

（3）多个版本的 Controller 共处在一个项目中，然后使用 [RoutePrefix] 或者 IHttpControllerSelector 根据报文头、路径等选择不同的 Controller 执行。下面主要讲这两种方法。

4.针对3.（3）的两种方案的案例

（1）[RoutePrefix] 案例

旧版保持原样不改变

 
public class LoginController : ApiController
    {
        [HttpGet]
        public string ToLogin(int id)
        {
            return "这是旧版" + id;
        }

    }

新版代码同时用路由处理

 
    
  
[RoutePrefix("api/V2/Login")]
    public class LoginV2Controller : ApiController
    {
        [Route("{id}")]
        [HttpGet]
        public string ToLogin(int id)
        {
            return "这是新版" + id;
        }
    } 
    
  

（2） IHttpControllerSelector 案例

项目结构如图

（1）添加VersionnControllerSelector类

 
    
  
public class VersionnControllerSelector : DefaultHttpControllerSelector
    {
        public HttpConfiguration _config;

        public VersionnControllerSelector(HttpConfiguration config)
            : base(config)
        {
            _config = config;
        }
        public override IDictionary<string, System.Web.Http.Controllers.HttpControllerDescriptor> GetControllerMapping()
        {
            Dictionary<string, HttpControllerDescriptor> dic = new Dictionary<string, HttpControllerDescriptor>();
            foreach (var ams in _config.Services.GetAssembliesResolver().GetAssemblies())
            {
                //获取继承自ApiControl的非抽象类
                var controlTypes = ams.GetTypes().Where(p => !p.IsAbstract && typeof(ApiController).IsAssignableFrom(p)).ToArray();
                foreach (var ctrlType in controlTypes)
                {
                    //从namespace中提取出版本号
                    var match = Regex.Match(ctrlType.Namespace,
                    @"MoreVersionContorl.Controllers.V(\d+)");
                    if (match.Success)
                    {
                        string verNum = match.Groups[1].Value;//获取版本号
                        string ctrlName =
                        Regex.Match(ctrlType.Name, "(.+)Controller").Groups[1].Value;//从LoginController中拿到Login
                        string key = ctrlName + "V" + verNum;//Personv2为key
                        dic[key] = new HttpControllerDescriptor(_config, ctrlName, ctrlType);
                    }
                }
            }
            return dic;
        }
        public override System.Web.Http.Controllers.HttpControllerDescriptor SelectController(HttpRequestMessage request)
        {
            //获取所有Controller集合
            var controllers = GetControllerMapping();
            //获取路由数据
            var routeData = request.GetRouteData();
            //从路由中获取当前controller的名称
            var controllerName = (string)routeData.Values["controller"];
            //从url中获取到版本号
            string verNum =
            Regex.Match(request.RequestUri.PathAndQuery, @"api/V(\d+)").Groups[1].Value;
            string key = controllerName + "V" + verNum;//获取Loginv2
            if (controllers.ContainsKey(key))//获取HttpControllerDescriptor
            {
                return controllers[key];
            }
            else
            {
                return null;
            }
        }
    } 
    
  

（2）创建V1和V2下的两个控制器

1） V1下的LoginController

 
 public class LoginController : ApiController
    {
        public string Get(int id)
        {
            return "This Version is V1,id=" + id;
        }
    }

2） V2下的LoginController

 
public class LoginController : ApiController
    {
        public string Get(int id)
        {
            return "This Version is V2,id="+id;
        }
    }

（3）修改WebApiConfig

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

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

            //config.Routes.MapHttpRoute(
            //    name: "DefaultApi",
            //    routeTemplate: "api/{controller}/{id}",
            //    defaults: new { id = RouteParameter.Optional }
            //);
            config.Routes.MapHttpRoute(
            name: "DefaultApiV1",
            routeTemplate: "api/V1/{controller}/{action}/{id}",
            defaults: new { id = RouteParameter.Optional }
            );
            config.Routes.MapHttpRoute(
            name: "DefaultApiV2",
            routeTemplate: "api/V2/{controller}/{action}/{id}",
            defaults: new { id = RouteParameter.Optional }
            );
            config.Services.Replace(typeof(IHttpControllerSelector),
            new VersionnControllerSelector(config));
        } 
    
  