第 7 章 Variables变量
流程变量在流程外部,通过ExecutionService
提供的方法进行访问:
ProcessInstance startProcessInstanceById(String processDefinitionId, Map<String, Object> variables);
ProcessInstance startProcessInstanceById(String processDefinitionId, Map<String, Object> variables, String processInstanceKey);
ProcessInstance startProcessInstanceByKey(String processDefinitionKey, Map<String, ?> variables);
ProcessInstance startProcessInstanceByKey(String processDefinitionKey, Map<String, ?> variables, String processInstanceKey);
void setVariable(String executionId, String name, Object value);
void setVariables(String executionId, Map<String, ?> variables);
Object getVariable(String executionId, String variableName);
Set<String> getVariableNames(String executionId);
Map<String, Object> getVariables(String executionId, Set<String> variableNames);
在流程中可以通过Execution接口,传递给用户代码,比如 ActivityExecution
和EventListenerExecution
:
Object getVariable(String key);
void setVariables(Map<String, ?> variables);
boolean hasVariable(String key);
boolean removeVariable(String key);
void removeVariables();
boolean hasVariables();
Set<String> getVariableKeys();
Map<String, Object> getVariables();
void createVariable(String key, Object value);
void createVariable(String key, Object value, String typeName);
jBPM没有自动检测变量值变化的机制。 比如,从实例变量中获得了一个序列化的集合,添加了一个元素, 然后你就需要把变化了的变量值准确的保存到DB中。
默认情况下,变量创建在顶级的流程实例作用域中。 这意味着它们对整个流程实例中的所有执行都是可见的,可访问的。 流程变量是动态创建的。意味着,当一个变量通过任何一个方法设置到流程中, 整个变量就会被创建了。
每个执行都有一个变量作用域。声明在内嵌执行级别中的变量, 可以看到它自己的变量和声明在上级执行中的变量,这时按照正常的作用域规则。 使用execution接口中的createVariable
方法, ActivityExecution
和EventListenerExecution
可以创建流程的局部变量。
在未来的发布中,我们可能添加在jPDL流程语言中声明的变量。
jBPM支持下面的Java类型,作为流程变量:
- java.lang.String
- java.lang.Long
- java.lang.Double
- java.util.Date
- java.lang.Boolean
- java.lang.Character
- java.lang.Byte
- java.lang.Short
- java.lang.Integer
- java.lang.Float
- byte[] (byte array)
- char[] (char array)
- hibernate entity with a long id
- hibernate entity with a string id
- serializable
为了持久化这些变量,变量的类型会按照这个列表中的例子进行检测。 第一个匹配的类型, 会决定变量如何保存。
(jBPM 4.3中新添加的功能)
在 custom
s, event-handler
s 和其他 用户代码中,你可以获取流程变量。当一个流程变量作为 持久化的对象被保存时,你可以直接更新反序列化的对象, 而不需要再次进行保存。jBPM会管理反序列化的流程变量 如果出现了修改就会自动更新它们。比如(参考报org.jbpm.examples.serializedobject), 查看一个custom
活动行为内的代码片段:
public class UpdateSerializedVariables implements ActivityBehaviour { public void execute(ActivityExecution execution) { Set<String> messages = (Set<String>) execution.getVariable("messages"); messages.clear(); messages.add("i"); messages.add("was"); messages.add("updated"); } }
当事务提交时,用户代码会被调用, 更新消息集合会自动被更新到数据库中。
当从DB读取以序列化格式保存的流程变量时, jBPM会监控反序列化的对象。在事务提交之前, jBPM会反序列化并自动更新变量,如果必要的话。 jBPM会忽略更新反序列化对象,如果其他对象被设置到那个作用域 (这可能是其他类型)。jBPM也会略过更新 那些数值没有发生变化的的反序列化对象。这些检测会查看 如果一个对象被修改了,基于计算再次序列化对象的字节数组, 和从数据库中原来读取的字节数组进行比较。
(从 jBPM 4.4 开始)
变量可以被直接定义在流程定义中(jPDL)。这些变量 会在流程实例启动时被创建。这里可能有多于一个的变量定义。
这儿有几种可能方式来声明变量:
- 声明
字符串
变量,使用静态文本初始化<variable name="declaredVar" type="string" init-expr="testing declared variable"/>
- 声明
自定义
变量,使用EL进行初始化<variable name="declaredVar" type="long" init-expr="#{anotherVar}"/>
- 声明
自定义
变量,使用可持久化的类进行初始化<variable name="declaredVar" type="serializable" > <object class="org.jbpm.examples.variable.declared.HistoryVariable" /> </variable>
就像上面演示的那样,变量值可以通过两种方式设置:使用init-expr
属性 或通过内嵌的init标识符(object
元素)在变量标签中。
注意,每个流程定义只能使用一个赋值方式。
表 7.1. variable
元素的属性:
name |
字符串 | 必须 | 变量的名称 | |
type |
字符串 | 必须 | 变量的类型,必须引用jbpm.variable.types.xml中定义的类型 | |
init-expr |
字符串(EL表达式) | 可选 | 变量的值,这个属性或内嵌元素必须设置 | |
init-expr-type |
字符串 | UEL | 可选 | 定义表达式执行的语言 |
history |
boolean | false | 可选 | 表示变量是否需要保存到历史库中 - 默认为false。 更多历史的信息,请参考第 7.5 节 “变量历史” |
(从 jBPM 4.4 开始)
变量可以被标记为作为历史记录保存。这意味着,当流程实例结束, 它的运行阶段的信息被删除,历史细节依然会被保存。
有两种方式可以启用变量的历史功能:
- 通过公共 API
ExecutionService
:void createVariable(String executionId, String name, Object value, boolean historyEnabled);
void createVariables(String executionId, Map<String, ?> variables, boolean historyEnabled);
- 通过变量定义
<variable name="declaredVar" type="string" init-expr="testing declared variable" history="true"/>
当前,所有变量历史都会作为字符串
值保存。 变量(无论什么类型)会被转换成一个字符串的值,使用toString()
方法。 在自定义对象的情况,它们需要重写toString()
方法来提供字符串的内容, 这些内容会作为历史记录保存下来。这就提供了一个简单的方法, 可以根据变量值来进行搜索的功能。
可以通过 HistoryService
方法来访问历史变量:
Object getVariable(String processInstnceId, String name);
Map<String, Object> getVariables(String processInstnceId, Set<String> variableNames);
Set<String> getVariableNames(String processInstnceId);
相关推荐
**JBPM深入解析之变量设计** JBPM(Java Business Process Management)是一款开源的工作流程管理系统,它提供了业务流程的建模、部署、执行和监控等功能。在JBPM中,变量是流程实例中的数据容器,用于存储流程运行...
变量(Variables)是流程中的数据容器,文档对变量作用域、变量类型和如何更新持久化流程变量等方面进行了阐述。变量声明、变量历史记录也是在流程设计中必须要考虑的问题。 最后,文档还提到了脚本化(Scripting),这...
- **变量(Variables)**:存储流程实例中所需数据的对象,可以是业务数据或流程状态。 **学习价值** 此示例对于初学者来说具有很高的学习价值,因为它直观地展示了jbpm如何与实际业务场景相结合。通过分析代码,...
《深入浅出jBPM:1-6章测试代码详解》 jBPM,全称为Java Business Process Management,是一款开源的工作流管理...希望这篇关于《深入浅出jBPM:1-6章测试代码详解》的内容能对你在jBPM的学习之旅中提供有价值的指导。
任务泳道与任务变量(Task Lane and Task Variables) - **任务泳道**:用于区分不同角色的任务,帮助可视化流程中的任务分配。 - **任务变量**:存储任务相关的数据,可以影响任务的处理和流程的流转。 #### 9. ...
6. **变量(Variables)**:在流程执行过程中,可以定义并操作变量,用于存储流程状态和数据。查看源码,你将了解如何设置和获取变量值。 7. **事件(Events)**:jbpm4支持多种类型的事件,如开始事件、结束事件、...
- **变量**(Variables):存储流程运行时的数据。 - **事件**(Events):响应特定情况的发生,如开始事件、结束事件等。 - **规则引擎**:jBPM集成了Drools,用于执行基于规则的逻辑。 通过这个视频系列,学习者...
原因是,只在sample.bpmn的 Variables中加入变量money是不够的,还要在ProcessMain中加入上面一段才行。 试了一下,如果只在ProcessMain中加入上面一段,但在sample.bpmn中不定义,也是会抛错的。 现在jbpm5的资料...
- **变量(Variables)**:存储与流程实例相关的数据,用于在整个流程中传递信息。 - **事件(Events)**:用于响应特定条件或情况,如开始事件、结束事件、信号事件等。 - **节点(Nodes)**:流程图中的每一个...
4. **变量(Variables)**:存储在流程实例中的数据,用于传递和存储流程执行中的信息。 5. **事件(Events)**:流程中的特殊节点,用于处理特定条件或状态的改变,如开始事件、结束事件和异常事件。 6. **服务...
3. **变量表(Variables)** - `JBPM_VARIABLEINSTANCE`: 存储流程实例中的变量信息,包括变量ID、变量值和关联的流程实例ID。变量可以是流程执行过程中的任意数据。 4. **节点表(Nodes)** - `JBPM_NODE...
- **Variables**:流程实例中的变量存储在`jbpm_variable`表中,用于保存流程运行时的动态数据。 - **Event Logs**:jbpm记录流程执行过程中的事件,如节点的进入和离开,这有助于跟踪和审计。这些事件存储在`jbpm_...
- **上下文变量 (Variables)**:流程执行过程中会涉及到各种变量的设置和获取。JBPM提供了`setVariable`和`getVariable`方法来管理这些变量。 - **信号触发 (Signal)**:当达到流程定义中的某个节点时,可以通过发送...
- **变量(Variables)**:存储流程实例中的数据,可以是输入、输出或内部状态。 **3. 开发手册的重要性** 《JBoss_jBPM_jPDL用户开发手册_3.2.3.pdf》作为开发者的重要参考资料,详细介绍了如何使用jBPM和jPDL...
- **上下文变量**:在流程执行过程中,如何管理和使用变量。 - **应用场景**:传递数据、记录状态等。 #### 3.4 Task assignment example - **任务分配**:展示如何在流程中自动或手动地分配任务给参与者。 - **...
- **实体(Entities)**: 包括流程实例(Process Instance)、任务(Task)和变量(Variables),它们构成了流程运行的基础元素。 - **执行服务(Execution Service)**: 提供了启动、终止流程实例,以及查询、控制...
#### 七、Variables变量 - **概念**: 介绍了jPDL中变量的基本概念。 - **作用域**: 解释了变量的作用域及其管理方法。 - **类型**: 列举了不同类型的变量及其用途。 - **持久化**: 介绍了如何更新持久化的流程变量...
以上介绍了JBPM框架中`ProcessEngine`提供的核心服务之一——`RepositoryService`和`ExecutionService`的主要功能及其使用方法。通过这两个服务接口,开发者能够有效地管理流程定义的生命周期,并控制流程实例的执行...
9. **流程变量(Process Variables)**:在会签过程中,可能需要共享某些信息,流程变量就是存储这类信息的地方,它们可以在整个流程实例中被访问和修改。 10. **扩展与定制**:jbpm提供了丰富的API和插件机制,...