開發restful api總結的幾點小經驗

2022-03-27 08:53:50 字數 688 閱讀 5906

與其說是開發,不如說是打補丁! 

是個jesery+spring的restful service,加了乙個許可權校驗部分,做了一些調整。

本來其實很簡單的乙個事,後來發現,這個**太霸道。本來傳個引數是action_id 這個東西,結果引數名字有如下:action_id,actionid,id 我只能說傻傻分不清楚到底你傳的什麼,

因為還有其他id,引數名字參考剛才的。

**中的也是混亂,雖然我知道有很多先人在修改了,但是也不至於這樣吧。

吐槽完畢。

1、n次開發restful api主意版本迭代,不要在別人的基礎上改,比如這次做,我直接修改!後來就是,重新建了自己的乙個version package。

這樣做可以避免之前用老api人的影響,同時可以自己掌控**的質量,至少不用改別人的**。別人已經寫好的,你看著不行就改,可以救直接呼叫。

2、注意**的可用性,盡量不要使用遞迴這種東西,很無腦。除非這個操作很簡單。 這次修改的**就是使用 鎖+遞迴 =》做sql查詢,這簡直**了好麼。

直接把遞迴這種東西做掉了。

3、多用常量,避免hard code。

4、sql查詢不要使用select * 。 把需要查詢的字段都寫上,這樣做是為了防止後續schema修改,你的bean不相容的問題。

5、盡量把整個api都看懂,因為別人不只問你你開發的,你還要解決別人留下的那些很傻x的bugs

如何開發RESTful API

restful api有哪些特點 基於 資源 資料也好 服務也好,在restful設計裡一切都是資源。無狀態。一次呼叫一般就會返回結果,不存在類似於 開啟連線 訪問資料 關閉連線 這種依賴於上一次呼叫的情況。url中通常不出現動詞,只有名詞 url語義清晰 明確 使用http的get post de...

RESTful API 設計總結

restful api 設計總結 技術 架構 api,規範,設計 restful的介面設計風格應用的越來越廣泛,包括spring cloud等微服務架構平台之間的呼叫都是以restful設計風格為主,但是很多程式猿依然是停留在表面的理解上,沒有深刻的去理解使用restful風格規範,同時在設計res...

RESTful API 設計指南總結

rest 英文 representational state transfer,簡稱rest 描述了乙個架構樣式的網路系統,比如 web 應用程式。它首次出現在 2000 年 roy fielding 的博士 中,他是 http 規範的主要編寫者之一。在目前主流的三種web服務互動方案中,rest相...