查看订单-REST的流程API设计案例(2)

2014-11-24 01:09:01 · 作者: · 浏览: 0

这太简单了,流程在哪里

在上面的例子里,我们看到了订单的CRUD操作,但这并不是实际生活中的真实情况,整个订单的生命周期如下图所示:

\

在实现这个流程时,我们分为两步:第一步对订单进行资源建模;第二步通过工作流对订单进行流程的生命周期管理。

\

\

工作流的职责在于管理订单的生命周期,在其生命周期的不同阶段,我们会有不同的参与者,对订单不同的操作权限。我们的系统架构演变成下面的样子:

\

看例子,这次将我们视角转移到框框网这边,看看框框如何处理我们已提交的订单。我们使用GET:http://api.kuangkuang.com/orders status=waiting-review来获取所有需要审核的订单,服务器返回以下的数据:


Xml代码

http://api.kuangkuang.com/orders"/>

1000
waiting review
http://api.kuangkuang.com/order/1000"/>


http://api.kuangkuang.com/orders"/>

1000
waiting review
http://api.kuangkuang.com/order/1000"/>

我们查看具体的订单信息,我们GET:http://api.kuangkuang.com/order/1000,服务器判断出我们是框框网员工,返回以下的数据:


Xml代码

http://api.kuangkuang.com/order/1000"/>

1000
88.0
waiting review

http://api.kuangkuang.com/review/order/1000"/>



http://api.kuangkuang.com/order/1000"/>

1000
88.0
waiting review

http://api.kuangkuang.com/review/order/1000"/>


注意到这两行:


Java代码
waiting review

http://api.kuangkuang.com/review/order/1000"/>

waiting review

http://api.kuangkuang.com/review/order/1000"/>

这段信息是由工作流加入的,它告诉我们当前订单的状态为等待审核以及下一步需要我们来审核。那么,我们PUT http://api.kuangkuang.com/review/order/1000告诉服务器我们审核通过,服务器返回数据:


Xml代码

http://api.kuangkuang.com/order/1000"/>

1000
88.0
waiting send

http://api.kuangkuang.com/sent/order/1000"/>



http://api.kuangkuang.com/order/1000"/>

1000
88.0
waiting send

http://api.kuangkuang.com/sent/order/1000"/>


同样,工作流加入了这两行数据:


Xml代码
waiting send

http://api.kuangkuang.com/sent/order/1000"/>

waiting send

http://api.kuangkuang.com/sent/order/1000"/>

告诉我们当前订单状态为等待送货,而下一步需要我们来完成这一步。此时,如果顾客来查看自己的订单会得到什么数