如何使用服务编排实现呼吸机申请服务

场景描述

实现场景：由于呼吸机资源缺乏，为了有效利用剩余的呼吸机，需要提供呼吸机申请服务进行资源调度。申请人调用服务接口提供医院信息和申请呼吸机资源数量，服务根据系统中处于空闲状态下的呼吸机资源判断资源是否充足，在资源充足的情况下返回被申请的呼吸机信息并修改系统中相应呼吸机的医院信息和状态。

实现方案：使用服务编排实现上述功能，实现逻辑如下：

通过调用查询对象数据中创建的服务编排，获取系统中空闲状态下的呼吸机信息。
通过调用使用服务编排开发业务的基本逻辑中创建的服务编排，进行资源是否充足的判断，返回被申请的呼吸机信息。
通过决策图元判断上一步骤返回的申请呼吸机信息，做出下一步操作。
- 走“ResourceEnough”分支：在资源满足的情况下，调用修改对象数据中创建的服务编排，修改系统中被申请的呼吸机的医院信息和状态。
- 走“ResourceNotEnough”分支：在资源不足的情况下，返回错误信息。

图1 呼吸机申请服务总体流程

前提条件

参考使用服务编排开发业务的基本逻辑中操作，创建呼吸机资源对象Respirator，作为呼吸机申请服务处理的对象。
参考使用服务编排开发业务的基本逻辑中操作，开发服务编排，实现对Respirator对象数据进行逻辑处理。
参考如何使用服务编排开发数据的增删改查中操作，开发服务编排，实现对Respirator对象数据进行增删改查。

如何开发呼吸机申请服务

参考如何开发服务编排中操作，创建“名称”和“标签”为“RespiratorApply”的服务编排。

参照表1，定义服务编排用到的变量，并设置该服务编排的入参和出参。

表1 变量说明
变量名	变量类型	变量说明
num	数字	申请的呼吸机数量。
hospital	文本	申请呼吸机的医院。
msg	文本	申请结果。
RespiratorInfos	Respirator对象数组	系统中空闲状态下的呼吸机资源数组（后用于存放信息修改后的资源数组）。
RespiratorRecs	Respirator对象数组	此次申请的原始呼吸机资源数组。

在服务编排编辑器页面右侧，选择，在全局上下文页面单击“变量”后的。
图2 创建变量
单击新增变量后的“...”，选择“设置”。
图3 设置变量

配置数字类型的变量“num”，单击“保存”。

图4 配置变量

表2 普通变量参数说明
参数	参数说明
名称	新增变量的名称，直接输入“num”。
数据类型	变量的数据类型，根据业务需求直接在下拉框中选择。本示例设置为“数字”。
默认值	变量的默认取值。本示例不用配置。
描述	新增变量的描述说明，建议填写该变量的作用。
是否为数组	是否为数组型变量即集合变量。本示例不勾选。
外部使用	若勾选该选项，表示该变量为外部使用变量，编译时不校验其是否被使用。本示例不勾选。

参考上述操作，创建文本类型的变量“hospital”、“msg”。
图5 成功创建变量
在服务编排编辑器页面右侧，选择，在全局上下文页面单击“对象变量”后的。
图6 创建对象变量
参考上述操作，新建对象变量“RespiratorInfos”，对象中选择前提条件中创建的对象Respirator，设置字段描述信息（可选），选中“是否为数组”，单击“保存”。
图7 配置数组类型对象变量
参考上述操作，创建数组类型的对象变量“RespiratorRecs”，注意要选中“是否为数组”。
单击画布中的“开始”图元，在右侧菜单选择，单击右上角“全局上下文”展开“全局上下文”页面，将变量num、变量hospital拖拽到“入参”中，将变量msg、对象变量RespiratorRecs拖拽到“出参”中。
图8 配置开始图元

编排该服务主要使用了三种图元，分别是“子服务编排”“赋值”、“决策”图元，按照下图将相关图元拖拽到画布中对应位置。

图9 拖拽图元
在画布上，把鼠标放在起点图元上，从“+”拖动鼠标，在起点图元和“子服务编排”图元Flow0间增加连线。
配置“子服务编排”图元Flow0。
1. 单击画布中的“子服务编排”图元Flow0，在“基本信息”页面中配置图元标签为“查询呼吸机资源”，名称为“SelectRespirator”。
  图10 配置“子服务编排”图元基本信息
2. 如下图所示，单击，在“子服务编排”页面“服务编排实例”中，选择查询对象数据创建的服务编排“SelectRespirator”。配置输出参数，从“全局上下文”页面拖拽变量到“目标”中。
  图11 配置子服务编排图元Flow0
  
  如上图配置，将调用查询对象数据中开发的查询对象记录服务编排，并将查询结果存放到对象变量RespiratorInfos中。
