打造属于自己的支持版本迭代的Asp.Net Web Api R…

2018-06-22 06:13:36来源：未知阅读 ()

在目前的主流架构中，我们越来越多的看到web Api的存在，小巧，灵活，基于Http协议，使它在越来越多的微服务项目或者移动项目充当很好的service endpoint。

问题

以Asp.Net Web Api 为例，随着业务的扩展，产品的迭代，我们的web api也在随之变化，很多时候会出现多个版本共存的现象，这个时候我们就需要设计一个支持版本号的web api link，比如：

原先：http://www.test.com/api/{controller}/{id}

如今：http://www.test.com/api/{version}/{controller}/{id}

在我们刚设计的时候，有可能没有考虑版本的问题，我看到很多的项目都会在link后加入一个“?version=”的方式，这种方式确实能够解决问题，但对Asp.Net Web Api来说，进入的还是同一个Controller，我们需要在同一个Action中进行判断版本号，例如：

http://www.test.com/api/bolgs?version=v2[HttpGet]

public class BlogsController : ApiController
{
    // GET api/<controller>
    public IEnumerable<string> Get([FromUri]string version = "")
    {
        if (!String.IsNullOrEmpty(version))
        {
            return new string[] { $"{version} blog1", $"{version} blog2" };
        }
        return new string[] { "blog1", "blog2" };
    }
}

我们看到我们通过判断url中的version参数进行对应的返回，为了确保原先接口的可用，我们需要对参数赋上默认值，虽然能够解决我们的版本迭代问题，但随着版本的不断更新，你会发现这个Controller会越来越臃肿，维护越来越困难，因为这种修改已经严重违反了OCP（Open-Closed Principle），最好的方式是不修改原先的Controller，而是新建新的Controller，放在对应的目录中（或者项目中），比如：

为了不影响原先的项目，我们尽量不要改动原Controller的Namespace，除非你有十足的把握没有影响，不然请尽量只是移动到目录。

ok，为了保持原接口的映射，我们需要在WebApiConfig.Register中注册支持版本号的Route映射：

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

打开浏览器或者postman，输入原先的api url，你会发现这样的错误：

那是因为web api 查找Controller的时候，只会根据ClassName进行查找的，当出现相同ClassName的时候，就会报这个错误，这时候我们就需要打造自己的Controller Selector，好在微软留了一个接口给到我们：IHttpControllerSelector。不过为了兼容原先的api（有些不在我们权限范围内的api，不加版本号的那种），我们还是直接集成DefaultHttpControllerSelector比较好，我们给定一个规则，不负责我们版本迭代的api，就让它走原先的映射。

思路

1、项目启动的时候，先把符合条件的Controller加入到一个字典中

2、判断request，符合规则的，我们返回我们制定的controller。

打造属于自己的Selector

思路有了，那改造起来也非常简单，今天我们先做一个简单的，等有时间改成可配置的。

第一步，我们先创建一个Selector类，继承自DefaultHttpControllerSelector，然后初始化的时候创建一个属于我们自己的字典：

public class VersionHttpControllerSelector : DefaultHttpControllerSelector
{
    private readonly HttpConfiguration _configuration;
    private readonly Lazy<Dictionary<string, HttpControllerDescriptor>> _lazyMappingDictionary;
    private const string DefaultVersion = "v1"; //默认版本号，因为之前的api我们没有版本号的概念
    private const string DefaultNamespaces = "WebApiVersions.Controllers"; //为了演示方便，这里就用到一个命名空间
    private const string RouteVersionKey = "version"; //路由规则中Version的字符串
    private const string DictKeyFormat = "{0}.{1}";
    public VersionHttpControllerSelector(HttpConfiguration configuration):base(configuration)
    {
        _configuration = configuration;
        _lazyMappingDictionary = new Lazy<Dictionary<string, HttpControllerDescriptor>>(InitializeControllerDict);
    }

