Activiti工作流引擎使用详解(一)

一、IDEA安装activiti插件

在插件库中查找actiBPM,安装该插件,如果找不到该插件,请到插件库中下载该包手动安装,插件地址

http://plugins.jetbrains.com/plugin/7429-actibpm 安装后重启IDEA

二、activiti基础环境搭建

2.1 actiBPM插件使用示例

将需要用到的activiti包引入到工程中

<dependency>
    <groupId>org.activiti</groupId>
    <artifactId>activiti-engine</artifactId>
    <version>5.17.0</version>
</dependency>

resources目录下创建diagrams文件夹

右键new,点击BpmnFeil,然后取个名

鼠标左键拖拽StartEvent到界面上,同样再弄几个其他图标

 

 鼠标放到图标中心会变成黑白扇形,拖拽连线到另一个图标进行画图

 

 

生成png文件

右键点击hello.bpmn,选择Diagrams

点击箭头指的图标,选择生成位置即可

2.2 初始化activiti表结构

2.2.1 通过代码创建工作流使用的表

public class TestActiviti {
    /**
     * 使用代码创建工作流使用的23张表
     */
    @Test
    public void createTable(){
        //创建引擎配置类
        ProcessEngineConfiguration configuration = ProcessEngineConfiguration.createStandaloneProcessEngineConfiguration();
        configuration.setJdbcDriver("com.mysql.jdbc.Driver");
        configuration.setJdbcUrl("jdbc:mysql://192.168.27.14:3306/activiti");
        configuration.setJdbcUsername("root");
        configuration.setJdbcPassword("root");

        //不自动创建表,需要表存在 DB_SCHEMA_UPDATE_FALSE = "false";
        //先删除表,再创建表 DB_SCHEMA_UPDATE_CREATE_DROP = "create-drop";
        //如果表不存在,先创建表 DB_SCHEMA_UPDATE_TRUE = "true";
        configuration.setDatabaseSchemaUpdate(ProcessEngineConfiguration.DB_SCHEMA_UPDATE_TRUE);
        //创建工作流核心对象
        ProcessEngine processEngine = configuration.buildProcessEngine();
        System.out.println(processEngine);
    }
}

2.2.2 通过配置文件方式配置数据库等,resourses目录下添加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">

    <bean id="processEngineConfiguration" class="org.activiti.engine.impl.cfg.StandaloneProcessEngineConfiguration">
        <!-- 连接数据的配置 -->
        <property name="jdbcDriver" value="com.mysql.jdbc.Driver"/>
        <property name="jdbcUrl" value="jdbc:mysql://192.168.27.14:3306/activiti?characterEncoding=utf8"/>
        <property name="jdbcUsername" value="root"/>
        <property name="jdbcPassword" value="root"/>
        <!--  不自动创建表,需要表存在 "false";
              先删除表,再创建表  "create-drop";
              如果表不存在,先创建表"true";
        -->
        <property name="databaseSchemaUpdate" value="true"/>
    </bean>
</beans>
@Test
public void createTable2(){
    ProcessEngineConfiguration.createProcessEngineConfigurationFromResource("activiti.cfg.xml")
            .buildProcessEngine();
}

 2.2.3 那么,能不能再给力一点?前面看到了两种创建ProcessEngine(流程引擎)的方式,而这里要简化很多,调用ProcessEngines的getDefaultProceeEngine方法时会自动加载classpath下名为activiti.cfg.xml文件。

@Test
public void createTable3(){
    ProcessEngine processEngine = ProcessEngines.getDefaultProcessEngine();
}

三、activiti核心api讲解

3.1ProcessEngine

在Activiti中最核心的类,其他的类都是由他而来,由工作流引擎可以创建各个Service,这些Service是调用工作流23张表的服务

