当前位置:编程学习 > JAVA >>

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

 

这太简单了,流程在哪里

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

\

 

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

\

\

 

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

\

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


Xml代码 
<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> 

<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>

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


Xml代码 
<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> 

<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>

注意到这两行:


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

    <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告诉服务器我们审核通过,服务器返回数据:

 


Xml代码 
<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> 

<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>

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


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

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

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

补充:软件开发 , Java ,
CopyRight © 2022 站长资源库 编程知识问答 zzzyk.com All Rights Reserved
部分文章来自网络,