webapi版本升级管理

由于近期公司人员流动，本人临时客串webapi开发，针对开发过程中碰到一些问题做一些改进

1、当前做法

项目webapi项目是居于asp.net框架开发的，每个功能模块新建一个api控制器，比如UserController,GroupController，针对Native App升级产生的多版本App，都只是对应唯一一个webapi。各个版本的app某个功能都调用同一个方法GetDetail，当某个版本需要扩充该方法的参数，则重新一个新方法GetDetailV2；当返回的实体属性名发生变更或者删减则扩充一个新属性或者加一个新实体；最苦恼的是针对老版本app上的bug，api将错就错导致各种奇怪的条件判断或者新方法；这种做法虽然前期迭代快捷，但越往后越混乱，给维护和测试带来极大不便

2、改进方法1

针对方法加复合路由方式，某个支持什么版本的app，就加上相对应的路由，这样虽然能将app版本和api版本关联上，但还是没有解决以上问题，而且每次新发版本都要对有方法加路由规则

[Route("v1/user/{id}")]
[Route("v2/user/{id}")]
[Route("v3/user/{id}")]
[HttpGet]
[HTTPBasicAuthorizeAttribute]
public UserInfo User(int id)

3、改进方法2

在controller层面加版本，比如V1_UserController,V2_UserController，每发布一个api版本都新建一个controller，新版本controller都继承老版本controller，controller中新写的方法都带virtual修饰以便后面版本重写；这样的好处在于既能重用代码，又能灵活改动，版本层次清晰，且不会因为影响老版本带来额外的测试工作，app可以很方便切换新版本接口 如：http://xxx/api/v1_user/Detail/1   http://xxx/api/v2_user/Detail/1

public class V1_UserInfoController:ApiController{

[HttpGet]
[HTTPBasicAuthorizeAttribute]
public virtual UserInfo Detail(int id){}//获取

[HttpPost]
[HTTPBasicAuthorizeAttribute]
public virtual bool Detail([frombody]UserInfo userinfo){}//添加

}

public class V2_UserInfoController:V1_UserInfoController{

[HttpPost]
[HTTPBasicAuthorizeAttribute]
public override bool Detail([frombody]UserInfo userinfo){}//重写添加方法

[HttpPut]
[HTTPBasicAuthorizeAttribute]
public override bool Detail([frombody]UserInfo userinfo){}//新增方法

}

3、改进方法3

本想针对方法2做改进，将请求接口改成类似 http://xxx/api/v1/user/Detail/1，但由于apirouter不支持命名空间，次设想暂时没有实现；网上有写文章写将版本号体现在url中不符合restful风格，最好写到httpheader中，此方案还在持续跟进中