传智播客--JBPM的核心API使用总结(汤阳光)

我们从今天开始学习 OA 办公自动化项目了. 在学习这个项目之前,我们要先学习另一个门基础技术.就是 JBPM 的使用.JBPM 全称是Java
Business Process
Management。是一种基于J2EE的轻量级工作流管理系统，jBPM是公开源代码项目。我们将用两天的时间来学习它.为我们的 OA
项目做准备. JBPM 是各个软件公司使用的非常多,这对我们快速找到一份工作是有非常大的帮助的.

1.对jbpm
3.2.2包结构的介绍.

Config文件夹,放的是配置文件.

Db文件夹,是需要的数据库脚本.

Designer文件夹,是对Eclipse的一个设计器插件.

Doc文件夹,是文档.

Lib文件夹,jbpm需要的第三方类库.

Server文件夹,一个服务器,对刚开始学习时,测试很有帮助.

Src文件夹,源文件.

Jbpm- identity.jar/jbpm-jpdl.jar是最主要的jbpm实现包.

2.加上必要的jar包后,还要配
置好配置文件.

hibernate.cfg.xml.Jbpm的数据持久层是由 Hibernate 来实现的,所以我们可以利用 Hibernate 的
<property name="hbm2ddl.auto">update</property> 属性,来创建 JBPM
需要的表.成功初始化表后是32 张.这里的表我们不能修改.

jbpm.cfg.xml 这个文件打开后是空的.不能不添加.jbpm 会自动加载默认的配置文件.

log4j.perperties这个是可选的,不配置也可以,但没有日志信息.

这三个配置文件的名字不能更改.

3.编写
processdefinition.xml 这个文件的名字不能更改的.

processimage.jpg 这个文件是可选的.流程图片.如果没有这个文件就不会显示流程图片.

gpd.xml是流程图片的定位文件,也是可选的.

4.部署流程定义

这里有6个方法,三种方式.

ProcessDefinition pd = null;

1, xml 文件，指定的是资源的相对路径（相对于classpath）

pd =
ProcessDefinition.parseXmlResource("helloworld/processdefinition.xml");

// pd =
ProcessDefinition.parseXmlInputStream(inputStream);

// pd =
ProcessDefinition.parseXmlReader(reader);

2, zip 文件（流程定义文档），指定的是资源的相对路径（相对于classpath）

// pd =
ProcessDefinition.parseParResource("helloworld/helloworld.zip");

// pd =
ProcessDefinition.parseParZipInputStream(zipInputStream);

3, String

// pd =
ProcessDefinition.parseXmlString(xmlString);

JbpmConfiguration
jbpmConfiguration = JbpmConfiguration.getInstance("/jbpm.cfg.xml");

4. 创建Session，开始事务

JbpmContext jbpmContext =
jbpmConfiguration.createJbpmContext();

jbpmContext.deployProcessDefinition(pd);

总结:

这个是在部署流程定义失败的时候,进行回滚.这句话的功能不是直接进行回滚,而是做个回滚标记.在关闭的时候做回滚.

jbpmContext.setRollbackOnly();

千万要注意,打开的资源一定要记得关闭.不然系统因为这个出现问题,很难定位.

jbpmContext.close();
//
提交/回滚 事务，关闭Session

JbpmConfiguration
jbpmConfiguration = JbpmConfiguration.getInstance();
这个是单实例,多次调用,其
实就初始化一次,最好设成全局.一次声明,多次使用.

5.创建流程实例

ProcessDefinition pd =
jbpmContext.getGraphSession().findLatestProcessDefinition("helloworld");

ProcessInstance pi =
pd.createProcessInstance();

这里是不用手动保存的,jbpm会自动执行这个操作.

jbpmContext.save(pi);

创建一个流程实例

pi.getRootToken().signal();

关闭打开的资源.Java会自动回收没有引用的对象,但不会回收没有关闭的资源.

jbpmContext.close();

6.获取任务实例列表

1)创建Session，开始事务

JbpmContext jbpmContext =
jbpmConfiguration.createJbpmContext();

List<TaskInstance> list =
jbpmContext.getTaskList(actorId);

2)开始任务

TaskInstance ti =
jbpmContext.getTaskInstance(taskInstanceId);

ti.start();

3)结束任务

TaskInstance ti =
jbpmContext.getTaskInstance(taskInstanceId);

ti.end();

上面的API的操作,都是核心的代码.代码还不健壮.不能真正的使用到项目中去.

7.使用模板代码.把上面的
API 核心代码进行套用.

ProcessDefinition pd =
ProcessDefinition.parseXmlResource("helloworld/processdefinition.xml");

JbpmConfiguration
jbpmConfiguration = JbpmConfiguration.getInstance("/jbpm.cfg.xml");

JbpmContext jbpmContext =
jbpmConfiguration.createJbpmContext(); // 创建Session，开始事务

try {

....

} catch (RuntimeException
e) {

jbpmContext.setRollbackOnly();

throw e;

} finally {

jbpmContext.close();
// 提交/回滚 事务，关闭Session

}

感觉学习的内容很多,不过对API的掌握还有待提高.老师说了,对技术的把握不是会用那么简单.而是要用已经掌握的知识来合理的解决问题才是最主要的.