Activiti工做流引擎使用

Activiti工做流引擎使用

1.简单介工做流引擎与Activiti

对于工做流引擎的解释请参考百度百科：工做流引擎

1.1 我与工做流引擎

在第一家公司工做的时候主要任务就是开发OA系统，固然基本都 是有工做流的支持，不过当时使用的工做流引擎是公司一些牛人开发的（听说是用一个开源的引擎修改的），名称叫CoreFlow；功能相对Activiti 来讲比较弱，可是能知足平常的使用，固然也有很多的问题因此后来咱们只能修改引擎的代码打补丁。

如今是我工做的第二家公司，由于要开发ERP、OA等系统须要使用工做流，在项目调研阶段我先搜索资料选择使用哪一个开源工做流引擎，最终肯定了Activiti5并基于公司的架构作了一些DEMO。

1.2 Activiti与JBPM5？

对于Activiti、jBPM四、jBPM5咱们应该如何选择，在InfoQ上有一篇文章写的很好，从大的层面比较各个引擎之间的差别，请参考文章：纵观jBPM：从jBPM3到jBPM5以及Activiti5

1.3 Activiti资料

• 官网：http://www.activiti.org/

• 下载：http://www.activiti.org/download.html

• 版本：Activiti的版本是从5开始的，由于Activiti是使用jBPM4的源码；版本发布：两个月发布一次。

• Eclipse Plugin: http://activiti.org/designer/update/

• Activit中文群：5435716

2.初次使用遇到问题收集

由于Activiti刚刚退出不久因此资料比较空缺，中文资料更是少的可怜，因此开始的时候一头雾水（虽然以前用过工做流，可是感受差距不少），并且官方的手册还不是很全面；因此我把我在学习使用的过程遇到的一些疑问都罗列出来分享给你们；如下几点是我遇到和想到的，若是你还有什么疑问能够在评论中和我交流再补充。

2.1 部署流程图后中文乱码

乱码是一直缠绕着国人的问题，以前各个技术、工具出现乱码的问题写过不少文章，这里也不例外……，Activiti的乱码问题在流程图中。

流程图的乱码以下图所示：

解决办法有两种：

2.1.1 修改源代码方式

修改源码

org.activiti.engine.impl.bpmn.diagram.ProcessDiagramCanvas

在构造方法

public ProcessDiagramCanvas(int width, int height)

中有一行代码是设置字体的，默认是用 Arial 字体，这就是乱码产生的缘由，把字改成本地的中文字体便可，例如：

Font font = new Font("WenQuanYi Micro Hei", Font.BOLD, 11);

固然若是你有配置文件读取工具那么能够设置在*.properties文件中，我就是这么作的：

Font font = new Font(PropertyFileUtil.get("activiti.diagram.canvas.font"), Font.BOLD, 11);

2.1.2 使用压缩包方式部署

Activiti支持部署*.bpmn20.xml、bar、zip格式的流程定义。

使用Activit Deisigner工具设计流程图的时候会有三个类型的文件:

• .activiti设计工具使用的文件

• .bpmn20.xml设计工具自动根据.activiti文件生成的xml文件

• .png流程图图片

解决办法就是把xml文件和图片文件同时部署，由于在单独部署xml文件的时候Activiti会自动生成一张流程图的图片文件，可是这样在使用的时候坐标和图片对应不起来……

因此把xml和图片同时部署的时候Activiti自动关联xml和图片，当须要获取图片的时候直接返回部署时压缩包里面的图片文件，而不是Activiti自动生成的图片文件

2.1.2.1 使用工具打包Bar文件

右键项目名称而后点击“Create deployment artifacts”，会在src目录中建立deployment文件夹，里面包含*.bar文件.

2.1.2.2 使用Ant脚本打包Zip文件

这也是咱们采用的办法，你能够手动选择xml和png打包成zip格式的文件，也能够像咱们同样采用ant target的方式打包这两个文件。

<?xml version="1.0" encoding="UTF-8"?>
<project name="foo">

    <property name="workflow.definition" value="foo-common-core/src/main/resources/diagrams" />
    <property name="workflow.deployments" value="foo-common-core/src/main/resources/deployments" />

<target name="workflow.package.oa.leave">
		<echo>打包流程定义及流程图::OA-请假</echo>
		<zip destfile="${workflow.deployments}/oa/leave.zip" basedir="${workflow.definition}/oa/leave" update="true"
			includes="*.xml,*.png" />
	</target>
