码迷,mamicode.com
首页 > 其他好文 > 详细

版本控制

时间:2017-08-09 22:23:44      阅读:216      评论:0      收藏:0      [点我收藏+]

标签:star   str   web   方式   三种方式   als   copy   base   两种   

 

http://blog.csdn.net/hengyunabc/article/details/20506345

这篇文章写得很好,介绍了三种实现web api版本化的三种方式。我从评论里又收集到两种方式,所以一共是5种:

方式一:利用URL

 

[html] view plain copy
 
  1. HTTP GET:  
  2. https://haveibeenpwned.com/api/v2/breachedaccount/foo  

 

方式二:利用用户自定义的request header

 

[plain] view plain copy
 
  1. HTTP GET:  
  2. https://haveibeenpwned.com/api/breachedaccount/foo  
  3. api-version: 2  

 

方式三:利用content type

 

[plain] view plain copy
 
  1. HTTP GET:  
  2. https://haveibeenpwned.com/api/breachedaccount/foo  
  3. Accept: application/vnd.haveibeenpwned.v2+json  

 

方式四:利用content type

 

[plain] view plain copy
 
  1. HTTP GET:  
  2. https://haveibeenpwned.com/api/breachedaccount/foo  
  3. Accept: application/vnd.haveibeenpwned+json; version=2.0  

这个方式和方式三的小不同的地方是,把版本号分离出来了。

 

方式五:利用URL里的parameter

 

[plain] view plain copy
 
  1. HTTP GET:  
  2. https://haveibeenpwned.com/api/breachedaccount/foo?v=2  

 

 

作者说他最喜欢第三种方式,因为

 

  1. URL不用改变
  2. 客户端应该通过accept header来表明自己想接收的是什么样的数据。
但作者很蛋疼地在他的网站上把前面三种方式都实现了,而且都支持。
https://haveibeenpwned.com/API/v2
 
 

 

我个人最喜欢的是第二种方式,因为这个用spring mvc实现最容易,也最简洁。

因为只要在Controler上用@RequestMapping标明版本即可。不用再去各种匹配,各种识别。

如果是自己写一个Annotation来识别的话,也要花些功夫,而且怎么无缝地转发到原有的Spring mvc的配置也是个问题。

 

[java] view plain copy
 
  1. @Controller  
  2. @RequestMapping(headers="apt-version=2")  
  3. public class TestControllerV2 {  
  4. }  



 

另外这个网站列举了很多国外的有名网站是如何实现web api版本控制的。

http://www.lexicalscope.com/blog/2012/03/12/how-are-rest-apis-versioned/

版本控制

标签:star   str   web   方式   三种方式   als   copy   base   两种   

原文地址:http://www.cnblogs.com/fengli9998/p/7327808.html

(0)
(0)
   
举报
评论 一句话评论(0
登录后才能评论!
© 2014 mamicode.com 版权所有  联系我们:gaon5@hotmail.com
迷上了代码!