Activiti框架简介
Activiti5是由Alfresco软件在2010年5月17日发布的业务流程管理(BPM)框架,它是覆盖了业务流程管理、工作流、服务协作等领域的一个开源的、灵活的、易扩展的可执行流程语言框架。Activiti基于Apache许可的开源BPM平台,创始人Tom Baeyens是JBoss JBPM的项目架构师,它的特色是提供了eclipse插件,开发人员可以通过插件直接绘画出业务流程图。
简单工作流的搭建与部署
idea安装actiBPM插件
方式一:File->Settings->Plugins->Browse repositories 搜索actiBPM双击或点Install安装
方法二: 访问 http://plugins.jetbrains.com/plugin/7429-actibpm 下载actiBPM插件
然后File->Settings->Plugins->Install plugins from disk 进行本地安装
注:eclipse插件下载: http://activiti.org/designer/update/
解决bpmn文件乱码问题
修改idea安装目录下lib文件夹下的"idea.exe.vmoptions"或"idea64.exe.vmoptions"文件,具体根据安装电脑系统定,在文件下追加 -Dfile.encoding=UTF-8,保存后重启idea
生成bpmn文件
新建maven项目,pom.xml加入相关约束
<dependencies>
<!--JUnit测试-->
<dependency>
<groupId>junit</groupId>
<artifactId>junit</artifactId>
<version>4.12</version>
</dependency>
<!--- Activiti依赖导入 -->
<dependency>
<groupId>org.activiti</groupId>
<artifactId>activiti-spring</artifactId>
<version>5.18.0</version>
</dependency>
<dependency>
<groupId>org.activiti</groupId>
<artifactId>activiti-engine</artifactId>
<version>5.18.0</version>
<exclusions>
<exclusion>
<artifactId>slf4j-api</artifactId>
<groupId>org.slf4j</groupId>
</exclusion>
<exclusion>
<artifactId>spring-beans</artifactId>
<groupId>org.springframework</groupId>
</exclusion>
<exclusion>
<artifactId>jackson-core-asl</artifactId>
<groupId>org.codehaus.jackson</groupId>
</exclusion>
<exclusion>
<artifactId>commons-lang3</artifactId>
<groupId>org.apache.commons</groupId>
</exclusion>
<exclusion>
<artifactId>commons-lang3</artifactId>
<groupId>org.apache.commons</groupId>
</exclusion>
</exclusions>
</dependency>
<!--MySQL 驱动包,如果是其他库的话需要换驱动包-->
<dependency>
<groupId>mysql</groupId>
<artifactId>mysql-connector-java</artifactId>
<version>5.1.35</version>
</dependency>
</dependencies>
在java的resource目录下,点击New,选择BpmnFile,创建bpmn文件
双击创建的文件,显示如下界面,并通过拖拽完成简单工作流程(连接线需要悬停在对应元素上通过拖拽中心点来产生.)
点击元素,在这里修改两个属性,Name和Assignee。
name:工作步骤名 Assignee:代理人,做工的人(这里写emp和manager)
部署及简单运行工作流, 创建activiti.cfg.xml配置文件
<beans xmlns="http://www.springframework.org/schema/beans"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xsi:schemaLocation="http://www.springframework.org/schema/beans http://www.springframework.org/schema/beans/spring-beans.xsd">
<bean id="processEngineConfiguration" class="org.activiti.engine.impl.cfg.StandaloneProcessEngineConfiguration">
<property name="jdbcUrl" value="jdbc:mysql://127.0.0.1:3306/activiti" />
<property name="jdbcDriver" value="com.mysql.jdbc.Driver" />
<property name="jdbcUsername" value="root" />
<property name="jdbcPassword" value="root" />
<property name="databaseSchemaUpdate" value="true" />
</bean>
</beans>
创建Activiti类,并测试
package com.zp;
import org.activiti.engine.*;
import org.activiti.engine.repository.DeploymentBuilder;
import org.activiti.engine.task.Task;
import org.junit.Test;
import java.util.List;
public class LeaveActivitiTest {
ProcessEngine processEngine = ProcessEngines.getDefaultProcessEngine();
@Test
public void test() {
//以下两种方式选择一种创建引擎方式:1.配置写在程序里 2.读对应的配置文件 二选一即可,数据库生成表
testCreateProcessEngine();//1
testCreateProcessEngineByCfgXml(); //2
deployProcess();
startProcess();
queryTask();
//根据上一步生成的taskId执行任务执行下面方法,否则报错
//handleTask();
}
//测试activiti环境
@Test
public void testCreateProcessEngine() {
ProcessEngineConfiguration cfg = ProcessEngineConfiguration.createStandaloneProcessEngineConfiguration();
cfg.setJdbcDriver("com.mysql.jdbc.Driver");
cfg.setJdbcUrl("jdbc:mysql://127.0.0.1:3306/activiti");
cfg.setJdbcUsername("root");
cfg.setJdbcPassword("root");
//配置建表策略
cfg.setDatabaseSchemaUpdate(ProcessEngineConfiguration.DB_SCHEMA_UPDATE_TRUE);
ProcessEngine engine = cfg.buildProcessEngine();
}
// 根据配置文件activiti.cfg.xml创建ProcessEngine
@Test
public void testCreateProcessEngineByCfgXml() {
ProcessEngineConfiguration cfg = ProcessEngineConfiguration.createProcessEngineConfigurationFromResource("activiti.cfg.xml");
ProcessEngine engine = cfg.buildProcessEngine();
}
//发布流程
@Test
public void deployProcess() {
RepositoryService repositoryService = processEngine.getRepositoryService();
DeploymentBuilder builder = repositoryService.createDeployment();
builder.addClasspathResource("mybpmn.bpmn");
builder.deploy();
}
//启动流程
@Test
public void startProcess() {
RuntimeService runtimeService = processEngine.getRuntimeService();
//可根据id、key、message启动流程
runtimeService.startProcessInstanceByKey("myProcess_1");
}
//查看任务
@Test
public void queryTask() {
TaskService taskService = processEngine.getTaskService();
//根据assignee(代理人)查询任务
String assignee = "emp";
List<Task> tasks = taskService.createTaskQuery().taskAssignee(assignee).list();
int size = tasks.size();
for (int i = 0; i < size; i++) {
Task task = tasks.get(i);
}
for (Task task : tasks) {
System.out.println("taskId:" + task.getId() +
",taskName:" + task.getName() +
",assignee:" + task.getAssignee() +
",createTime:" + task.getCreateTime());
}
}
//办理任务
@Test
public void handleTask() {
TaskService taskService = processEngine.getTaskService();
//根据上一步生成的taskId执行任务
String taskId = "10008";
taskService.complete(taskId);
}
}
Activiti的api详解
ProcessEngine processEngine = ProcessEngines.getDefaultProcessEngine();
(1) RepositoryService
是Activiti的仓库服务类。所谓的仓库指流程定义文档的两个文件:bpmn文件和流程图片。
//产出方式 //流程定义和部署对象相关的service
RepositoryService repositoryService = processEngine.getRepositoryService()
// 可以产生DeploymentBuilder,用来定义流程部署的相关参数
DeploymentBuilder builder = repositoryService.createDeployment();
//删除流程定义
repositoryService.deleteDeployment("deploymentId");
(2) RuntimeService 流程服务类
RuntimeService runtimeService = processEngine.getRuntimeService();
//启动流程实例
runtimeService.startProcessInstanceByKey("流程key值");
// 查看流程是否结束
ProcessInstance processInstance = runtimeService//正在执行的流程
.createProcessInstanceQuery()//创建流程实例查询对象
.processInstanceId("流程实例ID")
.singleResult();
//如果为空,流程已结束
if(processInstance==null){
System.out.println("流程已结束");
}else{
System.out.println("流程未结束");
}
(3) TaskService 任务服务类
TaskService taskService = processEngine.getTaskService();
// 查询任务
List<Task> list = taskService//与正在执行任务相关的service
.createTaskQuery()//创建任务查询对象
.taskAssignee("当前处理人")
.list();
// 完成任务
taskService.complete("108");
(4) HistoryService 关于历史数据查询
HistoryService historyService= processEngine.getHistoryService();
// 查询历史流程实例
String processInstanceId = "2101";
HistoricProcessInstance hpi = historyService//与历史数据(历史表)相关的Service
.createHistoricProcessInstanceQuery()//创建历史流程实例查询
.processInstanceId(processInstanceId)//使用流程实例ID查询
.orderByProcessInstanceStartTime().asc()
.singleResult();
// 查询历史活动
List<HistoricActivityInstance> list = phistoryService//
.createHistoricActivityInstanceQuery()//创建历史活动实例的查询
.processInstanceId(processInstanceId)//
.orderByHistoricActivityInstanceStartTime().asc()//
.list();
//查询历史任务
List<HistoricTaskInstance> list = phistoryService//与历史数据(历史表)相关的Service
.createHistoricTaskInstanceQuery()//创建历史任务实例查询
.processInstanceId(processInstanceId)//
.orderByHistoricTaskInstanceStartTime().asc()
.list();
// 查询历史流程变量
List<HistoricVariableInstance> list =phistoryService//
.createHistoricVariableInstanceQuery()//创建一个历史的流程变量查询对象
.processInstanceId(processInstanceId)//
.list();
(5) IdentityService 关于组织机构的查询
IdentityService identityService = processEngine.getIdentityService();//认证:保存组和用户信息
//就是组织管理系,这里面很少用Activiti,因为提供的字段太少,一般的项目中会自己维护一套组织机构的关系表。
identityService.saveGroup(new GroupEntity("部门经理"));//建立组
identityService.saveGroup(new GroupEntity("总经理"));//建立组
identityService.saveUser(new UserEntity(“小张”));//建立用户
identityService.saveUser(new UserEntity("小李")); //建立用户
identityService.saveUser(new UserEntity("小王")); //建立用户
identityService.createMembership("小张", "部门经理");//建立组和用户关系
identityService.createMembership("小李", "部门经理");//建立组和用户关系