</project>

这样当修改流程定义文件后只要运行ant命令就能够打包了：

ant workflow.package.oa.leave

如今部署bar或者zip文件查看流程图图片就不是乱码了，而是你的压缩包里面的png文件。

2.2 使用引擎提供的Form仍是自定义业务Form

2.2.1 引擎提供的Form

定义表单的方式在每一个Task标签中定义extensionElements和activiti:formProperty便可，到达这个节点的时候能够经过API读取表单元素。

Activiti官方的例子使用的就是在流程定义中设置每个节点显示什么样的表单哪些字段须要显示、哪些字段只读、哪些字段必填。

可是这种方式仅仅适用于比较简单的流程，对于稍微复杂或者页面须要业务逻辑的判断的状况就不适用了。

对于数据的保存都是在引擎的表中，不利于和其余表的关联、对整个系统的规划也不利！

2.2.2 自定义业务Form

这种方式应该是你们用的最多的了，由于通常的业务系统业务逻辑都会比较复杂，并且数据库中不少表都会有依赖关系，表单中有不少状态判断。

例如咱们的系统适用jQuery UI做为UI，有不少javascript代码，页面的不少操做须要特殊处理（例如：多个选项的互斥、每一个节点根据类型和操做人显示不一样的按钮）；基本每 个公司都有一套本身的UI风格，要保持多个系统的操做习惯一致只能使用自定义表单才能知足。

2.3 业务和流程的关联方式

这个问题在群里面不少人都问过，这也是我刚刚开始迷惑的地方；

后来看了如下API发现RuntimeService有两个方法：

2.3.1 startProcessInstanceByKey

javadoc对其说明：

?

1 2	startProcessInstanceByKey(String processDefinitionKey, Map variabes)            Starts a new process instance in the latest version of the process definition with the given key

其中businessKey就是业务ID，例如要申请请假，那么先填写登记信息，而后（保存+启动流程），由于请假是单独设计的数据表，因此保存后获得实体ID就能够把它传给processInstanceBusinessKey方法启动流程。当须要根据businessKey查询流程的时候就能够经过API查询:

?

1	runtimeService.createProcessInstanceQuery().processInstanceBusinessKey(processInstanceBusinessKey, processDefinitionKey);

建议数据库冗余设计：在业务表设计的时候添加一列：PROCESS_INSTANCE_ID varchar2(64)，在流程启动以后把流程ID更新到业务表中，这样无论从业务仍是流程均可以查询到对方！

特别说明： 此方法启动时自动选择最新版本的流程定义。

2.3.2 startProcessInstanceById

javadoc对其说明：

?

1 2	startProcessInstanceById(String processDefinitionId, String businessKey, Map variables)            Starts a new process instance in the exactly specified version of the process definition with the given id.

processDefinitionId：这个参数的值能够经过repositoryService.createProcessDefinitionQuery()方法查询，对应数据库：ACT_RE_PROCDEF；每次部署一次流程定义就会添加一条数据，同名的版本号累加。

特别说明： 此能够指定不一样版本的流程定义，让用户多一层选择。

2.3.3 如何选择

建议使用startProcessInstanceByKey，特殊状况须要使用以往的版本选择使用startProcessInstanceById。

2.4 同步用户数据

这个问题也是比较多的人询问过，Activiti支持对任务分配到：指定人、指定组、二者组合，而这些人和组的信息都保存在ACT_ID..表中，有本身的用户和组(角色)管理让不少人不知所措了；缘由是由于每一个系统都会存在一个权限管理模块（维护：用户、部门、角色、受权），不知道该怎么和Activiti同步。

2.4.1 建议处理方式

Activiti有一个IdentityService接口，经过这个接口能够操控Activiti的ACT_ID_*表的数据，通常的作法是用业务系统的权限管理模块维护用户数据，当进行CRUD操做的时候在原有业务逻辑后面添加同步到Activiti的代码；例如添加一个用户时同步Activiti User的代码片断：

?

1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49

