分享 來試試優雅的管理和對比API介面版本

2021-10-19 12:52:44 字數 805 閱讀 6862

乙個專案中,隨著需求的變更或增加,api介面也會跟著變化,而如果專案發布後,已使用的介面肯定不能直接覆蓋更新,需要新增公升級版本介面和新的版本對應,因此多個版本介面更替後,如何更優雅管理不同版本介面**,如何設計更直觀的介面文件呈現給前端,這是後端工程師需要考慮的事情,下面分享一些介面版本管理的經驗。

考慮到介面今後一定會進行版本迭代,因此一開始開發的時候,就需要對**進行版本考量下的**目標架構。1. 控制器目錄架構

在controller下增加子集資料夾:controller/v1/……、controller/v2/……等等,初始版本的介面全部放在v1下。2. 介面路由設計

版本迭代的介面,如果寫在一起,前端真的要瘋。最好能給前端一種重新開始的感覺,歸零後,面對新介面,溝通起來新老介面文件區別明顯,這就大大避免了無謂的撕逼。具體介面文件規範如下:

同時,有時候需要對比不同版本的介面資訊,我通常用的是eolinker上的版本管理功能,可以清楚記錄並讓我看到各個版本的介面資訊對比,直接註冊就可以在網頁上用,貼在下面 www.eolinker.com

C 和Objective C的記憶體管理的對比

oc中都是使用物件的裸指標,所有物件都是繼承自nsobject,nsobject提供了init release retain維護計數器,自動的計數釋放對應autorelease,但是autorelease是乙個pool,具體什麼時候release是不確定的,如果乙個方法很長即使方法沒有結束,也有可能...

單臨界區管理和多臨界區管理的效率對比

測試 struct test1 test1 void add void sub struct test2 test2 void add void sub int main auto thread pool thread pool instance auto start time timer get ...

Mac和PC在工作中管理的對比 5

acls,企業應用必備 windows acls是access control lists的縮寫,訪問控制列表 訪問控制列表.它已經在大多數的現代作業系統中得到支援.系統安全就是通過acls來實現的.廣義說,乙個物件要訪問另外乙個,那麼就要提交自己的物件 windows很早在nt時開始就支援acls...