@Test
public void getService(){
    ProcessEngine processEngine = ProcessEngines.getDefaultProcessEngine();

    //管理流程定义
    RepositoryService repositoryService = processEngine.getRepositoryService();
    //执行管理,包括启动、推进、删除流程实例等
    RuntimeService runtimeService = processEngine.getRuntimeService();
    //任务管理
    TaskService taskService = processEngine.getTaskService();
    //历史管理(执行完的数据的管理
    HistoryService historyService = processEngine.getHistoryService();
    //组织机构管理
    IdentityService identityService = processEngine.getIdentityService();
    //可选服务,任务表单管理
    FormService formService = processEngine.getFormService();
    
    ManagementService managementService = processEngine.getManagementService();
}

3.2 RepositoryService

是Activiti的仓库服务类。所谓的仓库指流程定义文档的两个文件:bpmn文件和流程图片。

@Test
public void testRespositoryService(){
    ProcessEngine processEngine = ProcessEngines.getDefaultProcessEngine();
    RepositoryService repositoryService = processEngine.getRepositoryService();
    //可产生DeploymentBuilder用来定义流程部署的相关参数
    DeploymentBuilder deployment = repositoryService.createDeployment();
    //删除流程定义
    repositoryService.deleteDeployment("deploymentId");
}

3.3 RuntimeService

是activiti的流程执行服务类。可以从这个服务类中获取很多关于流程执行相关的信息。

3.4 TaskService

是activiti的任务服务类。可以从这个类中获取任务的信息。

3.5 HistoryService

是activiti的查询历史信息的类。在一个流程执行完成后,这个对象为我们提供查询历史信息。

3.6 ProcessDefinition

流程定义类。可以从这里获得资源文件等。

3.7 ProcessInstance

代表流程定义的执行实例。如小明请了一天的假,就必须发出一个流程实例的申请。一个流程实例包括了所有的运行节点。我们可以利用这个对象来了解当前流程实例的进度等信息。流程实例就表示一个流程从开始到结束的最大的流程分支,即一个流程中流程实例只有一个。

3.8 Execution

Activiti用这个对象去描述流程执行的每一个节点。在没有并发的情况下,Execution就是同ProcessInstance。流程按照流程定义的规则执行一次的过程,就可以表示执行对象Execution。

四、一个简单的HelloWorld程序示例

4.1 利用插件创建流程图

 

4.2 部署流程定义

/**
 * 部署流程定义
 */
@Test
public void deploymentProcessDefinition(){

    //获取流程定义与部署相关Service
    Deployment deployment = processEngine.getRepositoryService()
            .createDeployment()     //创建一个部署对象
            .name("helloworld入门程序")
            .addClasspathResource("diagrams/helloworld.bpmn")//加载资源文件
            .deploy();//完成部署
    System.out.println(deployment.getId());
    System.out.println(deployment.getName());
}

4.3 启动流程实例

/**
 * 启动流程实例
 */
@Test
public void startProcessInstance(){
    //获取与正在执行的流程示例和执行对象相关的Service
    ProcessInstance processInstance = processEngine.getRuntimeService()
            //使用流程定义的key启动实例,key对应bpmn文件中id的属性值,默认按照最新版本流程启动
            .startProcessInstanceByKey("helloworld");
    System.out.println(processInstance.getId());
    System.out.println(processInstance.getProcessDefinitionId());
}

4.4 查看我的个人任务

/**
 * 查询当前的个人任务
 */
@Test
public void findPersonalTask(){
    //与正在执行的任务相关的Service
    List<Task> list = processEngine.getTaskService()
            .createTaskQuery()  //创建查询任务对象
            .taskAssignee("王五")     //指定个人任务查询,指定办理人
            .list();
    if(list != null && list.size() > 0){
        for(Task task : list){
            System.out.println(task.getId());
            System.out.println(task.getName());
            System.out.println(task.getCreateTime());
            System.out.println(task.getAssignee());
            System.out.println(task.getProcessInstanceId());
            System.out.println(task.getExecutionId());
            System.out.println(task.getProcessDefinitionId());
        }
    }
}

4.5 完成我的个人任务

/**
 * 完成我的任务
 */
@Test
public void completePersonalTask(){
    processEngine.getTaskService()
            .complete("7502");
}

五、管理流程定义