    private Dictionary<string, HttpControllerDescriptor> InitializeControllerDict()
    {
        var result = new Dictionary<string, HttpControllerDescriptor>(StringComparer.OrdinalIgnoreCase);
        var assemblies = _configuration.Services.GetAssembliesResolver();
        var controllerResolver = _configuration.Services.GetHttpControllerTypeResolver();
        var controllerTypes = controllerResolver.GetControllerTypes(assemblies);

        foreach(var t in controllerTypes)
        {
            if (t.Namespace.Contains(DefaultNamespaces)) //符合NameSpace规则
            {
                var segments = t.Namespace.Split(Type.Delimiter);
                var version = t.Namespace.Equals(DefaultNamespaces, StringComparison.OrdinalIgnoreCase) ?
                    DefaultVersion : segments[segments.Length - 1];
                var controllerName = t.Name.Remove(t.Name.Length - DefaultHttpControllerSelector.ControllerSuffix.Length);
                var key = string.Format(DictKeyFormat, version, controllerName);
                if (!result.ContainsKey(key))
                {
                    result.Add(key, new HttpControllerDescriptor(_configuration, t.Name, t));
                }
            }
        }

        return result;
    }
}

有了字典接下来就好办了，只需要分析request就好了，符合我们版本要求的，就从我们的字典中查找对应的Descriptor，如果找不到，就走默认的，这里我们需要重写SelectController方法：

public override HttpControllerDescriptor SelectController(HttpRequestMessage request)
{
    IHttpRouteData routeData = request.GetRouteData();
    if (routeData == null)
        throw new HttpResponseException(HttpStatusCode.NotFound);

    var controllerName = GetControllerName(request);
    if (String.IsNullOrEmpty(controllerName))
        throw new HttpResponseException(HttpStatusCode.NotFound);

    var version = DefaultVersion;
    if (IsVersionRoute(routeData, out version))
    {
        var key = String.Format(DictKeyFormat, version, controllerName);
        if (_lazyMappingDictionary.Value.ContainsKey(key))
        {
            return _lazyMappingDictionary.Value[key];
        }

        throw new HttpResponseException(HttpStatusCode.NotFound);
    }

    return base.SelectController(request);
}

private bool IsVersionRoute(IHttpRouteData routeData, out string version)
{
    version = String.Empty;
    var prevRouteTemplate = "api/{controller}/{id}";
    object outVersion;
    if(routeData.Values.TryGetValue(RouteVersionKey, out outVersion))   //先找符合新规则的路由版本
    {
        version = outVersion.ToString();
        return true;
    }

    if (routeData.Route.RouteTemplate.Contains(prevRouteTemplate))  //不符合再比对是否符合原先的api路由
    {
        version = DefaultVersion;
        return true;
    }

    return false;
}

完成这个类后，我们去WebApiConfig.Register中进行替换操作：

config.Services.Replace(typeof(IHttpControllerSelector), new VersionHttpControllerSelector(config));

ok，再次打开浏览器，输入http://www.xxx.com/api/blogs 和 http://www.xxx.com/api/v2/blogs ,这时应该能看到正确的执行：

写在最后

今天我们打造了一个简单符合webapi版本号更新迭代的ControllerSelector，不过还不是很完善，因为很多都是hard code，后面我会做一个支持配置的ControllerSelector放到github上。

之前一直在研究eShopOnContrainers，最近也在研究，不过工作确实有点忙，见谅见谅，如果大家.Net有什么问题或者喜欢技术交友的，都可以加QQ群：376248054

标签：

版权申明：本站文章部分自网络，如有侵权，请联系：west999com@outlook.com
特别注意：本站所有转载文章言论不代表本站观点，本站所提供的摄影照片，插画，设计作品，如需使用，请与原作者联系，版权归原作者所有

上一篇：关于缓存的学习记录

下一篇：关于颗粒度更细小的缓存-“部分视图缓存”

IDC资讯：主机资讯注册资讯托管资讯 vps资讯网站建设

网站运营：建站经验策划盈利搜索优化网站推广免费资源

网站联盟：联盟新闻联盟介绍联盟点评网赚技巧

行业资讯：搜索引擎网络游戏电子商务广告传媒

网络编程： Asp.Net编程 Asp编程 Php编程 Xml编程 Access Mssql Mysql 其它

服务器技术： Web服务器 Ftp服务器 Mail服务器 Dns服务器安全防护

软件技巧：其它软件 Word Excel Powerpoint Ghost Vista QQ空间 QQ FlashGet 迅雷

网页制作： FrontPages Dreamweaver Javascript css photoshop fireworks Flash

程序设计： Java技术 C/C++ VB delphi

网络知识：网络协议网络安全网络管理组网方案 Cisco技术

操作系统： Win2000 WinXP Win2003 Mac OS Linux FreeBSD

热门词条

最新资讯

热门关注

热门标签