RESTful Web 服务 - 寻址
生活随笔
收集整理的這篇文章主要介紹了
RESTful Web 服务 - 寻址
小編覺得挺不錯的,現在分享給大家,幫大家做個參考.
尋址指的是定位存儲在服務器上的一個或多個資源。類似于定位某個人的郵寄地址。
REST 架構中的每個資源都通過它的 URI(統一資源標示符)標識。URI 格式如下:
<protocol>://<service-name>/<ResourceType>/<ResourceID>URI 的目的是定位托管 Web 服務的服務器上的資源。請求的另一個重要的屬性是 VERB,它用于標識要在資源上執行的操作。比如,在?RESTful Web 服務 - 第一個應用?教程中,URI 就是?http://localhost:8080/UserManagement/rest/UserService/users,VERB 是 GET。
構建一個標準的 URI
下面是設計 URI 時要考慮的要點:
- 使用復數名詞?- 使用復數名詞定義資源。比如,我們使用?users?標識用戶資源。
- 避免使用空格?- 處理長資源名時使用下劃線(_)或者連字符(-),比如,用 authorized_users 而不是 authorized%20users。
- 使用小寫字母?- 盡管 URI 不區分帶小寫,但是在 url 中使用小寫字母是一種很好的做法。
- 保持向后兼容?- 由于 Web 服務是一種公共服務,URI 一旦公開之后應該始終可用。這種情況下,要更新 URI,請使用 HTTP 狀態碼 - 300 重定向老的 URI 到新的 URI。
- 使用 HTTP Verb?- 始終使用 HTTP Verb,比如 GET,PUT 以及 DELETE 處理資源操作。在 URL 中使用操作名并不好。
示例
下面是一個獲取用戶的不好的 URI 示例:
http://localhost:8080/UserManagement/rest/UserService/getUser/1下面是一個獲取用戶的好的 URI 示例:
http://localhost:8080/UserManagement/rest/UserService/users/1總結
以上是生活随笔為你收集整理的RESTful Web 服务 - 寻址的全部內容,希望文章能夠幫你解決所遇到的問題。
- 上一篇: RESTful Web 服务 - 消息
- 下一篇: RESTful Web 服务 - 方法