5.1 部署流程定义

通过classpath部署流程定义

/**部署流程定义(从classpath)*/
@Test
public void deploymentProcessDefinition_classpath(){
    Deployment deployment = processEngine.getRepositoryService()//与流程定义和部署对象相关的Service
            .createDeployment()//创建一个部署对象
            .name("流程定义")//添加部署的名称
            .addClasspathResource("diagrams/helloworld.bpmn")//从classpath的资源中加载,一次只能加载一个文件
            .addClasspathResource("diagrams/helloworld.png")//从classpath的资源中加载,一次只能加载一个文件
            .deploy();//完成部署
    System.out.println("部署ID:"+deployment.getId());//
    System.out.println("部署名称:"+deployment.getName());//
}

通过zip文件部署流程定义

/**部署流程定义(从zip)*/
@Test
public void deploymentProcessDefinition_zip(){
    InputStream in = this.getClass().getClassLoader().getResourceAsStream("diagrams/helloworld.zip");
    ZipInputStream zipInputStream = new ZipInputStream(in);
    Deployment deployment = processEngine.getRepositoryService()//与流程定义和部署对象相关的Service
            .createDeployment()//创建一个部署对象
            .name("流程定义")//添加部署的名称
            .addZipInputStream(zipInputStream)//指定zip格式的文件完成部署
            .deploy();//完成部署
    System.out.println("部署ID:"+deployment.getId());//
    System.out.println("部署名称:"+deployment.getName());//
}

 这一步在数据库中将操作三张表:

a) act_re_deployment(部署对象表)

  存放流程定义的显示名和部署时间,每部署一次增加一条记录

b) act_re_procdef(流程定义表)

  存放流程定义的属性信息,部署每个新的流程定义都会在这张表中增加一条记录。

注意:当流程定义的key相同的情况下,使用的是版本升级

c) act_ge_bytearray(资源文件表)

  存储流程定义相关的部署信息。即流程定义文档的存放地。每部署一次就会增加两条记录,一条是关于bpmn规则文件的,一条是图片的(如果部署时只指定了bpmn一个文件,activiti会在部署时解析bpmn文件内容自动生成流程图)。两个文件不是很大,都是以二进制形式存储在数据库中。

5.2 查看流程定义

/**查询流程定义*/
@Test
public void findProcessDefinition(){
    List<ProcessDefinition> list = processEngine.getRepositoryService()//与流程定义和部署对象相关的Service
            .createProcessDefinitionQuery()//创建一个流程定义的查询
            /**指定查询条件,where条件*/
//                        .deploymentId(deploymentId)//使用部署对象ID查询
//                        .processDefinitionId(processDefinitionId)//使用流程定义ID查询
//                        .processDefinitionKey(processDefinitionKey)//使用流程定义的key查询
//                        .processDefinitionNameLike(processDefinitionNameLike)//使用流程定义的名称模糊查询

            /**排序*/
            .orderByProcessDefinitionVersion().asc()//按照版本的升序排列
//                        .orderByProcessDefinitionName().desc()//按照流程定义的名称降序排列

            /**返回的结果集*/
            .list();//返回一个集合列表,封装流程定义
//                        .singleResult();//返回惟一结果集
//                        .count();//返回结果集数量
//                        .listPage(firstResult, maxResults);//分页查询
    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());
            System.out.println("#########################################################");
        }
    }
}

结果:

再部署一次运行结果为:

  可以看到流程定义的key值相同的情况下,版本是从1开始逐次升级的,流程定义的Id是【key:版本:生成ID】。由运行结果可以看出:Key和Name的值为:bpmn文件process节点的id和name的属性值。key属性被用来区别不同的流程定义,带有特定key的流程定义第一次部署时,version为1。之后每次部署都会在当前最高版本号上加1,Id的值的生成规则为:{processDefinitionKey}:{processDefinitionVersion}:{generated-id}, 这里的generated-id是一个自动生成的唯一的数字,重复部署一次,deploymentId的值以一定的形式变化,规则act_ge_property表生成。

