ASP.Net Core WebApi几种版本控制对比
一、版本控制的好处:
(1)有助于及时推出功能, 而不会破坏现有系统。
(2)它还可以帮助为选定的客户提供额外的功能。
API 版本控制可以采用不同的方式进行控制,方法如下:
(1)在 URL 中追加版本或作为查询字符串参数,
(2)通过自定义标头和通过接受标头
在这篇文章中, 让我们来看看如何支持多个版本的 ASP.NET Core Web API。
一、创建asp.net core webapi 项目,引用NuGet包:Install-Package Microsoft.AspNetCore.Mvc.Versioning -Version 2.0.0
项目和安装包都好了,接着我们需要在Startup.cs中的ConfigureServices 方法中添加下面的代码:
如您所见, 配置了3不同的选项。
- ReportAPIVersions: 这是可选的。但是, 当设置为 true 时, API 将返回响应标头中支持的版本信息。
- AssumeDefaultVersionWhenUnspecified: 此选项将用于不提供版本的请求。默认情况下, 假定的 API 版本为1.0。
- DefaultApiVersion: 此选项用于指定在请求中未指定版本时要使用的默认 API 版本。这将默认版本为1.0。
这是所有的配置和设置。现在, 我们将看到访问 API 版本的不同方式。
二、通过QueryString来实现版本控制
打开我们的控制器,在上面添加ApiVersion特性,如下代码所示:
上面的代码作为1.0版本。您还可以在不同的命名空间中创建另一个具有相同名称的控制器类, 并将 API 版本设置为2.0版本。如下图所示:
就这样。现在转到浏览器并访问控制器。您应该看到 API 版本1.0 控制器的输出, 因为它被设置为默认值。现在在 URL 中追加 api-version=2, 您应该看到 api 版本2.0 控制器的输出。
二、通过URL Path Segment来实现:
查询字符串参数很有用, 但在长 URL 和其他查询字符串参数的情况下可能会很痛苦。相反, 更好的方法是在 URL 路径中添加版本。比如:
- api/v1/values
- api/v2/values
还是上面的项目,只不过需要在v1和v2控制器中加入,下面的代码。如下图所示:
同样, 您需要将路由参数更新到所有适用的位置。使用此更改, 在访问API 接口时总是需要有版本号。您可以通过 api/v1/values 访问到版本 1.0, 通过api/v2/values 访问版本 2.0, 更改 URL 中的版本号。简单, 看起来更干净了。
测试结果如下:
三、通过HTTP Headers来实现版本控制
在上述两种方法中, 需要修改 URL 以支持版本控制。但是, 如果您希望 api 的URL 保持干净, 则 api 版本信息也可以通过附加 HTTP 报头来传递。要进行此工作, 您需要配置 ApiVersionReader 选项。代码如下:
突出显示的行告诉我们header "api-version" 现在是 api 版本号的预期位置。确保路由属性没有版本详细信息。所以测试它,结果如下:
当您将2.0 作为值提供给 "api 版本" 时, 它将调用版本2.0 控制器并返回输出。
简单, 易于设置。但是, 现在查询字符串参数的方法进行版本控制将不起作用。一旦设置了header, 就不能指定查询字符串参数。如果您希望支持这两种情况, 而不是 HeaderApiVersionReader, 请使用 QueryStringOrHeaderApiVersionReader。代码如下:
因此, 现在支持查询字符串参数和header。默认查询字符串参数名称是 api-version, 因此您可以将构造函数留空, 但如果需要其他名称, 则需要提供。您还可以对查询字符串参数和标头使用有不同的名称。请记住, 我们还将 ReportApiVersions 设置为 true, 该值返回响应标头中的版本信息。见下图。
现在, 让我们来看看另外几个选项。
MapToApiVersion参数的用法:
MapToApiVersion 属性允许将单个 API 操作映射到任何版本。换言之, 一个支持多个版本的单控制器。控制器可能只有版本3支持的 API 操作方法。在这种情况下, 您可以使用 MapToApiVersion。看看下面的代码。
上面代码的意思是:public string Get()该方法只有在版本1.0中支持,public string Getv3()方法只有在版本3.0中支持。
有图有真像,很灵活,我很喜欢。
Deprecated参数的用法:
当支持多个 API 版本时, 某些版本最终会随着时间的推移而被弃用。要标记一个或多个 api 版本已被废弃, 只需用Deprecated修饰您的控制器。这并不意味着不支持 API 版本。你仍然可以调用该版本。它只是一种让 调用API 用户意识到以下版本在将来会被弃用。
上面把Deprecated设置为TRUE表示,版本1.0将来会被弃用。访问我们的API接口,可以在响应头中可以看到,下面信息,如下图所示:
ApiVersionNeutral特性的使用:
ApiVersionNeutral 特性定义此 API 不在支持版本控制。无论 支持api 版本控制或不支持 api 版本控制的旧式 api,这对于行为完全相同的 api 非常有用。因此, 您可以添加 ApiVersionNeutral 属性以从版本控制中退出。
获取版本信息(Version Information)
如果你想知道那个版本的客户端在被访问,你可以通过下面的代码实现该功能:
综上所述, 具有多个版本的 API 可以帮助以一种有效的方式推出增强的功能, 同时也便于跟踪更改。在这篇文章中, 我们看到了如何在 ASP.NET core WEB API 中添加对多个版本的支持。nuget 包支持通过查询字符串参数进行版本控制, 在 URL 中添加路径段和通过标头。它还具有版本单一 API 操作和从版本中选择退出的功能。
能不能不借助第三方的包来实现一个API的版本控制,方法是有的,不卖关子了,大家接着往下看。
四、终极版本(不借助任何NuGet包)asp.net core web api版本控制
新建一个core API项目:
在VersionControl文件夹下面,新建一个实现了IApplicationModelConvention接口的类NameSpaceVersionRoutingConvention 代码如下:
1 public class NameSpaceVersionRoutingConvention:IApplicationModelConvention 2 { 3 private readonly string apiPrefix; 4 private const string urlTemplate = "{0}/{1}/{2}"; 5 public NameSpaceVersionRoutingConvention(string apiPrefix = "api") 6 { 7 this.apiPrefix = apiPrefix; 8 } 9 10 public void Apply(ApplicationModel application) 11 { 12 foreach (var controller in application.Controllers) 13 { 14 15 var hasRouteAttribute = controller.Selectors 16 .Any(x => x.AttributeRouteModel != null); 17 if (!hasRouteAttribute) 18 { 19 continue; 20 } 21 var nameSpaces = controller.ControllerType.Namespace.Split('.'); 22 //获取namespace中版本号部分 23 var version = nameSpaces.FirstOrDefault(x => Regex.IsMatch(x, @"^v(\d+)$")); 24 if (string.IsNullOrEmpty(version)) 25 { 26 continue; 27 } 28 string template = string.Format(urlTemplate, apiPrefix, version, 29 controller.ControllerName); 30 controller.Selectors[0].AttributeRouteModel = new AttributeRouteModel() 31 { 32 Template = template 33 }; 34 } 35 } 36 }
调试代码发现这种方式只在程序第一次运行的时候会执行,之后不会再执行多次,因此效率很高。
五、总结:
通过上面两种版本控制的实现和对比,我更偏向通过第三方的包来实现版本控制,这种方法功能更强大。这纯属于个人爱好了,大家可以根据不同的场景来决定使用哪种方式来实现,好了讲到这里,谢谢,希望对你有帮助。
觉得可以的话,希望点下推荐哈~你们的推荐是我的动力。
多谢@光阴四溅 及时指出我的错误,很感谢!
代码下载地址:WebApiVersionControl.rar
作者:郭峥
出处:http://www.cnblogs.com/runningsmallguo/
本文版权归作者和博客园共有,欢迎转载,但未经作者同意必须保留此段声明,且在文章页面明显位置给出原文链接。
转载于:https://www.cnblogs.com/lonelyxmas/p/10325436.html
ASP.Net Core WebApi几种版本控制对比相关推荐
- 【源码解读】Vue与ASP.NET Core WebAPI的集成
在前面博文[Vue]Vue 与 ASP.NET Core WebAPI 的集成中,介绍了集成原理:在中间件管道中注册SPA终端中间件,整个注册过程中,终端中间件会调用node,执行npm start命 ...
- 【Vue】Vue与ASP.NET Core WebAPI的集成
SPA单页面应用已经遍地开花,熟知的三大框架,Angular.Vue和React,其中Angular与React均可集成至ASP.NET Core,且提供了相关了中间件.但是Vue没有: " ...
- ASP.NET Core WebApi使用Swagger生成api说明文档看这篇就够了
引言 在使用asp.net core 进行api开发完成后,书写api说明文档对于程序员来说想必是件很痛苦的事情吧,但文档又必须写,而且文档的格式如果没有具体要求的话,最终完成的文档则完全取决于开发者 ...
- ASP.NET Core WebAPI控制器返回类型的最佳选项
ASP.NET Core WebAPI控制器返回类型的最佳选项 原文:ASP.NET Core WebAPI控制器返回类型的最佳选项 前言 从.NET Core 2.1版开始,到目前为止,控制器操作可 ...
- 【转】ASP.NET Core WebApi使用Swagger生成api说明文档看这篇就够了
原文链接:https://www.cnblogs.com/yilezhu/p/9241261.html 引言 在使用asp.net core 进行api开发完成后,书写api说明文档对于程序员来说想必 ...
- ASP.NET Core WebApi构建API接口服务实战演练
一.ASP.NET Core WebApi课程介绍 人生苦短,我用.NET Core!提到Api接口,一般会想到以前用到的WebService和WCF服务,这三个技术都是用来创建服务接口,只不过Web ...
- Vue + Element+ ASP.NET Core WebAPI 文件上传下载
以ASP.NET Core WebAPI 作后端 API ,用 Vue 构建前端页面,用 Axios 从前端访问后端 API ,包括文件的上传和下载. 准备asp.net后端文件上传的API Uplo ...
- IIS部署asp.net core webapi
一.需要安装Windows Server Hosting,作用是让IIS有方向代理功能(Asp.Net Core Module负责反向代理工作),将请求转发到Kestrel,Windows serve ...
- NET问答: 如何将 ASP.NET Core WebAPI 中抛出的异常封装成对象?
咨询区 rianjs: 在 ASP.NET Core WebAPI 中,我的 Controller 代码如下: [Route("create-license/{licenseKey}&quo ...
最新文章
- java执行class找不到_命令行运行java的class文件提示找不到或无法加载主类
- Vivado中IP核生成文件
- 说实话,Hibernate 和 MyBatis 哪个更好用?
- bzoj1176: [Balkan2007]Mokia cdq
- 国服服务器_伊丁天堂国服|服务器类型建议收集
- 一、Linux基础知识
- Python 测试驱动开发(四)测试及重构的目的(下)
- Python4班平均成绩统计_回首过去,展望未来 | 欢迎大家来到E班第一次主题班会!...
- 第001讲 html介绍 html运行原理
- 【课本】【No.3】随机向量定义、联合分布函数、边缘分布、统计特征的分布函数的差分,独立性、离散型条件分布列,连续型分布函数与密度函数、随机向量的函数分布
- MYSQL授权root远程访问
- 数据库特点分析| 寻找你心中的数据库漫威英雄
- Windows系统常用快捷键
- 分不清蓝牙适配器、蓝牙接收器和蓝牙发射器?伦茨科技为你讲解
- 3分钟快速制作一张高颜值的公众号封面图
- Speedoffice(Excel)怎样给文字添加删除线?
- protected和包访问权限
- java win7 管理员权限_获得WIN7管理员权限(可通过修改注册表,或者组策略改变)...
- 计算机平时测试零分,计算机二级最全攻略 就快考试了不看等什么呢!
- java web 表单提交_Java Web 表单(form)提交问题!
热门文章
- HDU - 1827 Summer Holiday (强连通)
- [蓝桥杯]PREV-19.历届试题_九宫重排
- mongo-yum安装-配置用户权限
- linux下的a.out文件
- SQL中删除重复的行(重复数据),只保留一行 转
- 初学ctypes:打开进程并返回相关信息
- Android系统源代码下载
- android http get
- 迁移到php7,迁移PHP版本到PHP7
- antd table排序 vue_ant-design-vue中的table取消默认不排序的状态