架構篇 URI設計原則

2021-08-20 00:01:58 字數 587 閱讀 6804

@author simon

優雅型:羅浮宮/達文西/蒙娜麗莎

中庸型:北京/新聞頻道/新聞id

謝特型:

斜槓分隔符(/)必須用於顯示層次關係
正例: 

反例:

使用「-」提高uri的可讀性
正例:
禁止在url中使用「_」
目的是提高可讀性,「_」可能被文字檢視器中的下劃線特效遮蔽

反例:

禁止使用大寫字母
rfc 3986中規定uri區分大小寫,但別用大寫字母來為難程式設計師了,既不美觀,又麻煩

正例:

反例:

不要在uri中包含副檔名
應鼓勵rest api客戶端使用http提供的格式選擇機制accept request header

正例:反例:.json

最後,給後端研發工程師乙個建議:清晰優雅的 restful api是為呼叫者編寫的,別無腦隨意定義一些****一樣的uri給移動/前端工程師使用,小心生命有危險。

URI設計原則

咱們設計的rest api真的nice麼?優雅型 羅浮宮 達文西 蒙娜麗莎 中庸型 北京 二手頻道 帖子id 謝特型 不知道什麼鬼 本文將分享uri設計的一些原則。1.uri的末尾不要新增 多乙個斜槓,語義完全不同,究竟是目錄,還是資源,還是不確定而多做一次301跳轉?負面case 正面case 2...

架構設計原則

電腦科學領域的任何問題都可以通過增加乙個間接的中間層來解決。實現功能性需求是當前的明確地,非功能性需求是應對未來未知需求 架構是系統非功能性需求的解決辦法的集合 架構設計的目的基礎是滿足功能需求,主要是滿足一下特性 高效能 可用性 可靠性 可擴充套件性 穩定性 安全性 易用性 可維護性 靈活性 實現...

架構設計原則

知乎 馮慶 常見架構設計方案質量屬性點有 效能 可用性 硬體成本 專案投入 複雜度 安全性 可擴充套件性等。在評估這些質量屬性時,需要遵循架構設計原則 1.合適原則,2簡單原則,避免貪大求全,基本上某個質量屬性能夠滿足以 一定時期業務發展就可以了。屬性 集群方案 拆分方案 備註 效能 中,繼續擴充套...