5.3 删除流程定义

/**删除流程定义*/
@Test
public void deleteProcessDefinition(){
    //使用部署ID,完成删除
    String deploymentId = "601";
    /**
     * 不带级联的删除
     *    只能删除没有启动的流程,如果流程启动,就会抛出异常
     */
//        processEngine.getRepositoryService()//
//                        .deleteDeployment(deploymentId);

    /**
     * 级联删除
     *       不管流程是否启动,都能可以删除
     */
    processEngine.getRepositoryService()//
            .deleteDeployment(deploymentId, true);
    System.out.println("删除成功!");
}

  如果该流程定义下没有正在运行的流程,则可以用普通删除。如果是有关联的信息,用级联删除。项目开发中使用级联删除的情况比较多,删除操作一般只开放给超级管理员使用。

5.4 获取流程定义文档的资源

 查询出流程定义文档。主要查的是图片,用于显示流程用。

/**查看流程图
 * @throws IOException */
@Test
public void viewPic() throws IOException {
    /**将生成图片放到文件夹下*/
    String deploymentId = "801";
    //获取图片资源名称
    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);
    //将输入流的图片写到D盘下
    FileUtils.copyInputStreamToFile(in, file);
}

  deploymentId为流程部署ID,resourceName为act_ge_bytearray表中NAME_列的值,使用repositoryService的getDeploymentResourceNames方法可以获取指定部署下得所有文件的名称,使用repositoryService的getResourceAsStream方法传入部署ID和资源图片名称可以获取部署下指定名称文件的输入流,最后的有关IO流的操作,使用FileUtils工具的copyInputStreamToFile方法完成流程流程到文件的拷贝,将资源文件以流的形式输出到指定文件夹下。

5.5 查询最新版本的流程定义

/***附加功能:查询最新版本的流程定义*/
@Test
public void findLastVersionProcessDefinition(){
    List<ProcessDefinition> list = processEngine.getRepositoryService()//
            .createProcessDefinitionQuery()//
            .orderByProcessDefinitionVersion().asc()//使用流程定义的版本升序排列
            .list();
    /**
     * Map<String,ProcessDefinition>
     map集合的key:流程定义的key
     map集合的value:流程定义的对象
     map集合的特点:当map集合key值相同的情况下,后一次的值将替换前一次的值
     */
    Map<String, ProcessDefinition> map = new LinkedHashMap<String, ProcessDefinition>();
    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());
            System.out.println("#########################################################");
        }
    }
}

5.6 删除流程定义

/**附加功能:删除流程定义(删除key相同的所有不同版本的流程定义)*/
@Test
public void deleteProcessDefinitionByKey(){
    //流程定义的key
    String processDefinitionKey = "helloworld";
    //先使用流程定义的key查询流程定义,查询出所有的版本
    List<ProcessDefinition> list = processEngine.getRepositoryService()//
            .createProcessDefinitionQuery()//
            .processDefinitionKey(processDefinitionKey)//使用流程定义的key查询
            .list();
    //遍历,获取每个流程定义的部署ID
    if(list!=null && list.size()>0){
        for(ProcessDefinition pd:list){
            //获取部署ID
            String deploymentId = pd.getDeploymentId();
            processEngine.getRepositoryService()//
                    .deleteDeployment(deploymentId, true);
        }
    }
}

 六、流程实例、任务的执行

涉及到的表

6.1 启动流程实例

    /**
     * 启动流程实例
     */
    @Test
    public void startProcessInstance(){
        //获取与正在执行的流程示例和执行对象相关的Service
        ProcessInstance processInstance = processEngine.getRuntimeService()
                //使用流程定义的key启动实例,key对应bpmn文件中id的属性值,默认按照最新版本流程启动
                .startProcessInstanceByKey("helloworld");
        System.out.println(processInstance.getId());
        System.out.println(processInstance.getProcessDefinitionId());
    }

  通过流程定义的key启动流程实例,这时打开数据库act_ru_execution表,ID_表示执行对象ID,PROC_INST_ID_表示流程实例ID,如果是单例流程(没有分支和聚合),那么流程实例ID和执行对象ID是相同的。

