Activiti工作流-入门

Activiti概述

工作流概念

工作流（Workflow），指“业务过程的部分或整体在计算机应用环境下的自动化”。是对工作流程及其各操作步骤之间业务规则的抽象、概括描述。 通俗的说，流程（过程）就是多个人在一起合作完成某件事情的步骤，把步骤编程计算机能理解的形式，就是工作流。 工作流是研究一个群体如何在计算机的帮助下实现协同工作的，其主要解决的问题是：为了实现某个业务目标，利用计算机在多个参与者（Actor）之间按某种预定规则自动传递文档、信息或者任务（Task）。

【不使用工作流技术：】 从头开始开发这个订购流程的业务逻辑，我们需要： - 每个活动点都需要开发交互页面和后台处理程序 - 每个活动的流转都需要硬性判断下一步活动节点及其操作人 - 每次操作都需要维护业务数据和流程的相关数据

使用好处： - 使用专门的流程数据系统，维护所有涉及流程流转的数据。 - 提供“流程设计”工具，帮助用户定义订货流程的模型，而且一般都提供了可视化的界面。 - 所有的流程都依靠流程引擎来处理，避免了需求更改与硬编码之间矛盾的产生。 - 工作流引擎还提供了众多的API，可以很方便的将工作流的管理和业务操作完美结合。

工作流技术的优势

降低开发风险 通过使用诸如活动、流转、状态、行为这样的术语，使得业务分析师和开发人员使用同一种语言交谈成为可能。优秀的流程设计建模工具，甚至能使开发人员不必将用户需求转化成详细设计文档。流程实现的集中统一 应对业务流程经常变化的情况，使用工作流技术的最大好处是使业务流程的实现代码，不再散落在各式各样的业务系统中。加速开发 开发者不用再关注流程的参与者、活动节点的衔接、流转控制……因为这些工作很多被工作流框架接管了。因而开发者开发起来更快、代码出错更少、系统更加容易维护。提升对迭代开发的支持 如果系统中业务流程部分被硬编码，就不容易更改，需求分析师就会花费很大的精力在开发前的业务分析中，并且希望一次成功。但可悲的是，在任何软件项目开发中，这都很少能实现。工作流管理系统使得业务流程很容易部署和重新编排，业务流程相关的应用开发可以以一种“迭代／渐进”的方式推进，也就是说工作流技术在某种程度上支持“需求分析不必一次完全成功”。

工作流的技术特点

工作流只管理流程，是不能完成业务操作的。换句话说，工作流是相对独立的、通用的，与业务管理无直接关系。 比如费用报销流程，工作流管理的是报销的流程（谁申请，谁审批），费用报销的业务（使用费用的原因，使用费用的时间，，） 工作流虽然与业务无直接关系，但是，在开发的时候，需要考虑和业务整合。

常见的工作流框架

Activiti、JBPM、OSWorkflow、ActiveBPEL、YAWL等。

Activiti的起源

Activiti是一套业务流程管理(BPM)框架，它覆盖了业务流管理、工作流、服务协助等领域，它是一个开源的（Apache许可2.0）、灵活的、易扩展的可执行流程语言框架。 Activiti是Alfresco软件在2010年5月17日宣布启动的一个开源项目，其创始人和首席架构师由业务流程管理BPM的专家 Tom Baeyens担任。Tom Baeyens是JBoss jBPM的项目架构师。 提示：Jbpm4版本之后，该作者才做的Activiti，所以，Activiti很像jbpm4，理念又有点像hibernate。但是，jbpm5与4版本的差距比较大。

它是一项新的基于Apache许可的开源BPM平台，从基础开始构建，提供支持新的BPMN 2.0标准。（直观的认识就是XML） Activiti提供了流程设计器，开发人员可以直接通过流程设计器直接画出业务流程图。 Activiti的持久层使用的Mybatis。（api将dao封装了，无需会mybatis）

Activiti环境搭建

One minute version（官方Demo演示）

第一步：用管理员进去定制流程。 第二步：部署和启动流程。 第三步：使用流程。

使用工作流系统需要三步： 1．画流程图（流程文档xml定义）—管理员 2．部署到工作流的系统中—管理员 3．启动流程，开始执行任务，直到任务结束。–用户

新建Maven项目

Maven坐标（工作流引擎activiti-engine，日志实现slf4j-log4j12，数据库驱动oracle，测试junit）：

<properties> <activiti.version>5.19.0.2</activiti.version> <slf4j.version>1.7.5</slf4j.version> <oracle.version>10.2.0.4.0</oracle.version> <c3p0.version>0.9.1.2</c3p0.version> <junit.version>4.11</junit.version> </properties> <dependencies> <dependency> <groupId>org.activiti</groupId> <artifactId>activiti-engine</artifactId> <version>${activiti.version}</version> </dependency> <dependency> <groupId>org.slf4j</groupId> <artifactId>slf4j-log4j12</artifactId> <version>${slf4j.version}</version> </dependency> <dependency> <groupId>com.oracle</groupId> <artifactId>ojdbc14</artifactId> <version>${oracle.version}</version> <scope>runtime</scope> </dependency> <dependency> <groupId>junit</groupId> <artifactId>junit</artifactId> <version>${junit.version}</version> <scope>test</scope> </dependency> </dependencies>

