zoukankan      html  css  js  c++  java
  • 版本控制

    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/

  • 相关阅读:
    图标字体IcoMoon 使用
    JS 寻找孩子并打印路径
    为什么要用on()而不直接使用click
    setTimeout 虚假的“异步”
    解决Ajax.BeginForm还是刷新页面的问题
    .net生成Excel,并下载
    C#判断文件是否正在被使用
    sql为数字添加千分位(也就是钱的格式)
    HotelIInventory项目小结
    一步一步实现FormsAuthentic验证登录
  • 原文地址:https://www.cnblogs.com/fengli9998/p/7327808.html
Copyright © 2011-2022 走看看