一个流程流程实例只有一个,执行对象可以存在多个。

 6.2 查询我的个人任务

/**查询当前人的个人任务*/
    @Test
    public void findMyPersonalTask(){
        String assignee = "张三";
        List<Task> list = processEngine.getTaskService()//与正在执行的任务管理相关的Service
                .createTaskQuery()//创建任务查询对象
                /**查询条件(where部分)*/
                .taskAssignee(assignee)//指定个人任务查询,指定办理人
//                        .taskCandidateUser(candidateUser)//组任务的办理人查询
//                        .processDefinitionId(processDefinitionId)//使用流程定义ID查询
//                        .processInstanceId(processInstanceId)//使用流程实例ID查询
//                        .executionId(executionId)//使用执行对象ID查询
                /**排序*/
                .orderByTaskCreateTime().asc()//使用创建时间的升序排列
                /**返回结果集*/
//                        .singleResult()//返回惟一结果集
//                        .count()//返回结果集的数量
//                        .listPage(firstResult, maxResults);//分页查询
                .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());
                System.out.println("########################################################");
            }
        }
    }

  因为是任务查询,所以从processEngine中应该得到TaskService,使用TaskService获取到任务查询对象TaskQuery,为查询对象添加查询过滤条件,使用taskAssignee指定任务的办理者(即查询指定用户的代办任务),同时可以添加分页排序等过滤条件,调用list方法执行查询,返回办理者为指定用户的任务列表,任务ID、名称、办理人、创建时间可以从act_ru_task表中查到。在这种情况下,ProcessInstance相当于Execution, 如果assignee属性为部门经理,结果为空。因为现在流程只到了”填写请假申请”阶段,后面的任务还没有执行,即在数据库中没有部门经理可以办理的任务,所以查询不到。 一个Task节点和Execution节点是1对1的情况,在task对象中使用Execution_来表示他们之间的关系任务ID在数据库表act_ru_task中对应“ID_”列。

  在activiti任务中,主要分为两大类查询任务(个人任务和组任务):

1.确切指定了办理者的任务,这个任务将成为指定者的私有任务,即个人任务。

2.无法指定具体的某一个人来办理的任务,可以把任务分配给几个人或者一到 多个小组,让这个范围内的用户可以选择性(如有空余时间时)来办理这类任务,即组任务。

 6.3 办理任务

    /**完成我的任务*/
    @Test
    public void completeMyPersonalTask(){
        //任务ID
        String taskId = "1202";
        processEngine.getTaskService()//与正在执行的任务管理相关的Service
                .complete(taskId);
        System.out.println("完成任务:任务ID:"+taskId);
    }

  是办理任务,所以从ProcessEngine得到的是TaskService。当执行完这段代码,再以员工的身份去执行查询的时候,会发现这个时候已经没有数据了,因为正在执行的任务中没有数据。对于执行完的任务,activiti将从act_ru_task表中删除该任务,下一个任务会被插入进来。以”部门经理”的身份进行查询,可以查到结果。因为流程执行到部门经理审批这个节点了。再执行办理任务代码,执行完以后以”部门经理”身份进行查询,没有结果。重复这个步骤直到流程执行完。

6.4 查询流程状态(判断流程是正在执行还是结束)

    /**查询流程状态(判断流程正在执行,还是结束)*/
    @Test
    public void isProcessEnd(){
        String processInstanceId = "1001";
        ProcessInstance pi = processEngine.getRuntimeService()//表示正在执行的流程实例和执行对象
                .createProcessInstanceQuery()//创建流程实例查询
                .processInstanceId(processInstanceId)//使用流程实例ID查询
                .singleResult();
        if(pi==null){
            System.out.println("流程已经结束");
        }
        else{
            System.out.println("流程没有结束");
        }
    }

       在流程执行的过程中,创建的流程实例ID在整个过程中都不会变,当流程结束后,流程实例将会在正在执行的执行对象表中(act_ru_execution)被删除。

  因为是查询流程实例,所以先获取runtimeService,创建流程实例查询对象,设置实例ID过滤参数,由于一个流程实例ID只对应一个实例,使用singleResult执行查询返回一个唯一的结果,如果结果数量大于1,则抛出异常,判断指定ID的实例是否存在,如果结果为空,则代表流程结束,实例在正在执行的执行对象表中已被删除,转换成历史数据。

