📜  RESTful Web服务-寻址

📅  最后修改于: 2020-10-20 04:37:10             🧑  作者: Mango


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

REST体系结构中的每个资源都通过其URI(统一资源标识符)来标识。 URI具有以下格式-

:////

URI的目的是在托管Web服务的服务器上找到资源。请求的另一个重要属性是VERB,它标识要对资源执行的操作。例如,在“ RESTful Web服务-第一个应用程序”一章中,URI是http:// localhost:8080 / UserManagement / rest / UserService / users ,而VERB是GET。

构造标准URI

以下是设计URI时要考虑的重要点-

  • 使用复数名词-使用复数名词定义资源。例如,我们使用用户将用户标识为资源。

  • 避免使用空格-使用长资源名称时,请使用下划线(_)或连字符(-)。例如,使用authorized_users代替authorized%20users。

  • 使用小写字母-尽管URI不区分大小写,但是最好仅将URL保留为小写字母。

  • 保持向后兼容性-由于Web服务是公共服务,因此一旦公开的URI应该始终可用。如果URI得到更新,请使用HTTP状态代码300将旧URI重定向到新URI。

  • 使用HTTP动词-始终使用HTTP动词(例如GET,PUT和DELETE)对资源进行操作。在URI中使用操作名称不是很好。

以下是无法获取用户的不良URI的示例。

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

以下是获取用户的良好URI的示例。

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