概述
jBPM 6 提供 Rest API 供第三方应用整合使用 jBPM 6,本文演示如果通过 Rest API:
- 启动流程
- 获取流程实例信息
- 启动 User Task
- 完成 User Task
本文所使用的流程如下
如上流程只有一个 User Task 节点,User Task 执行开始和执行结束都输出相关提示。流程 ID为 org.brms.test,节点名字为 Test,执行节点需要的 userID 为 kylin,角色为 IT。
为方便观察,我们需要 jBPM 6 使用 Mysql 替换默认的 H2 数据库。
启动流程
启动流程 Rest API 如下:
/runtime/{id: [a-zA-Z0-9-:\\.]+}")/process/{id: [a-zA-Z0-9-:\\.]+}/start
运行 RestEasyClientProcessStart.java 启动流程,启动流程后我们到数据库中查看:
mysql> select id, duration, start_date, end_date, processId, processInstanceId, processName, status from ProcessInstanceLog; +----+----------+---------------------+---------------------+---------------+-------------------+-------------+--------+ | id | duration | start_date | end_date | processId | processInstanceId | processName | status | +----+----------+---------------------+---------------------+---------------+-------------------+-------------+--------+ | 1 | 51569 | 2014-05-10 21:17:20 | 2014-05-10 21:18:11 | org.brms.test | 1 | test | 2 | | 2 | 3770025 | 2014-05-10 21:24:57 | 2014-05-10 22:27:47 | org.brms.test | 2 | test | 2 | | 3 | 4060507 | 2014-05-10 21:25:33 | 2014-05-10 22:33:13 | org.brms.test | 3 | test | 2 | | 4 | 2620216 | 2014-05-10 21:49:41 | 2014-05-10 22:33:21 | org.brms.test | 4 | test | 2 | | 5 | 2561315 | 2014-05-10 21:50:49 | 2014-05-10 22:33:30 | org.brms.test | 5 | test | 2 | | 6 | 2557182 | 2014-05-10 21:51:01 | 2014-05-10 22:33:38 | org.brms.test | 6 | test | 2 | | 7 | 2558504 | 2014-05-10 21:51:07 | 2014-05-10 22:33:45 | org.brms.test | 7 | test | 2 | | 8 | NULL | 2014-05-11 13:21:05 | NULL | org.brms.test | 1 | test | 1 | +----+----------+---------------------+---------------------+---------------+-------------------+-------------+--------+
如上ProcessInstanceLog表中 ID 为 8 的;流程示例为我们通过 Rest API 启动的流程实例,注意,status列为1表示流程未被执行。
获取流程实例
获取流程实例 Rest API 如下:
/runtime/{id: [a-zA-Z0-9-:\\.]+}")/process/instance/{id: [0-9]+}
运行 RestEasyClientGetProcessInstance.java 获取流程实例 ,我们运行结果会有如下输出
ProcessInstance 1 [processId=org.brms.test,state=1]
注意,我们测试流程的ID 为 org.brms.test,数据库中 processInstanceId 为 1,所以我们的 Rest Path如下:
http://localhost:8080/business-central/rest/runtime/org.kie.example:project1:1.0.0-SNAPSHOT/process/instance/1
开始 User Task
开始 User Task Rest API 如下:
/task/execute{id: \\d+}/start
运行 RestEasyClientTaskStart.java 开始执行 User Task ,开始执行之前我们首先到数据库中看当前 User Task 的信息:
mysql> select id, createdOn, deploymentId, processInstanceId, processId, status, createdBy_id from Task; +----+---------------------+-----------------------------------------+-------------------+---------------+----------+--------------+ | id | createdOn | deploymentId | processInstanceId | processId | status | createdBy_id | +----+---------------------+-----------------------------------------+-------------------+---------------+----------+--------------+ | 1 | 2014-05-11 13:21:05 | org.kie.example:project1:1.0.0-SNAPSHOT | 1 | org.brms.test | Reserved | kylin | +----+---------------------+-----------------------------------------+-------------------+---------------+----------+--------------+
注意,此 Task 与 processInstanceId 为 1 的流程示例关联,当前状态没有开始。
运行 RestEasyClientTaskStart.java 开始执行 User Task ,执行之后我们同样到数据库查看当前 User Task 的信息:
mysql> select id, createdOn, deploymentId, processInstanceId, processId, status, createdBy_id from Task; +----+---------------------+-----------------------------------------+-------------------+---------------+------------+--------------+ | id | createdOn | deploymentId | processInstanceId | processId | status | createdBy_id | +----+---------------------+-----------------------------------------+-------------------+---------------+------------+--------------+ | 1 | 2014-05-11 13:21:05 | org.kie.example:project1:1.0.0-SNAPSHOT | 1 | org.brms.test | InProgress | kylin | +----+---------------------+-----------------------------------------+-------------------+---------------+------------+--------------+
主要当前 Task 的状态改变为 InProgress。
完成User Task
完成User Task Rest API 如下:
/task/execute{id: \\d+}/complete
运行 RestEasyClientTaskComplete.java 可以完成 User Task ,执行完成后去数据库查看当前 User Task 的信息:
mysql> select id, createdOn, deploymentId, processInstanceId, processId, status, createdBy_id from Task; Empty set (0.00 sec)
如上数据库中没有Task信息,即jBPM 中当某一 Task 执行完成后会将其的信息删除,如果我们接着去查看流程实例的信息:
mysql> select id, duration, start_date, end_date, processId, processInstanceId, processName, status from ProcessInstanceLog; +----+----------+---------------------+---------------------+---------------+-------------------+-------------+--------+ | id | duration | start_date | end_date | processId | processInstanceId | processName | status | +----+----------+---------------------+---------------------+---------------+-------------------+-------------+--------+ | 1 | 51569 | 2014-05-10 21:17:20 | 2014-05-10 21:18:11 | org.brms.test | 1 | test | 2 | | 2 | 3770025 | 2014-05-10 21:24:57 | 2014-05-10 22:27:47 | org.brms.test | 2 | test | 2 | | 3 | 4060507 | 2014-05-10 21:25:33 | 2014-05-10 22:33:13 | org.brms.test | 3 | test | 2 | | 4 | 2620216 | 2014-05-10 21:49:41 | 2014-05-10 22:33:21 | org.brms.test | 4 | test | 2 | | 5 | 2561315 | 2014-05-10 21:50:49 | 2014-05-10 22:33:30 | org.brms.test | 5 | test | 2 | | 6 | 2557182 | 2014-05-10 21:51:01 | 2014-05-10 22:33:38 | org.brms.test | 6 | test | 2 | | 7 | 2558504 | 2014-05-10 21:51:07 | 2014-05-10 22:33:45 | org.brms.test | 7 | test | 2 | | 8 | 1069981 | 2014-05-11 13:21:05 | 2014-05-11 13:38:54 | org.brms.test | 1 | test | 2 | +----+----------+---------------------+---------------------+---------------+-------------------+-------------+--------+
我们可以发现 ID 为 8,processInstanceId 为 1的流程 status栏变为 2,这表明流程已经执行完成,我们也可以发现流程开始时间为 2014-05-11 13:21:05,结束时间为 2014-05-11 13:38:54,执行的周期(duration)为 1069981 毫秒。