Activiti工作流引擎的使用

前些天发现了一个巨牛的人工智能学习网站,通俗易懂,风趣幽默,忍不住分享一下给大家。点击跳转到教程。

Activiti工作流引擎使用

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

对于工作流引擎的解释请参考百度百科:工作流引擎

1.1 我与工作流引擎

在第一家公司工作的时候主要任务就是开发OA系统,当然基本都是有工作流的支持,不过当时使用的工作流引擎是公司一些牛人开发的(据说是用一个开源的引擎修改的),名称叫CoreFlow;功能相对Activiti来说比较弱,但是能满足日常的使用,当然也有不少的问题所以后来我们只能修改引擎的代码打补丁。

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

1.2 Activiti与JBPM5?

对于Activiti、jBPM4、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的乱码问题在流程图中。

流程图的乱码如下图所示:

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标签中定义extensionElementsactiviti:formProperty即可,到达这个节点的时候可以通过API读取表单元素。

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

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

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

2.2.2 自定义业务Form

这种方式应该是大家用的最多的了,因为一般的业务系统业务逻辑都会比较复杂,而且数据库中很多表都会有依赖关系,表单中有很多状态判断。

例如我们的系统适用jQuery UI作为UI,有很多javascript代码,页面的很多操作需要特殊处理(例如:多个选项的互斥、每个节点根据类型和操作人显示不同的按钮);基本每个公司都有一套自己的UI风格,要保持多个系统的操作习惯一致只能使用自定义表单才能满足。

2.3 业务和流程的关联方式

这个问题在群里面很多人都问过,这也是我刚刚开始迷惑的地方;

后来看了以下API发现RuntimeService有两个方法:

2.3.1 startProcessInstanceByKey

javadoc对其说明:

 

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查询:

 

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

 

议数据库冗余设计:在业务表设计的时候添加一列:PROCESS_INSTANCE_ID varchar2(64),在流程启动之后把流程ID更新到业务表中,这样不管从业务还是流程都可以查询到对方!

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

2.3.2 startProcessInstanceById

javadoc对其说明:

 

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的代码片段:

 

