Flowable工作流学习
教程地址：https://tkjohn.github.io/flowable-userguide/#bpmnConditionalSequenceFlow
<?xml version="1.0" encoding="UTF-8"?> <definitions xmlns="http://www.omg.org/spec/BPMN/20100524/MODEL" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:flowable="http://flowable.org/bpmn" xmlns:bpmndi="http://www.omg.org/spec/BPMN/20100524/DI" xmlns:omgdc="http://www.omg.org/spec/DD/20100524/DC" xmlns:omgdi="http://www.omg.org/spec/DD/20100524/DI" typeLanguage="http://www.w3.org/2001/XMLSchema" expressionLanguage="http://www.w3.org/1999/XPath" targetNamespace="http://www.flowable.org/processdef"> <process id="holley-test8" name="zhl-test8" isExecutable="true"> <documentation>后礼测试流程</documentation> <!-- 执行监听器 可以捕获的事件：1.流程实例的启动和结束。2.流程执行转移。3.活动的启动和结束。4.网关的启动和结束。5.中间事件的启动和结束。6.启动事件的结束，和结束事件的启动。 <flowable:executionListener class="类名全路径" event="start"/> 注意：这个类需要实现org.flowable.engine.delegate.ExecutionListener接口 <flowable:executionListener expression="${myPojo.myMethod(execution.event)}" event="end" /> 注意：execution.event将事件作为参数传递 执行监听器也支持使用delegateExpression。 <flowable:executionListener event="start" delegateExpression="${myExecutionListenerBean}" /> --> <extensionElements> <flowable:executionListener class="com.insgeek.platform.event.holley.listener.MyExecutionListener" event="start"/> <!-- <flowable:eventListener events="ACTIVITY_COMPLETED" class="com.insgeek.platform.event.holley.listener.MyEventListener"/>--> </extensionElements> <!-- <extensionElements>--> <!-- <flowable:eventListener class="com.insgeek.platform.event.holley.listener.MyEventListener" />--> <!-- <flowable:eventListener delegateExpression="${testEventListener}" events="JOB_EXECUTION_SUCCESS,JOB_EXECUTION_FAILURE" />--> <!-- </extensionElements>--> <startEvent id="startEvent1"/> <userTask id="task-number-01" name = "${name}任务1" flowable:formFieldValidation="true" flowable:assignee="${holidayForm.name}"> <!-- flowable:candidateUsers="" --> <!-- flowable:candidateGroups=""--> <extensionElements> <flowable:formProperty id="days" expression="${days}" required="true" type="int" name="请假天数"/> <flowable:formProperty id="name" expression="${name}" required="true" name="请假天数"/> <flowable:formProperty id="id" expression="${id}" type="long" required="true" name="请假人id"/> </extensionElements> </userTask> <sequenceFlow id="line-number-01" sourceRef="startEvent1" targetRef="task-number-01"/> <!-- 服务任务： 注意: flowable:class="全路径类名" 这个方法主要使用在service task中,此处作为测试 (指定实现了JavaDelegate或ActivityBehavior的类) 调用解析为委托对象（delegation object）的表达式 ：delegateExpressionBean是一个实现了JavaDelegate接口的bean，定义在Spring容器中 <serviceTask id="serviceTask" flowable:delegateExpression="${delegateExpressionBean}" 调用方法表达式（method expression）： 将在名为printer的对象上调用printMessage方法（不带参数） <serviceTask id="javaService" name="My Java Service Task" flowable:expression="${printer.printMessage()}" /> 将在名为printer的对象上调用printMessage方法。传递的第一个参数为DelegateExecution，名为execution，在表达式上下文中默认可用。传递的第二个参数， 是当前执行中，名为myVar变量的值。 <serviceTask id="javaService" name="My Java Service Task" flowable:expression="${printer.printMessage(execution, myVar)}" /> 对值表达式（value expression）求值 会调用名为split的bean的ready参数的getter方法，getReady（不带参数）。该对象会被解析为执行的流程变量或（如果可用的话）Spring上下文中的bean <serviceTask id="javaService" name="My Java Service Task" flowable:expression="${split.ready}" /> 只会为serviceTask上定义的Java类创建一个实例。所有流程实例共享同一个类实例，用于调用execute(DelegateExecution)。这意味着该类不能有任何成员变量， 并需要是线程安全的，因为它可能会在不同线程中同时执行。这也影响了字段注入的使用方法。 flowable:class和flowable:delegateExpression支持字段注入,如下： <extensionElements> <flowable:field name="text" stringValue="Hello World" /> </extensionElements> 对于较长文本： <extensionElements> <flowable:field name="text"> <flowable:string> This is a long string </flowable:string> </flowable:field></extensionElements> <extensionElements> <flowable:field name="text1"> <flowable:expression>${genderBean.getGenderString(gender)}</flowable:expression> </flowable:field> <flowable:field name="text2"> <flowable:expression>Hello ${gender == 'male' ? 'Mr.' : 'Mrs.'} ${name}</flowable:expression> </flowable:field> </ extensionElements> 另外，为避免XML太过冗长，可以将表达式设置为属性，而不是子元素。 <flowable:field name="text1" expression="${genderBean.getGenderString(gender)}" /> <flowable:field name="text1" expression="Hello ${gender == 'male' ? 'Mr.' : 'Mrs.'} ${name}" /> --> <!-- 方法表达式(method expression)调用 bean中的方法--> <serviceTask id="task-number-02" name="服务任务1" flowable:class="com.insgeek.platform.event.holley.task.TestServiceTaskDelegate"> <!-- flowable:expression="${holidayForm.toString()}" --> <extensionElements> <flowable:formProperty id="approve" expression="${approve}" required="true" type="boolean" name="审批结果"/> <flowable:formProperty id="days" expression="${days}" required="true" type="int" name="请假天数"/> </extensionElements> </serviceTask> <sequenceFlow id="line-number-02" sourceRef="task-number-01" targetRef="task-number-02"> <extensionElements> <!-- 流程转移时执行监听器 在流程执行转移时被调用。请注意listener元素并未定义event，因为在转移上只会触发take事件。当监听器定义在转移上时，event属性的值将被忽略 --> <flowable:executionListener class="com.insgeek.platform.event.holley.listener.MyExecutionListener" /> </extensionElements> </sequenceFlow> <!-- 条件顺序流： 条件顺序流的XML表示格式为含有conditionExpression（条件表达式）子元素的普通顺序流。 请注意目前只支持tFormalExpressions可以省略xsi:type=""定义，默认为唯一支持的表达式类型 目前conditionalExpressions只能使用UEL。使用的表达式需要能解析为boolean值，否则当计算条件时会抛出异常。 这个例子通过典型的JavaBean的方式，使用getter引用流程变量的数据 <conditionExpression xsi:type="tFormalExpression"> <![CDATA[${order.price > 100 && order.price < 250}]]> </conditionExpression> 这个例子调用了一个解析为boolean值的方法： <conditionExpression xsi:type="tFormalExpression"> <![CDATA[${order.isStandardOrder()}]]> </conditionExpression> --> <exclusiveGateway id="gateway-number-01"/> <sequenceFlow id="line-number-03" sourceRef="task-number-02" targetRef="gateway-number-01"/> <!-- 任务监听器：用于在特定的任务相关事件发生时，执行自定义的Java逻辑或表达式。*只能*在流程定义中作为用户任务的子元素 任务监听器包含下列属性： event（事件）（必填）：触发任务监听器的任务事件类型。可用的事件有： create（创建）：当任务已经创建，并且所有任务参数都已经设置时触发。 assignment（指派）：当任务已经指派给某人时触发。请注意：当流程执行到达用户任务时，在触发create事件之前，会首先触发assignment事件。 这顺序看起来不太自然，但是有实际原因的：当收到create事件时，我们通常希望能看到任务的所有参数，包括办理人。 complete（完成）：当任务已经完成，从运行时数据中删除前触发。 delete（删除）：在任务即将被删除前触发。请注意任务由completeTask正常完成时也会触发。 class：需要调用的委托类。这个类必须实现org.flowable.engine.delegate.TaskListener接口。 expression：（不能与class属性一起使用）：指定在事件发生时要执行的表达式。可以为被调用的对象传递DelegateTask对象与事件名（使用task.eventName）作为参数。 <flowable:taskListener event="create" expression="${myObject.callMethod(task, task.eventName)}" /> delegateExpression：指定一个能够解析为TaskListener接口实现类的对象的表达式。与服务任务类似。 <flowable:taskListener event="create" delegateExpression="${myTaskListenerBean}" /> --> <userTask id="task-number-03" name="${name}任务2" flowable:assignee="zhl" > <!-- flowable:candidateUsers="user1,user2" 当使用候选人分配时，会创建一个任务，但是任务中的assignee的值为null。 而且如果同时配置flowable:assignee和flowable:candidateUsers，则只会创建flowable:assignee的任务 --> <extensionElements> <!-- 任务监听器,可以在任务监听器中动态分配用户--> <flowable:taskListener event="complete" class="com.insgeek.platform.event.holley.listener.MyAssignmentHandlerTaskListener" /> <!-- 活动结束时执行监听器--> <flowable:executionListener expression="${myExpressionExecutionListener.test(execution.eventName)}" event="end" /> </extensionElements> <!-- 指派具体用户 --> <!-- <humanPerformer>--> <!-- <resourceAssignmentExpression>--> <!-- <formalExpression>test</formalExpression>--> <!-- </resourceAssignmentExpression>--> <!-- </humanPerformer>--> </userTask> <userTask id="task-number-04" name="${name}任务4" flowable:candidateUsers="aaa,bbb"> <!-- flowable:assignee="${name}"--> <extensionElements> <flowable:executionListener event="start" expression=" ${rejectExecutionListener.test(execution)}"/> <!-- 添加一个在事件create时的监听器，在监听器中可以将该事件分配给其它人， 分配之后，原处理人没有权限了，但此时在ru_identityLink表中还会为之前的处理人创建N条数据（假设实例是Q个，如果是m个候选人的话，n=(m+1)*Q。如果是指定的某个处理人，则n=Q）--> <flowable:taskListener event="create" class = "com.insgeek.platform.event.holley.listener.AssignmentTaskListener"/> </extensionElements> <!-- 多实例时，会给每个指派的用户创建数量等同于assigneeList长度的并行任务，只是每一个执行任务都有一个名为user的（局部）流程变量，含有集合userList中的一项值 --> <multiInstanceLoopCharacteristics isSequential="false" flowable:collection="${myTest.getUsers(execution)}" flowable:elementVariable="user" > <!-- flowable:collection="userList" flowable:elementVariable="user" >--> <completionCondition>${nrOfCompletedInstances/nrOfInstances >= 0.3 }</completionCondition> </multiInstanceLoopCharacteristics> </userTask> <sequenceFlow id="line-number-04" sourceRef="gateway-number-01" targetRef="task-number-03" > <!-- 注意：条件流下面添加执行监听器时，顺序一定要放在条件标签上面，否则会报错 --> <extensionElements> <!-- 流程转移时执行监听器 在流程执行转移时被调用。请注意listener元素并未定义event，因为在转移上只会触发take事件。当监听器定义在转移上时，event属性的值将被忽略 --> <flowable:executionListener class="com.insgeek.platform.event.holley.listener.MyExecutionListener2" /> </extensionElements> <conditionExpression xsi:type="tFormalExpression"> <![CDATA[ ${days > 3} ]]> </conditionExpression> </sequenceFlow> <sequenceFlow id="line-number-05" sourceRef="gateway-number-01" targetRef="task-number-04"> <extensionElements> <!-- 流程转移时执行监听器 在流程执行转移时被调用。请注意listener元素并未定义event，因为在转移上只会触发take事件。当监听器定义在转移上时，event属性的值将被忽略 --> <flowable:executionListener class="com.insgeek.platform.event.holley.listener.MyExecutionListener3" /> </extensionElements> <conditionExpression xsi:type="tFormalExpression"> <![CDATA[ ${days <= 3} ]]> </conditionExpression> </sequenceFlow> <endEvent id="endEvent1"> <extensionElements> <flowable:executionListener class="com.insgeek.platform.event.holley.listener.MyEndExecutionListener" event="end"/> </extensionElements> </endEvent> <sequenceFlow id="line-number-06" sourceRef="task-number-03" targetRef="endEvent1"/> <sequenceFlow id="line-number-07" sourceRef="task-number-04" targetRef="endEvent1" /> <!-- 多实例：网关与事件不能设置为多实例。 按照BPMN2.0规范的要求，用于为每个实例创建执行的父执行，会提供下列变量： nrOfInstances：实例总数。 nrOfActiveInstances：当前活动的（即未完成的），实例数量。对于顺序多实例，这个值总为1。 nrOfCompletedInstances：已完成的实例数量。 可以调用execution.getVariable(x)方法获取这些值。 每个被创建的执行，都有局部变量（对其他执行不可见，也不存储在流程实例级别） loopCounter：给定实例在for-each循环中的index。可以通过Flowable的elementIndexVariable属性为loopCounter变量重命名 --> </process> </definitions>
注意事项：
1.在条件流上添加执行监听器时，一定要保证extensionElements元素放在conditionExpression元素之前，否则会报错，正确顺序如下：
<sequenceFlow id="line-number-04" sourceRef="gateway-number-01" targetRef="task-number-03" > <!-- 注意：条件流下面添加执行监听器时，顺序一定要放在条件标签上面，否则会报错 --> <extensionElements> <!-- 流程转移时执行监听器 在流程执行转移时被调用。请注意listener元素并未定义event，因为在转移上只会触发take事件。当监听器定义在转移上时，event属性的值将被忽略 --> <flowable:executionListener class="com.insgeek.platform.event.holley.listener.MyExecutionListener" /> </extensionElements> <conditionExpression xsi:type="tFormalExpression"> <![CDATA[ ${days > 3} ]]> </conditionExpression> </sequenceFlow>
