30、RESTful Web 服务设计与 HTTP 特性解析

RESTful Web 服务设计与 HTTP 特性解析

1. 资源处理原则

在处理事务和异步操作等时，若现有的方法不适用，可尝试其他安排。因为“任何事物都可以成为资源”，若某个概念导致设计难题，可将其作为一种新资源融入面向资源的架构（ROA）。若因性能原因需违反统一接口，可使用重载的 POST 请求。

2. URI 设计

2.1 URI 设计原则

• 有意义且结构良好 ：客户端应能构建所需资源的 URI，以增加应用的“表面积”，使客户端可直接访问应用的任何状态。
• 使用路径变量 ：用于分离层次结构或有向图中的元素，例如 /weblogs/myweblog/entries/100 从通用到具体，每个路径变量在某种意义上包含于前一个变量。
• 使用标点符号 ：在同一层次结构中分离多个数据项。顺序重要时用逗号，如 /Earth/37.0,-95.2 ；顺序不重要时用分号，如 /color - blends/red;blue 。
• 使用查询变量 ：仅用于表示插入算法的参数，或前两种方法不适用时。若两个 URI 仅查询变量不同，则表示它们是同一底层算法的不同输入集。
• 指定资源而非操作 ：URI 应指定资源，而非资源上的操作。避免在 URI 中使用操作名称，如 /object/d