6.5 查询历史任务

/**查询历史任务*/
@Test
public void findHistoryTask(){
    String taskAssignee = "张三";
    List<HistoricTaskInstance> list = processEngine.getHistoryService()//与历史数据(历史表)相关的Service
            .createHistoricTaskInstanceQuery()//创建历史任务实例查询
            .taskAssignee(taskAssignee)//指定历史任务的办理人
            .list();
    if(list!=null && list.size()>0){
        for(HistoricTaskInstance hti:list){
            System.out.println(hti.getId()+"    "+hti.getName()+"    "+hti.getProcessInstanceId()+"   "+hti.getStartTime()+"   "+hti.getEndTime()+"   "+hti.getDurationInMillis());
            System.out.println("################################");
        }
    }
}

6.6 查询历史流程实例

/**查询历史流程实例*/
@Test
public void findHistoryProcessInstance(){
    String processInstanceId = "1001";
    HistoricProcessInstance hpi = processEngine.getHistoryService()//与历史数据(历史表)相关的Service
            .createHistoricProcessInstanceQuery()//创建历史流程实例查询
            .processInstanceId(processInstanceId)//使用流程实例ID查询
            .singleResult();
    System.out.println(hpi.getId()+"    "+hpi.getProcessDefinitionId()+"    "+hpi.getStartTime()+"    "+hpi.getEndTime()+"     "+hpi.getDurationInMillis());
}

七、流程变量

流程变量涉及到的表

7.1模拟获取流程变量的场景

/**模拟设置和获取流程变量的场景 */
@Test
public void setAndGetVariables(){
    RuntimeService runtimeService = processEngine.getRuntimeService();
    TaskService taskService = processEngine.getTaskService();

    //使用执行对象ID设置
    runtimeService.setVariable(executionId, variableName, value);(设置一个)
    runtimeService.setVariables(executionId, variables);

    //使用任务ID设置
    taskService.setVariable(taskId, variableName, value);(设置一个)
    taskService.setVariables(taskId, variables);

    //启动流程实例的同时设置
    runtimeService.startProcessInstanceByKey(processDefinitionKey, variables);

    //完成任务的同时设置
    taskService.complete(taskId, variables);

    /**获取流程变量*/
    //使用执行对象ID和流程变量的名称,获取流程变量的值
    runtimeService.getVariable(executionId, variableName);
    //使用执行对象ID,获取所有的流程变量,将流程变量放置到Map集合中,map集合的key就是流程变量的名称,map集合的value就是流程变量的值
    runtimeService.getVariables(executionId);
    //使用执行对象ID,获取流程变量的值,通过设置流程变量的名称存放到集合中,获取指定流程变量名称的流程变量的值,值存放到Map集合中
    runtimeService.getVariables(executionId, variableNames);

    //使用任务ID和流程变量的名称,获取流程变量的值
    taskService.getVariable(taskId, variableName);
    //使用任务ID,获取所有的流程变量,将流程变量放置到Map集合中,map集合的key就是流程变量的名称,map集合的value就是流程变量的值
    taskService.getVariables(taskId);
    //使用任务ID,获取流程变量的值,通过设置流程变量的名称存放到集合中,获取指定流程变量名称的流程变量的值,值存放到Map集合中
    taskService.getVariables(taskId, variableNames);
}

7.2 设置流程变量

