jBPM(十):webSale的"页面流"介绍
通过前面几篇博客,我们看到了jBPM自带例子webSale可以在Tomcat+Mysql的环境中运行了. 这也是我研究jBPM的第一步.
希望对jBPM有个目无全牛地了解/理解/掌握,这里有必要介绍下这个webSale例子, 毕竟它是通往"全牛"的引子,
同时也可以作为项目中调用jBPM的一个不错practice.
这里采用"页面流"
方式(也就是顺着页面的跳转)来展开对webSale的介绍,及其背后调用的jBPM的相关API.另由于这个webSale是用JSF来作显示的,对JSF不熟悉的看官可找些文档看下,以下的介绍中不会再做JSF方面的介绍.
第一步, 进入登录界面. 这时页面上以下拉菜单方式给出webSale支持的用户名, 这些用户名也正是流程中task的执行者. 那这些用户名是如何获得的? UserBean的getUsers方法里, 执行了这样调用:
new IdentitySession(JbpmContext.getCurrentJbpmContext().getSession()).getUsers(). // 注,为了行文方便,我这里更紧凑地改写了原代码, 以下同.
第二步, 选一个用户后, 点"Log In"按钮时, 对应的login方法是,
执行JbpmContext.getCurrentJbpmContext().setActorId(userName)设置actor.
跳转到home页面(对应着home.jsp文件).
在home页面中, webSale做了两件事: 显示当前登录用户负责的Tasklist, 显示已经发布的流程. 下面看这些数据库是怎么来的.
显示当前登录用户负责的Tasklist时,
背后执行了taskMgmtSession.findTaskInstances(currentUserName)语句,
这个返回一个装有TaskInstance的list,
再在页面上遍历list以
"taskInstance.taskMgmtInstance.taskMgmtDefinition.processDefinition.name/version"
方式取出流程定义中的name和version信息,
并给每一个taskInstance的Name加了一个执行链接调用homeBean中的selectTaskInstance方法.
显示已经发布的流程时, 背后执行graphSession.findLatestProcessDefinitions(),
在JSP页面里,
以processDefinition.taskMgmtDefinition.startTask.name方式获得流程的首任务名,并给些任务名加链
接去执行homeBean的startProcessInstance方法.
第三步, 在上一步返回的home页面中,
点任务名链接, 调用startProcessInstance方法来启动流程处理. 此方法中先执行"new
ProcessInstance(graphSession.loadProcessDefinition(processDefinitionId)).
getTaskMgmtInstance().createStartTaskInstance()"来启动流程,
再通过"jbpmContext.save(processInstance)"保存上面new出来的processInstance.
调用taskBean中的initialize(taskInstance)处理前面createStartTaskInstance方法返回的
taskInstance为下一页面的显示做准备. 跳转到task页面.
第四步, task页面中展现数据/流程定义图片.
先说这里简单的(调用简单,但背后的实现还是挺复杂的)图片展现: <jbpm:processimage task="${taskBean.taskInstanceId}"/>.
接着看数据显示, 其实这一块的工作都是在上面taskBean中的initialize(taskInstance)方法做好的.
那这个方法又做了些什么呢? 两件事:
显示跟当前taskInstance绑定的variable信息及当前taskInstance的transition(也就是针对当前
taskInstance都有什么样的控制).
variable信息这样得到:
taskInstance.getTask().getTaskController().getVariableAccesses(){variableAccess
| variableAccess .getMappedName ==> mappedName,
taskInstance.getVariable(getMappedName) => value, new
TaskFormParameter(variableAccess, value)}.
好像是用了类似于python/groovy/ruby那样的可执行的伪代码. 这些可执行的伪代码也打开了设计新编程语言的可能性.
当前taskInstance的transition又是这样得到: taskInstance.getAvailableTransitions.
第五步, 在上一步的基础上, 从本质上来看,填写必要信息后有两种操作:保存当前信息并不结束当前taskInstance,
保存当前信息并结束当前taskInstance使流程进入下一taskInstance.
这两个操作分别对应着两个方法save和saveAndClose-- 这个saveAndClose方法中有调用save方法.
先看save方法,它做了两件事: "taskFormParameter.isWritable &&
taskFormParameter.getValue ==>
taskInstance.setVariable(taskFormParameter.getLabel(),
taskFormParameter.getValue())" 更新taskInstance中相应的variable信息;
jbpmContext.save(taskInstance).
saveAndClose方法中三件事:
调用taskInstance.end结束当前taskInstance;
processInstance.getLoggingInstance().getLogs(TaskAssignLog.class){ |
getTaskNewActorId}显示下一taskInstance的负责人; jbpmContext.save(taskInstance).
至此, 我们采用第二步返回页面中的startProcessInstance走了一遍, 若采用selectTaskInstance的话,"页面流"
会直接跳到第四步中的task页面, 就不再另行介绍.
--------------------------------
快要写完本博客了, 有些感悟:
0, 为什么要整理这么个文字版的webSale描述呢? 一是为了把现在的记忆以文字形式保存下来,
以后查看时不必再去看webSale中JSP到JavaBean的跳转. 更重要的是为了后续博客的引用, 也即当要描述一个jBPM
API时不必再介绍它的应用场景,直接给出这里是第几步即可.
1, 上面这些描述用时序图来表达会简洁明了的多.
2, 体会到像Python那样的可执行伪代码的好处: 直接用Python这样的动态语言来"写"文档.