Activiti学习记录(二)
1.初始化数据库
使用工作流引擎创建23张表
public class TestActiviti { /** * 使用代码创建工作流需要的23张表 */ @Test public void createTable() { ProcessEngineConfiguration createStandaloneProcessEngineConfiguration = ProcessEngineConfiguration.createStandaloneProcessEngineConfiguration(); createStandaloneProcessEngineConfiguration.setJdbcDriver("com.mysql.jdbc.Driver"); createStandaloneProcessEngineConfiguration.setJdbcUrl("jdbc:mysql://localhost:3306/activiti0710?useUnicode=true&characterEncoding=utf8"); createStandaloneProcessEngineConfiguration.setJdbcUsername("root"); /** public static final String DB_SCHEMA_UPDATE_FALSE = "false"; 不能自动创建表，需要表存在 public static final String DB_SCHEMA_UPDATE_CREATE_DROP = "create-drop"; 表示先删除表，在创建表 public static final String DB_SCHEMA_UPDATE_TRUE = "true";如果表不存在，自动创建表 */ createStandaloneProcessEngineConfiguration.setDatabaseSchemaUpdate(createStandaloneProcessEngineConfiguration.DB_SCHEMA_UPDATE_TRUE); //工作流的核心对象 ProcessEngine buildProcessEngine = createStandaloneProcessEngineConfiguration.buildProcessEngine(); System.out.println(buildProcessEngine); } }
在Activiti中，在创建核心的流程引擎对象时会自动建表。如果程序正常执行，mysql会自动建库，然后创建23张表。
2.添加并制定配置文件
在Actiiti5中定制流程必定会操作到数据库，如果都像上面那样写一大段代码会非常麻烦，所以我们可以把数据库连接配置写入配置文件。
创建activiti.cfg.xml文件，配置
<beans xmlns="http://www.springframework.org/schema/beans" xmlns:context="http://www.springframework.org/schema/context" xmlns:tx="http://www.springframework.org/schema/tx" 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 http://www.springframework.org/schema/context http://www.springframework.org/schema/context/spring-context-2.5.xsd http://www.springframework.org/schema/tx http://www.springframework.org/schema/tx/spring-tx-3.0.xsd"> <!-- ProcessEngineConfiguration createStandaloneProcessEngineConfiguration = ProcessEngineConfiguration.createStandaloneProcessEngineConfiguration(); createStandaloneProcessEngineConfiguration.setJdbcDriver("com.mysql.jdbc.Driver"); createStandaloneProcessEngineConfiguration.setJdbcUrl("jdbc:mysql://localhost:3306/activiti0710?useUnicode=true&characterEncoding=utf8"); createStandaloneProcessEngineConfiguration.setJdbcUsername("root"); /** public static final String DB_SCHEMA_UPDATE_FALSE = "false"; 不能自动创建表，需要表存在 public static final String DB_SCHEMA_UPDATE_CREATE_DROP = "create-drop"; 表示先删除表，在创建表 public static final String DB_SCHEMA_UPDATE_TRUE = "true";如果表不存在，自动创建表 */ createStandaloneProcessEngineConfiguration.setDatabaseSchemaUpdate(createStandaloneProcessEngineConfiguration.DB_SCHEMA_UPDATE_TRUE); //工作流的核心对象 ProcessEngine buildProcessEngine = createStandaloneProcessEngineConfiguration.buildProcessEngine(); --> <bean id="processEngineConfiguration" class="org.activiti.engine.impl.cfg.StandaloneInMemProcessEngineConfiguration"> <!-- 连接数据库配置 --> <property name="jdbcDriver" value="com.mysql.jdbc.Driver"></property> <property name="jdbcUrl" value="jdbc:mysql://localhost:3306/activiti0710?useUnicode=true&characterEncoding=utf8"></property> <property name="jdbcUsername" value="root"></property> <!-- 没有表创建表 --> <property name="databaseSchemaUpdate" value="true"></property> </bean> </beans>
java代码:
/** * 使用配置文件创建工作流需要的23张表 */ @Test public void createTable_2() { ProcessEngineConfiguration createProcessEngineConfigurationFromResource = ProcessEngineConfiguration.createProcessEngineConfigurationFromResource("activiti.cfg.xml"); ProcessEngine buildProcessEngine = createProcessEngineConfigurationFromResource.buildProcessEngine(); System.out.println(buildProcessEngine); }
3. HelloWorld程序(模拟流程的执行)
先新建一个bpmn文件
编写junit测试类
public class helloWorld { ProcessEngine processEngine = ProcessEngines.getDefaultProcessEngine(); /** * 部署流程定义 */ @Test public void deployProcessDefinition() { Deployment deploy = processEngine.getRepositoryService()//与流程定义和部署对象相关的Service .createDeployment()//创建一个部署对象 .name("helloWorld入门程序")//添加部署的名称 .addClasspathResource("diagrams/HelloWorld.bpmn")//一次只能加载一个文件 .addClasspathResource("diagrams/HelloWorld.png") .deploy();//完成部署 System.out.println(deploy.getId()); System.out.println(deploy.getName()); } /** * 启动流程实例 */ @Test public void startProcessInstance() { //流程定义的key String processDefinitionKey = "helloWorld"; ProcessInstance startProcessInstanceByKey = processEngine.getRuntimeService()//与正在执行的流程实例和执行对象相关的Service .startProcessInstanceByKey(processDefinitionKey);//使用流程定义的key启动流程实例，key对应HelloWorld.bpmn中的id属性，使用key启动，默认是最新版本的流程定义启动 System.out.println("流程实例id" + startProcessInstanceByKey.getId());//流程实例id System.out.println("流程定义id" + startProcessInstanceByKey.getProcessDefinitionId());//流程定义id } /** * 查询当前人的个人任务 */ @Test public void findMyPersonTask() { String assignee = "王五"; List<Task> list = processEngine.getTaskService()//与正在执行的任务管理相关的service .createTaskQuery()//创建任务查询对象 .taskAssignee(assignee)//指定个人任务查询，指定办理人 .list(); if (list != null && list.size() > 0) { for (Task task : list) { System.out.println("任务ID:"+task.getId()); System.out.println("任务名称:"+task.getName()); System.out.println("任务创建时间:"+task.getCreateTime()); System.out.println("任务办理人:"+task.getAssignee()); System.out.println("流程实例ID:"+task.getProcessInstanceId()); System.out.println("执行对象ID:"+task.getExecutionId()); System.out.println("流程定义ID:"+task.getProcessDefinitionId()); } } } /** * 完成个人任务 */ @Test public void completMyPersonTask() { String taskId = "302"; processEngine.getTaskService()//与正在执行的任务管理相关的service .complete(taskId); System.out.println("完成任务：任务ID"+taskId); } }
4.部署流程定义（classpath路径加载文件）
说明：
1) 先获取流程引擎对象：在创建时会自动加载classpath下的activiti.cfg.xml
2) 首先获得默认的流程引擎，通过流程引擎获取了一个RepositoryService对象（仓库对象）
3) 由仓库的服务对象产生一个部署对象配置对象，用来封装部署操作的相关配置。
4) 这是一个链式编程，在部署配置对象中设置显示名，上传流程定义规则文件
5) 向数据库表中存放流程定义的规则信息。
6) 这一步在数据库中将操作三张表：
a) act_re_deployment（部署对象表）
存放流程定义的显示名和部署时间，每部署一次增加一条记录
b) act_re_procdef（流程定义表）
存放流程定义的属性信息，部署每个新的流程定义都会在这张表中增加一条记录。
注意：当流程定义的key相同的情况下，使用的是版本升级
c) act_ge_bytearray（资源文件表）
存储流程定义相关的部署信息。即流程定义文档的存放地。每部署一次就会增加两条记录，一条是关于bpmn规则文件的，一条是图片的（如果部署时只指定了bpmn一个文件，activiti会在部署时解析bpmn文件内容自动生成流程图）。两个文件不是很大，都是以二进制形式存储在数据库中。
/** * 部署流程定义(从classpath) */ @Test public void deployProcessDefinition_classpath() { Deployment deploy = processEngine.getRepositoryService()//与流程定义和部署对象相关的Service .createDeployment()//创建一个部署对象 .name("流程定义")//添加部署的名称 .addClasspathResource("diagrams/HelloWorld.bpmn")//一次只能加载一个文件 .addClasspathResource("diagrams/HelloWorld.png") .deploy();//完成部署 System.out.println(deploy.getId()); System.out.println(deploy.getName()); }
5. 部署流程定义（zip格式文件）
/** * 部署流程定义(从zip) */ @Test public void deployProcessDefinition_zip() { InputStream in = this.getClass().getClassLoader().getResourceAsStream("diagrams/HelloWorld.zip"); ZipInputStream zipInputStream = new ZipInputStream(in); Deployment deploy = processEngine.getRepositoryService()//与流程定义和部署对象相关的Service .createDeployment()//创建一个部署对象 .name("流程定义")//添加部署的名称 .addZipInputStream(zipInputStream)//一次只能加载一个文件 .deploy();//完成部署 System.out.println(deploy.getId()); System.out.println(deploy.getName()); }
6. 查看流程定义
查询流程定义的信息
/** * 查询流程定义 */ @Test public void findProcessDefinition() { List<ProcessDefinition> list = processEngine.getRepositoryService()//与流程定义和部署对象相关的Service .createProcessDefinitionQuery()//创建流程定义查询 // .deploymentId(deploymentId) //使用部署对象ID查询 // .processDefinitionKey(processDefinitionKey) //使用流程定义的key查询 // .processDefinitionId(processDefinitionId) //使用流程定义的id查询 // .processDefinitionKeyLike(processDefinitionKeyLike) //使用流程定义的id模糊查询 // .processDefinitionNameLike(processDefinitionNameLike) //使用流程定义的name模糊查询 /** 排序 **/ .orderByProcessDefinitionVersion().asc() //按照版本升序排列 // .orderByProcessDefinitionName().desc() // 按照流程定义的名称降序排序 .list(); //返回一个集合列表，封装流程定义 // .singleResult() //返回唯一结果集 // .listPage(firstResult, maxResults) //分页查询 // .count() //返回结果集数量 if (list != null && list.size() > 0) { for (ProcessDefinition pd : list) { System.out.println("流程定义ID:"+ pd.getId());//流程定义的key+版本+随机生成数 System.out.println("流程定义的名称:"+pd.getName());//对应helloworld.bpmn文件中的name属性值 System.out.println("流程定义的key:"+pd.getKey());//对应helloworld.bpmn文件中的id属性值 System.out.println("流程定义的版本"+pd.getVersion());//当流程定义的key相同时，版本从1开始逐次升级 System.out.println("资源名称bpmn文件:"+pd.getResourceName()); System.out.println("资源名称png文件:"+pd.getDiagramResourceName()); System.out.println("部署对象ID:"+pd.getDeploymentId()); } } }
说明：
1) 流程定义和部署对象相关的Service都是RepositoryService。
2) 创建流程定义查询对象，可以在ProcessDefinitionQuery上设置查询的相关参数
3) 调用ProcessDefinitionQuery对象的list方法，执行查询，获得符合条件的流程定义列表
4) 由运行结果可以看出：
Key和Name的值为：bpmn文件process节点的id和name的属性值
5) key属性被用来区别不同的流程定义。
6) 带有特定key的流程定义第一次部署时，version为1。之后每次部署都会在当前最高版本号上加1
7) Id的值的生成规则为:{processDefinitionKey}:{processDefinitionVersion}:{generated-id}, 这里的generated-id是一个自动生成的唯一的数字
8) 重复部署一次，deploymentId的值以一定的形式变化
规则act_ge_property表生成
7.删除流程定义
删除部署到activiti中的流程定义。
/** * 删除流程定义 */ @Test public void delProcessDefinition() { //使用部署ID，完成删除 String deploymentId = "601"; /** * 不带级联删除 * 只能删除没有启动的流程，如果流程启动，就会抛出异常 */ /*processEngine.getRepositoryService() .deleteDeployment(deploymentId);*/ /** * 级联删除 * 不管流程是否启动，都能删除 */ processEngine.getRepositoryService() .deleteDeployment(deploymentId, true); System.out.println("删除成功!"); }
8. 获取流程定义文档的资源（查看流程图附件）
查询出流程定义文档。主要查的是图片，用于显示流程用。
/** * 查看流程图 * @throws IOException */ @Test public void viewPic() throws IOException { //将生成的图片放置到文件夹下 String deploymentId = "901"; //获取图片资源名称 List<String> list = processEngine.getRepositoryService() .getDeploymentResourceNames(deploymentId); String resourceName = ""; if (list != null && list.size() > 0) { for (String name : list) { if (name.indexOf(".png") >= 0) { resourceName = name; } } } //获取图片输入流 InputStream in = processEngine.getRepositoryService() .getResourceAsStream(deploymentId, resourceName); //将图片生成到D盘目录下 File file = new File("D:/"+resourceName); FileUtils.copyInputStreamToFile(in, file); }
说明：
1) deploymentId为流程部署ID
2) resourceName为act_ge_bytearray表中NAME_列的值
3) 使用repositoryService的getDeploymentResourceNames方法可以获取指定部署下得所有文件的名称
4) 使用repositoryService的getResourceAsStream方法传入部署ID和资源图片名称可以获取部署下指定名称文件的输入流
最后的有关IO流的操作，使用FileUtils工具的copyInputStreamToFile方法完成流程流程到文件的拷贝，将资源文件以流的形式输出到指定文件夹下
9.流程定义是无法修改的
控制修改：使用流程定义的key相同情况下，版本升级
10.附加功能：查询最新版本的流程定义
/** * 附加功能：查询最新版本的流程定义 */ @Test public void findLastVersionProcessDefinition() { List<ProcessDefinition> list = processEngine.getRepositoryService() .createProcessDefinitionQuery() .orderByProcessDefinitionVersion().desc()//使用流程定义的版本升序排列 .list(); /** * map集合的key:流程定义的key * map集合的value:流程定义的对象 * map集合的特点:当map集合key相同的情况下，后一次的值将替换前一次的值 */ Map<String, ProcessDefinition> map = new LinkedHashMap<>(); if (list != null && list.size() > 0) { for (ProcessDefinition pd : list) { map.put(pd.getKey(), pd); } } List<ProcessDefinition> pdList = new ArrayList<ProcessDefinition>(map.values()); if (pdList != null && pdList.size() > 0) { for (ProcessDefinition pd : pdList) { System.out.println("流程定义ID:"+ pd.getId());//流程定义的key+版本+随机生成数 System.out.println("流程定义的名称:"+pd.getName());//对应helloworld.bpmn文件中的name属性值 System.out.println("流程定义的key:"+pd.getKey());//对应helloworld.bpmn文件中的id属性值 System.out.println("流程定义的版本:"+pd.getVersion());//当流程定义的key相同时，版本从1开始逐次升级 System.out.println("资源名称bpmn文件:"+pd.getResourceName()); System.out.println("资源名称png文件:"+pd.getDiagramResourceName()); System.out.println("部署对象ID:"+pd.getDeploymentId()); } } }
11.附加功能：删除流程定义（删除key相同的所有不同版本的流程定义）
/** * 附加功能: 删除流程定义(删除key相同的所有流程版本不同的流程定义) */ @Test public void delProcessDefinitionByKey() { //流程定义的key String processDefinitionKey = "helloWorld"; //先使用流程定义的key查询流程定义，查询所有的版本 List<ProcessDefinition> list = processEngine.getRepositoryService() .createProcessDefinitionQuery() .processDefinitionKey(processDefinitionKey) .list(); if (list != null && list.size() > 0) { for (ProcessDefinition pd : list) { String deploymentId = pd.getDeploymentId(); processEngine.getRepositoryService().deleteDeployment(deploymentId, true); } } }
12.流程实例，任务和执行
Execution 执行对象
按流程定义的规则执行一次的过程.
对应的表：
act_ru_execution： 正在执行的信息
act_hi_procinst：已经执行完的历史流程实例信息
act_hi_actinst：存放历史所有完成的活动
ProcessInstance 流程实例
特指流程从开始到结束的那个最大的执行分支，一个执行的流程中，流程实例只有1个。
注意
（1）如果是单例流程，执行对象ID就是流程实例ID
（2）如果一个流程有分支和聚合，那么执行对象ID和流程实例ID就不相同
（3）一个流程中，流程实例只有1个，执行对象可以存在多个。
Task 任务
执行到某任务环节时生成的任务信息。
对应的表：
act_ru_task：正在执行的任务信息
act_hi_taskinst：已经执行完的历史任务信息
