RESTful - Web 服务地址

  • 简述

    寻址是指定位位于服务器上的一个或多个资源。这类似于查找一个人的邮政地址。
    REST 架构中的每个资源都由其 URI(统一资源标识符)标识。URI 具有以下格式 -
    
    <protocol>://<service-name>/<ResourceType>/<ResourceID>
    
    URI 的目的是在托管 Web 服务的服务器上定位资源。请求的另一个重要属性是 VERB,它标识要对资源执行的操作。例如,在RESTful 第一个应用程序章节中,URI 是http://localhost:8080/UserManagement/rest/UserService/users 动词是GET。
  • 构建标准 URI

    以下是设计 URI 时需要考虑的要点 -
    • 使用复数名词− 使用复数名词定义资源。例如,我们使用用户将用户标识为资源。
    • 避免使用空间− 使用长资源名称时使用下划线 (_) 或连字符 (-)。例如,使用authorized_users 而不是authorized%20users。
    • 使用小写字母 - 尽管 URI 不区分大小写,但最好将 url 保持为小写字母。
    • 保持向后兼容性− 由于 Web Service 是一项公共服务,因此公开的 URI 应始终可用。如果 URI 更新,请使用 HTTP 状态代码 300 将旧 URI 重定向到新 URI。
    • 使用HTTP动词− 始终使用 GET、PUT 和 DELETE 等 HTTP Verb 对资源进行操作。在 URI 中使用操作名称是不好的。

    例子

    以下是获取用户的不良 URI 的示例。
    
    http://localhost:8080/UserManagement/rest/UserService/getUser/1 
    
    以下是用于获取用户的良好 URI 的示例。
    
    http://localhost:8080/UserManagement/rest/UserService/users/1