著名博客及优秀的 XML.com REST 系列作者,Joe Gregorio,在一篇博客帖子中展示了如何在复杂应用(Apache 的DayTrader 基准测试)中应用 REST 设计原则。
DayTrader 源于 IBM 开发的交易效率基准测试样本,它是一个联机股票交易应用程序,于 2005 年被捐献给 Apache Geronimo 社区。该应用支持的用例包括登录、查看股票一览表、查询股票报价,以及买卖股票份额。
该文展示了如何将 DayTrader 支持的业务操作映射到资源上,每个资源被自己的 URI 标识,同时支持统一的 HTTP 接口。尽管核心功能映射到 REST 模型非常自然(大约 20 个操作最终被映射成 5 个"资源集合"),但是为了支持订单的可靠传递需要做更多的工作。
为达到这一目的,Joe 引入一个未决订单集合(pending_orders collection),此处订单首先使用 POST 创建,然后使用 PUT 分别进行更新。由于 PUT 操作具有幂等性,因而如果结果不清可以进行重试,且不会有副作用(此情形相当于提交同一订单 2 次)。
支持可靠性的这种方法并不是标准化的–至少没有超越 HTTP 提供的级别。除了在 POST 过程中引入特殊的解决方案,Joe 还参考了 HTTPLR (由 Bill de hÓra 提出)、 Mark Nottingham 的 POE (POST Once Exactly)和 Paul Prescod 的 HTTP 中的可靠传递。(另一个值一提的是 Yaron Goland 的 SOA-Rity )
帖子最后总结道:
希望你从本例中学到的不是构建 DayTrader REST 化接口的外在工具,而是可被应用到复杂的场景中的 REST 本身,集合模型可以使建模更简单,并且 HTTP 确实提供可靠性的机制。我期望有一点是不言而喻的:既然你有 REST 化的接口,那么你就可以利用其它 HTTP 机制,如 caching 、 etags 和 gzip 。




