版本控制

 

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

這篇文章寫得很好，介紹了三種實現web api版本化的三種方式。我從評論裏又收集到兩種方式，因此一共是5種：

方式一：利用URL

 

HTTP GET:
https://haveibeenpwned.com/api/v2/breachedaccount/foo

 

方式二：利用用戶自定義的request header

 

HTTP GET:
https://haveibeenpwned.com/api/breachedaccount/foo
api-version: 2

 

方式三：利用content type

 

HTTP GET:
https://haveibeenpwned.com/api/breachedaccount/foo
Accept: application/vnd.haveibeenpwned.v2+json

 

方式四：利用content type

 

HTTP GET:
https://haveibeenpwned.com/api/breachedaccount/foo
Accept: application/vnd.haveibeenpwned+json; version=2.0

這個方式和方式三的小不一樣的地方是，把版本號分離出來了。

 

方式五：利用URL裏的parameter

 

HTTP GET:
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的配置也是個問題。

 

@Controller
@RequestMapping(headers="apt-version=2")
public class TestControllerV2 {
}

 

另外這個網站列舉了不少國外的有名網站是如何實現web api版本控制的。

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