工作流JBPM4.3中文版用户指南第七、八章(共八章)
2011-06-03 11:14
260 查看
第 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中。
7.1. 变量作用域
默认情况下,变量创建在顶级的流程实例作用域中。 这意味着它们对整个流程实例中的所有执行都是可见的,可访问的。 流程变量是动态创建的。意味着,当一个变量通过任何一个方法设置到流程中, 整个变量就会被创建了。每个执行都有一个变量作用域。声明在内嵌执行级别中的变量, 可以看到它自己的变量和声明在上级执行中的变量,这时按照正常的作用域规则。 使用execution接口中的
createVariable方法,
ActivityExecution和
EventListenerExecution可以创建流程的局部变量。
在未来的发布中,我们可能添加在jPDL流程语言中声明的变量。
7.2. 变量类型
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
为了持久化这些变量,变量的类型会按照这个列表中的例子进行检测。 第一个匹配的类型, 会决定变量如何保存。
7.3. 更新持久化流程变量
(jBPM 4.3中新添加的功能)在
customs,
event-handlers 和其他 用户代码中,你可以获取流程变量。当一个流程变量作为 持久化的对象被保存时,你可以直接更新反序列化的对象, 而不需要再次进行保存。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也会略过更新 那些数值没有发生变化的的反序列化对象。这些检测会查看 如果一个对象被修改了,基于计算再次序列化对象的字节数组, 和从数据库中原来读取的字节数组进行比较。
第 8 章 Scripting脚本
只有jUEL被配置成了脚本语言。 jUEL是通用表达式语言的一个实现。如果想获得 更多如何使用UEL的细节,可以参考 JEE 5教程,通用表达式语言一章。如果想配置其他脚本语言, 请参考开发者指南(尚未支持)。
相关文章推荐
- 工作流JBPM4.3中文版用户指南第二章(共八章)
- 工作流JBPM4.3中文版用户指南第一章(共八章)
- 工作流JBPM4.3中文版用户指南第三章(共八章)
- 工作流JBPM4.3中文版用户指南第四、五章(共八章)
- 工作流JBPM4.3中文版用户指南第六章(共八章)
- Gradle用户指南(中文版)
- Velocity 用户指南手册中文版(转)
- Tomcat 用户指南(中文版)
- Velocity 用户指南手册中文版(转)
- 【资料】Velocity 用户指南手册中文版
- IBM X系列服务器、刀片中心安装指南和用户手册、操作系统安装指南(中文版)汇总
- Oracle资料 - PL/SQL Developer 7.0 用户指南中文版 PDF格式
- bazaar用户指南(中文版)
- 《gradle 用户指南》中文版 第1章、简介
- Gradle用户指南(中文版)
- 《gradle 用户指南》中文版 第6章、Gradle包装器
- 《gradle 用户指南》中文版 第一部分、关于Gradle
- 《gradle 用户指南》中文版 目录
- Jakarta-Tomcat简明中文版用户指南(zz)
- OBE用户指南(中文版)