【发布时间】:2010-03-09 00:48:43
【问题描述】:
我正在设计一个 Web 应用程序,它将支持标准 UI(通过浏览器访问)和 RESTful API(基于 XML/JSON 的 Web 服务)。用户代理将能够通过在Accept HTTP 标头中使用不同的值来区分这些。
RESTful API 将使用以下 URI 结构(“文章”资源的示例):
-
GET /article/- 获取文章列表 -
POST /article/- 添加新文章 -
PUT /article/{id}- 更新基于{id}的现有文章 -
DELETE /article/{id}- 删除基于{id}的现有文章
应用程序的 UI 部分需要支持多个视图,例如:
- 标准资源视图
- 提交新资源的视图
- 用于编辑现有资源的视图
- 用于删除现有资源的视图(即显示删除确认)
请注意,后三个视图仍然通过GET 访问,即使它们是通过重载的POST 处理的。
可能的解决方案:
将附加参数(关键字)引入 URI 中,以识别单个视图 - 即在上述之上,应用程序将支持以下 URI(但仅适用于 Content-Type: text/html):
-
GET /article/add- 显示用于添加新文章的表单(通过GET获取,通过POST处理) -
GET /article/123- 在“查看”模式下显示文章 123(通过GET获取) -
GET /article/123/edit- 在“编辑”模式下显示文章 123(通过GET获取,通过PUT处理,重载为POST) -
GET /article/123/delete- 显示文章 123 的“删除”确认(通过GET获取,通过DELETE处理,重载为POST)
上述更好的实现可能是将 add/edit/delete 关键字放入 GET 参数中 - 因为它们不会更改我们正在使用的资源,所以最好让所有的基本 URI 保持相同其中。
我的问题是:
考虑到每个资源可以有多个视图,您如何将上述 URI 结构映射到提供给普通用户的 UI?您是否同意上面详述的可能解决方案,还是会根据您的经验推荐不同的方法?
注意:我们已经实现了一个应用程序,它由一个独立的 RESTful API 和一个独立的 Web 应用程序组成。我目前正在研究将这两者合并在一起的未来项目的选项(即为了减少开销)。
【问题讨论】:
标签: web-services architecture rest user-interface