/**   * 保存用户信息 而且同步用户信息到activiti的identity.User，同时设置角色   * @param user   * @param roleIds   */ public void saveUser(User user, List<Long> roleIds, boolean synToActiviti) {      accountManager.saveEntity(user);      String userId = user.getId().toString();        if (synToActiviti) {          List<org.activiti.engine.identity.User> activitiUsers = identityService.createUserQuery().userId(userId).list();          if (activitiUsers.size() == 1 ) {              //更新信息              org.activiti.engine.identity.User activitiUser = activitiUsers.get( 0 );              activitiUser.setFirstName(user.getName());              activitiUser.setLastName( "" );              activitiUser.setPassword(user.getPassword());              activitiUser.setEmail(user.getEmail());              identityService.saveUser(activitiUser);                // 删除用户的membership              List<Group> activitiGroups = identityService.createGroupQuery().groupMember(userId).list();              for (Group group : activitiGroups) {                  identityService.deleteMembership(userId, group.getId());              }                // 添加membership              for (Long roleId : roleIds) {                  Role role = roleManager.getEntity(roleId);                  identityService.createMembership(userId, role.getEnName());              }            } else {              org.activiti.engine.identity.User newUser = identityService.newUser(userId);              newUser.setFirstName(user.getName());              newUser.setLastName( "" );              newUser.setPassword(user.getPassword());              newUser.setEmail(user.getEmail());              identityService.saveUser(newUser);                // 添加membership              for (Long roleId : roleIds) {                  Role role = roleManager.getEntity(roleId);                  identityService.createMembership(userId, role.getEnName());              }          }      }   }

删除操做也和这个相似！

无论从业务系统维护用户仍是从Activiti维护，确定要肯定一方，而后CRUD的时候同步到对方，若是须要同步多个子系统那么能够再调用WebService实现。

2.5 流程图设计工具用什么

Activiti提供了两个流程设计工具，可是面向对象不一样。

• Activiti Modeler，面向业务人员，使用开源的BPMN设计工具Signavio，使用BPMN描述业务流程图

• Eclipse Designer，面向开发人员，Eclipse的插件，可让开发人员定制每一个节点的属性（ID、Name、Listener、Attr等）

2.5.1 咱们的方式

可能你会惊讶，由于咱们没有使用Activiti Modeler，咱们认为用Viso已经能表达流程图的意思了，并且项目经理也是技术出身，和开发人员也容易沟通。

目前这个项目是第一个使用Activiti的，开始咱们在需求调研阶段使用Viso设计流程图，利用泳道流程图设计和客户沟通，肯定后由负责流程的开发人员用Eclipse Designer设计获得bpmn20.xml，最后部署。

2.6 Eclipse Designer存在的问题

这个插件有一个很讨厌的Bug一直未修复，安装了插件后Eclipse的复制和粘帖快捷键会被更换为(Ctrl+Insert、Shift+Insert)；Bug描述请见：

• Activit Forums中报告的Bug

• Jira的登记

因此最后咱们只能单独开一个安装了Eclipse Designer的Eclipse专门用来设计流程图，这样就不影响正常使用Eclipse JAVAEE了。

3.配置

3.1 集成Spring

对于和Spring的集成Activiti作的不错，简单配置一些Bean代理便可实现，可是有两个和事务相关的地方要提示：

• 配置processEngineConfiguration的时候属性transactionManager要使用和业务功能的同一个事务管理Bean，不然事务不一样步。

• 对于实现了org.activiti.engine.delegate包中的接口的类须要被事务控制的实现类须要被Spring代理，而且添加事务的Annotation或者在xml中配置，例如:

  ?

  1 2 3 4 5 6 7 8 9 10

  /**   * 建立缴费流程的时候自动建立实体   *   * @author HenryYan   */ @Service @Transactional publicclass CreatePaymentProcessListener implementsExecutionListener {     .... }

  
  

?

4.使用单元测试

单元测试均使用Spring的AbstractTransactionalJUnit4SpringContextTests做为SuperClass，而且在测试类添加：

?

1 2	@ContextConfiguration (locations = { "/applicationContext-test.xml" }) @RunWith (SpringJUnit4ClassRunner. class )

?

虽然Activiti也提供了测试的一些超类，可是感受很差用，因此本身封装了一些方法。

代码请转移：https://gist.github.com/2182847

4.1 验证流程图设计是否正确

代码请转移：https://gist.github.com/2182869

4.2 业务对象和流程关联测试

代码请转移：https://gist.github.com/2182973

5.各类状态的任务查询以及和业务对象关联

咱们目前分为4中状态：未签收、办理中、运行中、已完成。

查询到任务或者流程实例后要显示在页面，这个时候须要添加业务数据，最终结果就是业务和流程的并集，请参考6.2。

5.1 未签收(Task)

此类任务针对于把Task分配给一个角色时，例如部门领导，由于部门领导角色能够指定多我的因此须要先签收再办理，术语：抢占式

对应的API查询：

?

1 2 3 4 5 6 7 8 9 10

/**   * 获取未签收的任务查询对象   * @param userId    用户ID   */ @Transactional (readOnly = true ) publicTaskQuery createUnsignedTaskQuery(String userId) {      TaskQuery taskCandidateUserQuery = taskService.createTaskQuery().processDefinitionKey(getProcessDefKey())              .taskCandidateUser(userId);      returntaskCandidateUserQuery; }

?

5.2 办理中(Task)

此类任务数据类源有两种:

• 签收后的，5.1中签收后就应该为办理中状态

• 节点指定的是具体到一我的，而不是角色

对应的API查询：

?

1 2 3 4 5 6 7 8 9

/**   * 获取正在处理的任务查询对象   * @param userId    用户ID   */ @Transactional (readOnly = true ) publicTaskQuery createTodoTaskQuery(String userId) {      TaskQuery taskAssigneeQuery = taskService.createTaskQuery().processDefinitionKey(getProcessDefKey()).taskAssignee(userId);      returntaskAssigneeQuery; }

?

5.3 运行中(ProcessInstance)

说白了就是没有结束的流程，全部参与过的人都应该能够看到这个实例，可是Activiti的API没有能够经过用户查询的方法，这个只能本身用hack的方式处理了，我目前尚未处理。

从表ACT_RU_EXECUTION中查询数据。

对应的API查询：

?

1 2 3 4 5 6 7 8 9 10

/**   * 获取未经完成的流程实例查询对象   * @param userId    用户ID   */ @Transactional (readOnly = true ) publicProcessInstanceQuery createUnFinishedProcessInstanceQuery(String userId) {      ProcessInstanceQuery unfinishedQuery = runtimeService.createProcessInstanceQuery().processDefinitionKey(getProcessDefKey())              .active();      returnunfinishedQuery; }

?

5.4 已完成(HistoricProcessInstance)

已经结束的流程实例。

从表ACT_HI_PROCINST中查询数据。

?

1 2 3 4 5 6 7 8 9 10

/**   * 获取已经完成的流程实例查询对象   * @param userId    用户ID   */ @Transactional (readOnly = true ) publicHistoricProcessInstanceQuery createFinishedProcessInstanceQuery(String userId) {      HistoricProcessInstanceQuery finishedQuery = historyService.createHistoricProcessInstanceQuery()              .processDefinitionKey(getProcessDefKey()).finished();      returnfinishedQuery; }

?

5.5 查询时和业务关联

提示：以前在业务对象添加了PROCESS_INSTANCE_ID字段

思路：如今能够利用这个字段查询了，不论是Task仍是ProcessInstance均可以获得流程实例ID，能够根据流程实例ID查询实体而后把流程对象设置到实体的一个属性中由Action或者Controller输出到前台。

代码请参考：https://gist.github.com/2183557

6.UI及截图

结合实际业务描述一个业务从开始到结束的过程，对于迷惑的同窗看完豁然开朗了；这里使用请假做为例子。

6.1 单独一个列表负责申请

这样的好处是申请和流程办理分离开处理，列表显示未启动流程的请假记录（数据库PROCESS_INSTANCE_ID为空）。

申请界面的截图：

6.2 流程状态

6.3 流程跟踪

图片方式显示当前节点：

列表形式显示流程流转过程:

6.3.1 当前节点定位JS

Java代码请移步：https://gist.github.com/2183712

Javascript思路：先经过Ajax获取当前节点的坐标，在指定位置添加红色边框，而后加载图片。

代码移步：https://gist.github.com/2183804

7.开启Logger

1. 添加log4j的jar

2. 设置log4j.logger.java.sql=DEBUG

8.结束

以前就想写这篇文章，如今终于完成了，花费了几个小时，但愿能节省你几天的时间。

请读者仔细阅读Activiti的用户手册和Javadoc。

来自：http://blog.csdn.net/howareyoutodaysoft/article/details/8081003