`
ronghao
  • 浏览: 456077 次
  • 性别: Icon_minigender_1
  • 来自: 北京
博客专栏
E9473dd5-1985-3883-ac98-962354ca10b3
张小庆,在路上
浏览量:8780
社区版块
存档分类
最新评论

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

阅读更多

这太简单了,流程在哪里

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

 

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

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

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

<orders>
    <link rel="list" media-type="application/xml" url="http://api.kuangkuang.com/orders"/>
    <order>
        <id>1000</id>
        <state>waiting review</state>
        <link rel="detail" media-type="application/xml" url="http://api.kuangkuang.com/order/1000"/>
    </order>
</orders>
 

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

<order>
<link rel="detail" media-type="application/xml" url="http://api.kuangkuang.com/order/1000"/>
<content>
    <id>1000</id>
    <cost>88.0</cost>
    <state>waiting review</state>
    <squence>
        <activity rel="review" media-type="application/xml" url="http://api.kuangkuang.com/review/order/1000"/>
    </squence>
</content>
</order>
 

注意到这两行:

    <state>waiting review</state>
    <squence>
        <activity rel="review" media-type="application/xml" url="http://api.kuangkuang.com/review/order/1000"/>
    </squence>
 

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

 

<order>
<link rel="detail" media-type="application/xml" url="http://api.kuangkuang.com/order/1000"/>
<content>
    <id>1000</id>
    <cost>88.0</cost>
    <state>waiting send</state>
    <squence>
        <activity rel="send" media-type="application/xml" url="http://api.kuangkuang.com/sent/order/1000"/>
    </squence>
</content>
</order>
 

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

<state>waiting send</state>
    <squence>
        <activity rel="send" media-type="application/xml" url="http://api.kuangkuang.com/sent/order/1000"/>
    </squence>
 

告诉我们当前订单状态为等待送货,而下一步需要我们来完成这一步。此时,如果顾客来查看自己的订单会得到什么数据呢?服务器会判断出当前请求的用户是顾客,那么:

 

<order>
<link rel="detail" media-type="application/xml" url="http://api.kuangkuang.com/order/1000"/>
<content>
    <id>1000</id>
    <cost>88.0</cost>
    <state>waiting send</state>
</content>
</order>
 

顾客能够看到自己的订单正处于等待送货状态,而不会有下一步的动作。恩,很好,框框网订单处理速度很快,而这正是网购的主要竞争力之一。

在这些交互中,最重要的是我们通过工作流实现了REST社区所呼吁的将超媒体作为应用状态的引擎(hypermedia as the engine of application state。更简单地说,URI代表了状态机里的状态迁移。我们通过<squence><activity>标签让客户端是通过跟随链接的方式来操作订单状态机的状态转移。

等等,实际情况不是这样,框框自己并不送货,好吧,那就下一篇见。

  • 大小: 24.4 KB
  • 大小: 67.8 KB
  • 大小: 66.1 KB
  • 大小: 29.2 KB
1
2
分享到:
评论
1 楼 avi9111 2011-06-23  
图8错

相关推荐

Global site tag (gtag.js) - Google Analytics