/*** 保存用户信息 并且同步用户信息到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);// 删除用户的membershipList<Group> activitiGroups = identityService.createGroupQuery().groupMember(userId).list();for (Group group : activitiGroups) {identityService.deleteMembership(userId, group.getId());}// 添加membershipfor (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);// 添加membershipfor (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中配置,例如:

     

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

     

?

4.使用单元测试

单元测试均使用Spring的AbstractTransactionalJUnit4SpringContextTests作为SuperClass,并且在测试类添加:

 

@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查询:

 

/*** 获取未签收的任务查询对象* @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查询:

 

/*** 获取正在处理的任务查询对象* @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查询:

 

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

 

?

5.4 已完成(HistoricProcessInstance)

已经结束的流程实例。

从表ACT_HI_PROCINST中查询数据。

 

/*** 获取已经完成的流程实例查询对象* @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为空)。

申请界面的截图:

Activiti工作流引擎使用

6.2 流程状态

Activiti工作流引擎使用

6.3 流程跟踪

图片方式显示当前节点:

Activiti工作流引擎使用

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

Activiti工作流引擎使用

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://www.mzph.cn/news/451284.shtml

如若内容造成侵权/违法违规/事实不符,请联系多彩编程网进行投诉反馈email:809451989@qq.com,一经查实,立即删除!

相关文章

Flurry调查报告:图片和视频应用增长速度最快

据外国媒体报道&#xff0c;移动数据分析公司Flurry近期对应用分类的欢迎度进行研究后发现&#xff0c;就用户使用的时间而言&#xff0c;“图片和视频”应用已成为增长最快的移动应用。 Flurry对各种应用分类的800多万移动用户进行了调查&#xff0c;并利用其分析工具跟踪了1…

JS内存管理与垃圾回收

javascript的内存管理Javascript 是那些被称作垃圾回收语言当中的一员。垃圾回收语言通过周期性地检查那些之前被分配出去的内存是否可以从应用的其他部分访问来帮助开发者管理内存。换句话说&#xff0c;当计算机发现有的内存已经不能被访问到了&#xff0c;就会把它们标记为垃…

牛客网分糖果

题解&#xff1a; 考试的时候没有想出来。。。 刚开始想了个比较错误的dp 后来想到了容斥。。 但是没有想到怎么去维护这个东西。。 按照一般的套路 至少有一个相邻相等的-至少有两个相邻相等的 但是这道题里这样并不好维护 我们考虑用dp来算这个东西 f[i]f[j]*min(a[j].....a[…

HTTP 503 错误 – 服务不可用 (Service unavailable)

介绍因暂时超载或临时维护&#xff0c;您的 Web 服务器目前无法处理 HTTP 请求。 其含义是&#xff0c; 这是一个暂时情况&#xff0c;会有一些延误&#xff0c; 过 后将会得到缓解。 有些服务器在这种情况下也许干脆拒绝套接字&#xff08;socket&#xff09; 连接&#xff0c…

SHA 加密是什么( sha1 和 MD5 的区别 )

前些天发现了一个巨牛的人工智能学习网站&#xff0c;通俗易懂&#xff0c;风趣幽默&#xff0c;忍不住分享一下给大家。点击跳转到教程。 SHA 安全哈希算法&#xff08;Secure Hash Algorithm&#xff09;主要适用于数字签名标准&#xff08;Digital Signature Standard DSS…

10个管理工作时间的小技巧

导读&#xff1a;如何才能稳步追随社会的变迁&#xff0c;如何才能留住飞逝的时间。俗话说&#xff1a;“一寸光阴一寸金&#xff0c;寸金难买寸光阴。”珍惜现在的时光&#xff0c;将来才不会为年轻时挥霍的时间而感到悔恨。三位作者Joe Mathews&#xff0c;Don Debolt&#x…

12-思科防火墙:ASA会话超时

一、实验拓扑&#xff1a;二、实验要求&#xff1a;DCD&#xff1a;死亡检测时间&#xff0c;默认R2 Telnet上去保持时间为1个小时&#xff0c;超时就会被清除掉&#xff0c;这里要求变为4小时&#xff0c;每15s就会发送5个DCD检测包&#xff0c;如没回应就剔除掉&#xff0c;回…

orCAD使用Orcad Capture CIS按Room摆放

http://www.sig007.com/EDAguide/176.html 37 使用Orcad Capture CIS按Room摆放 &#xff08;1&#xff09;打开原理图某一工程页 &#xff08;2&#xff09;按Ctrl键依次选中需要建Room的元件&#xff0c;右击&#xff0c;选择Edit Properties 在Filter by 下拉菜单中选择Cad…

503错误的原因和解决方法

如果出现“Service Unavailable”的提示&#xff0c;刷新几下又可以访问。 出现这种情况是由于您的网站超过了iis限制造成的 由于2003的操作系统在提示IIS过多时并非像2000系统提示“链接人数过多”&#xff0c;而是提示"Service Unavailable",出现这种情况是由于网…

Java中十六进制转换 Integer.toHexString()

前些天发现了一个巨牛的人工智能学习网站&#xff0c;通俗易懂&#xff0c;风趣幽默&#xff0c;忍不住分享一下给大家。点击跳转到教程。 用例&#xff1a; Long.toHexString(number) 其中 number 是一个long类型参数。 描述&#xff1a; java.lang.Integer.toHexString(…

细数25个硅谷最热创业公司 寻找创业灵感

【CSDN编译报道】硅谷堪称高科技产业之乡&#xff0c;每当提起就能联想到影响全球产业的各大著名企业Mircosoft、Google、Adobe、Oracle、Yahoo、SAP、intel等。而硅谷也被誉为创业公司的天堂&#xff0c;多如繁星的初创公司Karma、99Dresses、Getaround、Omada Health、Social…

数据特征分析:2.对比分析

对比分析 两个相互联系的数&#xff08;指标&#xff09;进行比较&#xff08;绝对数比较、相对数比较&#xff09; 对比分析 对比分析 → 两个互相联系的指标进行比较 绝对数比较&#xff08;相减&#xff09; / 相对数比较&#xff08;相除&#xff09;结构分析、比例分析、…

Java基础-Java中的内存分配与回收机制

Java基础-Java中的内存分配与回收机制 作者&#xff1a;尹正杰 版权声明&#xff1a;原创作品&#xff0c;谢绝转载&#xff01;否则将追究法律责任。 一. 二.转载于:https://www.cnblogs.com/yinzhengjie/p/9279601.html

离散数学中关于自反与反自反的通俗解释

前些天发现了一个巨牛的人工智能学习网站&#xff0c;通俗易懂&#xff0c;风趣幽默&#xff0c;忍不住分享一下给大家。点击跳转到教程。 设R是A上的二元关系&#xff0c;二元关系自反&#xff1a;任取一个A中的元素x&#xff0c;如果都有<x,x>在R中&#xff0c;那么就…

[Educational Round 5][Codeforces 616F. Expensive Strings]

这题调得我心疲力竭...Educational Round 5就过一段时间再发了_(:з」∠)_ 先后找了三份AC代码对拍&#xff0c;结果有两份都会在某些数据上出点问题...这场的数据有点水啊_(:з」∠)_【然而卡掉本弱还是轻轻松松的】 题目链接&#xff1a;616F - Expensive Strings 题目大意&a…

Redis自增计数

INCR key 将 key 中储存的数字值增一。 如果 key 不存在&#xff0c;那么 key 的值会先被初始化为 0 &#xff0c;然后再执行 INCR 操作。 如果值包含错误的类型&#xff0c;或字符串类型的值不能表示为数字&#xff0c;那么返回一个错误。 本操作的值限制在 64 位(bit)有符号数…

android布局中使用include及需注意点

在android布局中&#xff0c;使用include&#xff0c;将另一个xml文件引入&#xff0c;可作为布局的一部分&#xff0c;但在使用include时&#xff0c;需注意以下问题&#xff1a;一、使用include引入如现有标题栏布局block_header.xml&#xff0c;代码如下&#xff1a;<Rel…

周鸿祎回顾IPO一周年:保持创业心态 看好无线

奇虎360董事长兼CEO周鸿祎 3月19日晚间消息&#xff0c;在奇虎360上市接近一周年之际&#xff0c;奇虎360董事长兼CEO周鸿祎与媒体及个人投资者进行沟通&#xff0c;他表示这一年压力比以前更大&#xff0c;因为在上市光环下依然需要保持创业心态&#xff0c;同时他强调无线和…

《Effective Java》 第二讲:对于所有对象都通用的方法

前些天发现了一个巨牛的人工智能学习网站&#xff0c;通俗易懂&#xff0c;风趣幽默&#xff0c;忍不住分享一下给大家。点击跳转到教程。 上接《Effective Java》 第一讲&#xff1a;创建和销毁对象 八、覆盖 equals 时请遵守通用约定 1. 自反性&#xff1a;对于任何非空的引…

linux删除文件操作

linux删除文件夹命令 在用Linux的时候&#xff0c;有时候要删除一个文件夹&#xff0c;往往会提示次此文件非空&#xff0c;没法删除&#xff0c;这个时候&#xff0c;必须使用rm -rf命令。 实例一&#xff1a; rm -rf /var/log/httpd/access 将会删除/var/log/httpd/access目录…