从“子服务编排”图元“SelectRespirator”，连向“子服务编排”图元Flow1。
配置“子服务编排”图元Flow1。
1. 单击画布中的“子服务编排”图元Flow1，在“基本信息”页面中配置图元标签为“处理呼吸机资源”，名称为“ProcessRespiratorResouce”。
2. 如下图所示，单击，在“子服务编排”页面“服务编排实例”中，选择使用服务编排开发业务的基本逻辑创建的服务编排“ProcessRespiratorResource”，配置入参和出参。
  图12 配置子服务编排图元Flow1
  
  如上图配置，将调用使用服务编排开发业务的基本逻辑中开发的资源处理服务编排，并将查询对象记录服务编排中返回的空闲状态下呼吸机资源以及申请医院、资源数量作为入参传入，返回申请结果、被申请的呼吸机资源以及修改信息后的呼吸机资源数组存入相应对象变量。
3. 从“子服务编排”图元“ProcessRespiratorResouce”连向“决策”图元Decision0。
配置“决策”图元Decision0。
1. 单击画布中的“决策”图元Decision0，在“基本信息”页面中配置图元标签为“判断资源是否充足”，名称为“judgeResource”。
2. 在“决策”页面中，单击“默认”结果，将名称设置为“ResourceEnough”，单击“新增”，新增一个名为“ResourceNotEnough”的结果，并按照下图进行配置。
  图13 配置默认结果
  
  图14 新增“ResourceNotEnough”
  
  “ResourceNotEnough”结果表示当返回的资源数组为空时，代表资源不足，走向赋值图元设置错误信息。默认的“ResourceEnough”结果代表资源充足，将进行系统中数据的修改。
3. 从“决策”图元“judgeResource”连向“子服务编排”图元Flow2，连线类型为“ResourceEnough”，从“决策”图元Decision0连向“赋值”图元Assignment0，连线类型为“ResourceNotEnough”。
配置“子服务编排”图元Flow2。
1. 单击画布中的“子服务编排”图元Flow2，在“基本信息”页面中配置图元标签为“修改呼吸机资源状态”，名称为“UpdateRespiratorResource”。
2. 如下图所示，单击，在“子服务编排”页面“服务编排实例”中，选择修改对象数据中创建的服务编排“UpdateRespirator”，并配置输入参数。
  图15 配置子服务编排图元Flow2
  
  如上图配置，将调用修改对象数据中开发的修改对象记录服务编排，根据传入的对象变量RespiratorInfos对系统中的对象数据进行修改。
配置“赋值”图元Assignment0。
1. 单击画布中的“赋值”图元Assignment0，在“基本信息”页面中配置图元标签为“设置错误信息”，名称为“setError1”。
2. 如下图所示，单击，在“赋值”页面进行配置赋值语句，在资源不足的情况下设置相应的错误信息。
  图16 配置赋值图元Assignment0
单击页面上方的，保存服务编排。
保存成功后，单击，运行服务编排。
进行测试。
- 当资源不足时，测试服务是否报错并返回相应错误信息。
  1. 设置输入参数，单击“运行”，人民第66医院需要申请5台呼吸机。
```
{
    "hospital": "人民第66医院",
    "num": 5
}
```
  2. 检查输出页签的结果，是否符合预期。
    返回如下信息，表示资源不足，申请失败。
    
    图17 输出结果
- 当资源充足时，返回信息“资源充足，呼吸机申请成功！”，以及申请的呼吸机资源信息，并修改系统中对象数据。
  1. 打开创建对象数据中创建的服务编排“CreateRespirator”，单击页面上方的，运行服务编排。
  2. 设置输入参数，单击“运行”，创建5台某医院空闲的呼吸机。
    其中，“CNAME”为命名空间名称，请替换为环境中实际配置的命名空间。
```
{
    "RespiratorInfos": [
        {
            "name": "呼吸机1",
            "CNAME__hospital__CST": "第1人民医院",
            "CNAME__status__CST": "空闲"
        },
        {
            "name": "呼吸机2",
            "CNAME__hospital__CST": "第1人民医院",
            "CNAME__status__CST": "空闲"
        },
        {
            "name": "呼吸机3",
            "CNAME__hospital__CST": "第1人民医院",
            "CNAME__status__CST": "空闲"
        },
        {
            "name": "呼吸机4",
            "CNAME__hospital__CST": "第1人民医院",
            "CNAME__status__CST": "空闲"
        },
        {
            "name": "呼吸机5",
            "CNAME__hospital__CST": "第1人民医院",
            "CNAME__status__CST": "空闲"
        }
    ]
}
```
  3. 打开本节开发的服务编排“RespiratorApply”，单击页面上方的，运行服务编排。
  4. 设置输入参数，单击“运行”，人民第66医院需要申请5台呼吸机。
```
{
    "hospital": "人民第66医院",
    "num": 5
}
```
  5. 检查输出页签的结果，是否符合预期。
    资源充足时，如下图所示返回信息“资源充足，呼吸机申请成功！”，以及申请的呼吸机资源信息。
    
    图18 输出界面
单击页面上方的，启用服务编排。