/**设置流程变量 */
@Test
public void setVariables(){
    TaskService taskService = processEngine.getTaskService();
    //任务ID
    String taskId = "50004";
    //一、设置流程变量,使用基本数据类型
    taskService.setVariableLocal(taskId,"请假天数",3);//local与当前task绑定,下一个task不可见
    taskService.setVariable(taskId,"请假日期",new Date());
    taskService.setVariable(taskId,"请假原因","回家探亲");
    //二:设置流程变量,使用javabean类型
    /**
     * 当一个javabean(实现序列号)放置到流程变量中,要求javabean的属性不能再发生变化
     *    * 如果发生变化,再获取的时候,抛出异常
     *
     * 解决方案:在Person对象中添加:
     *         private static final long serialVersionUID = 6757393795687480331L;
     *      同时实现Serializable 
     * */
    Person p = new Person();
    p.setId(20);
    p.setName("翠花");
    taskService.setVariable(taskId, "人员信息(添加固定版本)", p);

    System.out.println("流程变量设置成功");
}

流程变量支持的类型:

  从图中可以看出包括了大部分封装类型和Date、String和实现了Serializable接口的类的类型。流程变量的获取针对流程实例(即1个流程),每个流程实例获取的流程变量时不同的,使用基本类型获取流程变量,在taskService中使用任务ID,流程变量的名称,获取流程变量的值。Javabean类型设置获取流程变量,除了需要这个javabean实现了Serializable接口外,还要求流程变量对象的属性不能发生变化,否则抛出异常。解决方案,固定序列化ID。

setVariable和setVariableLocal的区别:

setVariable:设置流程变量的时候,流程变量名称相同的时候,后一次的值替换前一次的值,而且可以看到TASK_ID的字段不会存放任务ID的值

setVariableLocal:

1. 设置流程变量的时候,针对当前活动的节点设置流程变量,如果一个流程中存在2个活动节点,对每个活动节点都设置流程变量,即使流程变量的名称相同,后一次的版本的值也不会替换前一次版本的值,它会使用不同的任务ID作为标识,存放2个流程变量值,而且可以看到TASK_ID的字段会存放任务ID的值

例如act_hi_varinst 表的数据:不同的任务节点,即使流程变量名称相同,存放的值也是不同的。

如图:

2. 使用setVariableLocal说明流程变量绑定了当前的任务,当流程继续执行时,下个任务获取不到这个流程变量(因为正在执行的流程变量中没有这个数据),所有查询正在执行的任务时不能查询到我们需要的数据,此时需要查询历史的流程变量。

7.3 获取流程变量

/**获取流程变量 */
@Test
public void getVariables(){
    TaskService taskService = processEngine.getTaskService();
    //任务ID
    String taskId = "55002";
    /**一:获取流程变量,使用基本数据类型*/
    Integer days = (Integer) taskService.getVariable(taskId, "请假天数");
    Date date = (Date) taskService.getVariable(taskId, "请假日期");
    String resean = (String) taskService.getVariable(taskId, "请假原因");
    System.out.println("请假天数:"+days);
    System.out.println("请假日期:"+date);
    System.out.println("请假原因:"+resean);
    /**二:获取流程变量,使用javabean类型*/
    Person p = (Person)taskService.getVariable(taskId, "人员信息(添加固定版本)");
    System.out.println(p.getId()+"        "+p.getName());
}

7.4 查询历史流程变量

/**查询流程变量的历史表*/
@Test
public void findHistoryProcessVariables(){
    List<HistoricVariableInstance> list = processEngine.getHistoryService()//
            .createHistoricVariableInstanceQuery()//创建一个历史的流程变量查询对象
            .variableName("请假天数")
            .list();
    if(list!=null && list.size()>0){
        for(HistoricVariableInstance hvi:list){
            System.out.println(hvi.getId()+"   "+hvi.getProcessInstanceId()+"   "+hvi.getVariableName()+"   "+hvi.getVariableTypeName()+"    "+hvi.getValue());
            System.out.println("###############################################");
        }
    }
}

   历史的流程变量查询,指定流程变量的名称,查询act_hi_varinst表(也可以针对,流程实例ID,执行对象ID,任务ID查询)

 

posted @ 2018-05-23 09:40  量化未来  阅读(...)  评论(...编辑  收藏