RESTful Web服务地址

发布于 2015-08-12 14:10:52 | 535 次阅读 | 评论: 0 | 来源: 网络整理

地址是指查找资源或多个资源位于服务器上。它类似于定位的人的邮寄地址。

REST架构中的每个资源都由其URI，统一资源标识符。 URI是以下格式：

<protocol>://<service-name>/<ResourceType>/<ResourceID>

一 个URI的目的是要找到承载Web服务的服务器上的资源。请求的另一个重要属性是动词，标识要在资源上执行的操作。例如，在REST Web服 第一应用教程， URI 就是http://localhost:8080/UserManagement/rest/UserService/users 和动词是GET。

构建一个标准的URI

以下是要考虑在设计一个URI要点：

• 使用复数名词 - 使用复数名词来定义的资源。例如，我们已经使用的用户识别用户的资源。

• 避免使用空格 - 利用下划线（_）或连字符（ - ），使用一个长的资源的名称，例如，使用authorized_users代替authorized%20users。

• 使用小写字母 - 虽然URI是区分大小写，这是很好的做法，以保持网址只有小写字母。

• 保持向后兼容 - 由于Web服务是一种公共服务，URI一旦做出公开应始终可用。在某些情况下URI更新，使用HTTP状态码，300表示旧的URI重定向到新的URI。

• 使用HTTP动词 - 始终使用HTTP动词像GET，PUT和DELETE做业务上的资源。这是不好用操作名字URI。

例子

下面是一个URI的例子来获取的用户。

http://localhost:8080/UserManagement/rest/UserService/getUser/1

以下是良好的URL的一个例子来获取的用户。

http://localhost:8080/UserManagement/rest/UserService/users/1