初始化Activiti数据库

新建一个测试类：

/** * Activiti测试类 */ @RunWith(SpringJUnit4ClassRunner.class) @ContextConfiguration(locations="classpath:applicationContext.xml") public class ActivitiTest { //创建表：通过创建工厂（流程引擎：用来生成其他的服务api来具体操作） @Test public void testCreateTable(){ //1.得到引擎的配置对象:单服务器使用 ProcessEngineConfiguration processEngineConfiguration = ProcessEngineConfiguration.createStandaloneProcessEngineConfiguration(); //2.在引擎配置对象上设置相应的数据库连接参数 processEngineConfiguration.setJdbcDriver("oracle.jdbc.driver.OracleDriver"); processEngineConfiguration.setJdbcUrl("jdbc:oracle:thin:@localhost:1521:xe"); processEngineConfiguration.setJdbcUsername("bos"); processEngineConfiguration.setJdbcPassword("bos"); //设置自动建表 //三种参数值： //false:只是检查表结构，但不创建也不更新。适合已经有表的时候用 //create-drop：启动的时候检查和创建表，引擎关闭的是的删除 //true:检查表结构，如果表存在，则创建，如果表结构不一致，则更新。---常用 processEngineConfiguration.setDatabaseSchemaUpdate(processEngineConfiguration.DB_SCHEMA_UPDATE_TRUE); //获取工作流引擎对象(单例) ProcessEngine processEngine = processEngineConfiguration.buildProcessEngine(); System.out.println("====="+processEngine); } }

Activiti的核心

ACT_RE_*: ‘RE’表示repository。 这个前缀的表包含了流程定义和流程静态资源 （图片，规则，等等）。ACT_RU_*: ‘RU’表示runtime。 这些运行时的表，包含流程实例，任务，变量，异步任务，等运行中的数据。 Activiti只在流程实例执行过程中保存这些数据， 在流程结束时就会删除这些记录。 这样运行时表可以一直很小速度很快。ACT_ID_*: ‘ID’表示identity。 这些表包含身份信息，比如用户，组等等。ACT_HI_*: ‘HI’表示history。 这些表包含历史数据，比如历史流程实例， 变量，任务等等。ACT_GE_*: ‘GE’表示general。通用数据， 用于不同场景下，如存放资源文件。ACT_EVT_LOG：事件日志

ProcessEngine：流程引擎接口，是最核心的API类，其他的API类都由他而来。它是其他API产生的基础！ProcessEngine对象，这是Activiti工作的核心。负责生成流程运行时的各种实例及数据、监控和管理流程的运行。

RepositoryService 流程定义管理 操作 ACT_RE_* 数据表 RuntimeService 流程实例管理 操作 ACT_RU_* 数据表 TaskService 任务管理 操作 ACT_RU_TASK 数据表IdentitiService 认证管理 操作 ACT_ID_* 数据表 HistoryService 历史记录管理 操作 ACT_HI_* 数据表 ManagementService 定时任务管理，创建job，ACT_RU_JOB 数据表FormService 表单管理，生成动态任务表单页面，某个字段存的数据

maven坐标

<dependency> <groupId>org.activiti</groupId> <artifactId>activiti-engine</artifactId> <version>${activiti.version}</version> </dependency> <dependency> <groupId>org.slf4j</groupId> <artifactId>slf4j-log4j12</artifactId> <version>${slf4j.version}</version> </dependency>

ApplicationContext.xml:

<!-- 流程引擎配置对象 --> <bean id="processEngineConfiguration" class="org.activiti.engine.impl.cfg.StandaloneProcessEngineConfiguration"> <!-- 注入数据源 --> <property name="dataSource" ref="dataSource"/> <!-- 自动建表 --> <property name="databaseSchemaUpdate" value="true"/> </bean> <!-- 流程引擎对象 --> <bean id="processEngine" factory-bean="processEngineConfiguration" factory-method="buildProcessEngine"/>

流程文档定义—画流程图

流程id（非常重要-将来程序里面叫key—流程定义的唯一标识），必须英文. 添加办理人：

Bpmn文件解读：

流程定义管理

核心API

关于工作流的api，有个规律：要获取某对象，都是createXxx； 如果是CreateXxx，获取的就是xxx对象，该对象主要用来增删改对应的表。 如果是CreateXxxQuery，获取的是xxxQuery对象，该对象主要用来查询的。

加载流程文档的时候，可以单独加载文档bpmn，工作流会自动生成一张图片存在数据库。 但也可以两个都加载，那么工作流就不会自动生成图片，而使用你上传的图片。

@RunWith(SpringJUnit4ClassRunner.class) @ContextConfiguration( locations="classpath:applicationContext.xml") public class ActivitiTest { //注入仓库Service @Autowired private RepositoryService repositoryService; //发布流程:只发布流程图，自动生成图片 @Test public void deployment1(){ Deployment deployment = repositoryService.createDeployment()//获取发布对象 .addClasspathResource("diagrams/Leave.bpmn")//添加流程文件 .name("请假流程1")//发布的名字 .deploy();//发布 System.out.println("发布的编号："+deployment.getId()); System.out.println("发布的名称："+deployment.getName()); System.out.println("发布的时间："+deployment.getDeploymentTime()); } //发布流程:发布流程图和图片--第一种方法 @Test public void deployment21(){ Deployment deployment = repositoryService.createDeployment()//获取发布对象 .addClasspathResource("diagrams/Leave.bpmn")//添加流程文件 .addClasspathResource("diagrams/Leave.png")//添加流程图片 .name("请假流程21")//发布的名字 .deploy();//发布 System.out.println("发布的编号："+deployment.getId()); System.out.println("发布的名称："+deployment.getName()); System.out.println("发布的时间："+deployment.getDeploymentTime()); } //发布流程:发布流程图和图片--第二种方法 @Test public void deployment22() throws FileNotFoundException{ Deployment deployment = repositoryService.createDeployment()//获取发布对象 .addZipInputStream(new ZipInputStream(this.getClass().getClassLoader().getResourceAsStream("diagrams/Leave.zip"))) .name("请假流程22")//发布的名字 .deploy();//发布 System.out.println("发布的编号："+deployment.getId()); System.out.println("发布的名称："+deployment.getName()); System.out.println("发布的时间："+deployment.getDeploymentTime()); } }

ApplicationContext.xml:

<!-- 流程控制的相关service --> <!-- 仓库对象 --> <bean id="repositoryService" factory-bean="processEngine" factory-method="getRepositoryService"></bean>

工作流服务端自动生成的图片的乱码问题解决方案: 解决方案1： 在流程引擎配置对象上面设置字体属性：

<!-- 发布流程生成图片是正常显示中文 --> <property name="activityFontName" value="宋体"/> <property name="labelFontName" value="宋体"/>

解决方案2： 流程图的图片在设计器中生成好，上传到服务器，不让服务器自动生成图片。

部署信息查询

//查询部署表对象数据 @Test public void queryDeployment(){ List<Deployment> list = repositoryService.createDeploymentQuery() //条件查询 .deploymentName("请假的流程部署") .deploymentId("1")//根据id .singleResult()//查询出一条结果 .orderByDeploymenTime()//排序 .listPage(firstResult, maxResults)//分页 .count()//统计 .list();

流程定义信息查询

@Test //查询流程定义的表的数据 public void queryProceeDefinition(){ List<ProcessDefinition> list = repositoryService.createProcessDefinitionQuery() // .processDefinitionKey(processDefinitionKey)//根据key来查询 .list();

流程图查看

//查询流程图 @Test public void findProcessDefinitionDiagram() throws IOException{ InputStream in = repositoryService.getProcessDiagram("LeaveProcess:1:4"); OutputStream out = new FileOutputStream("z:/Leave.png"); FileUtil.copyStream(in, out); }

流程定义的删除-流程销毁

//删除流程定义（通过部署id） @Test public void deleteProcessDefinition(){ repositoryService.deleteDeployment("1", true); }

级联和不级联。 场景：如果流程已经开启了，如果不使用级联，则会抛出异常！（原因：定义表有外键关联它），此时只能用级联。

流程实例管理

流程实例的启动

根据流程定义的id来启动：可以启动指定的流程定义。根据流程定义的key来启动：自动选择版本号最高（最新）的流程定义来启动根据消息的名字来启动 //启动流程实例 @Test public void startProcessInstance(){ ProcessInstance processInstance = runtimeService.startProcessInstanceByKey("LeaveProcess"); }

applicationContext.xml配置:

<!-- 运行时Service --> <bean id="runtimeService" factory-bean="processEngine" factory-method="getRuntimeService"/>

流程实例的查询

//查询流程实例 @Test public void queryProcessInstance(){ List<ProcessInstance> list = runtimeService.createProcessInstanceQuery() .list(); }

流程当前节点的坐标

//查询活动节点坐标 @Test public void queryActiveNodeZuobiao(){ List<String> activeActivityIds = runtimeService.getActiveActivityIds("10001"); for (String activeActivityId : activeActivityIds) { GraphicInfo graphicInfo1 = repositoryService.getBpmnModel("LeaveProcess:4:7504") .getGraphicInfo(activeActivityId);//某活动节点的坐标 } }

流程实例的删除（强行终止）

//流程实例的删除 @Test public void deleteProcessInstance(){ runtimeService.deleteProcessInstance("LeaveProcess:4:7504", "不想请假了"); } 删除流程定义：可以级联删除流程定义以及流程实例相关表数据。–管理员删除流程实例：只删除流程实例相关（运行时）表的数据，对流程定义没有影响。-流程启动者

任务管理

个人任务查询（待办任务查询）

//个人任务查询 @Test public void queryPersionTask(){ List<Task> list = taskService.createTaskQuery() .taskAssignee("张三") .list(); }

个人任务办理

//个人任务办理 @Test public void completePersonTask(){ taskService.complete("12504"); }

任务办理完成

当end节点之前的节点办理完成后，会自动完成end节点。当前流程实例都结束了。