foreach 活动允许通过一条单独的流程路径 开始执行多条流程分支。 它的属性描述见下表。
属性 |
类型 |
默认值 |
是否必须? |
描述 |
in |
表达式或字符串 |
|
必须 |
将被迭代的集合。集合中的每个元素会生成一个新的同步分支 沿着默认的转移向外执行。in 执行任意类型的集合,数组和以逗号分隔的字符串。 |
var |
表达式或字符串 |
|
必须 |
用来保存集合中当前元素的变量。 这个变量会设置到同步流程分支中, 并且只对这个流程分支可见。 |
在这个例子中,我们需要收集 不同部门的考勤表。同一个任务可以被不同的组织执行。 使用foreach就很容易实现了。 流程变量departments提供了所需要的组织名称, 同时,变量quota代表了多少个任务必须被完成, 在流程离开join之前。
<process name="ForEach" xmlns="http://jbpm.org/4.4/jpdl">
<start g="28,61,48,48" name="start1">
<transition to="foreach1"/>
</start>
<foreach var="department" in="#{departments}" g="111,60,48,48" name="foreach1">
<transition to="Collect reports"/>
</foreach>
<task candidate-groups="#{department}" g="201,58,92,52" name="Collect reports">
<transition to="join1"/>
</task>
<join g="343,59,48,48" multiplicity="#{quorum}" name="join1">
<transition to="end1"/>
</join>
<end g="433,60,48,48" name="end1"/>
</process>
在使用foreach的时候,对应的join必须设置一个multiplicity属性。 如果没有设置,join会根据它的进入转移来判断当前的流程是否需要继续流转。 在上面的例子里,join只有一个单独的进入转移。 如果multiplicity没有设置,第一个流程到达join活动 就会立刻触发继续执行离开join。
下面是如何初始化迭代用的流程变量。
Map<String, Object> variables = new HashMap<String, Object>();
variables.put("departments", new String[] { "sales-dept", "hr-dept", "finance-dept" });
variables.put("quorum", 3);
ProcessInstance processInstance = executionService.startProcessInstanceByKey("ForEach", variables);