Activiti的进阶

简介:

　　通过加载activiti.cfg.xml文件得到ProcessEngineConfiguration对象，通过ProcessEngineConfiguration对象可以得到ProcessEngine对象

　　得到该对象后，可以通过流程引擎对象ProcessEngine来得到各种Service，每一种Service接口有每个用途
　　　　RepositoryService activiti 的资源管理类
　　　　RuntimeService activiti 的流程运行管理类
　　　　TaskService activiti 的任务管理类
　　　　HistoryService activiti 的历史管理类
　　　　ManagerService activiti 的引擎管理类

ProcessEngineConfiguration流程引擎的配置类

　　通过ProcessEngineConfiguration可以创建工作流引擎ProceccEngine；

　　　　StandaloneProcessEngineConfiguration

　　　　通过org.activiti.engine.impl.cfg.StandaloneProcessEngineConfiguration;

　　　　Activiti可以单独运行，使用它创建的ProcessEngine，Activiti会自己处理事务；

　　　　配置文件方式如下：

　　　　　　通过在activiti.cfg.xml配置文件中顶一个id为processEngineConfiguration的bean，这里会使用spring的依赖注入来构建引擎；

<!--配置Activiti使用的processEngine对象   默认命名为processEngineConfiguration-->
    <bean id="processEngineConfiguration" class="org.activiti.engine.impl.cfg.StandaloneProcessEngineConfiguration">
        <!--注入数据源-->
        <property name="dataSource" ref="dataSource"/>
        <!--配置数据源方式二：-->
        <!--<property name="jdbcDriver" value="com.mysql.jdbc.Driver"/>-->

        <!--指定数据库生成策略-->
        <property name="databaseSchemaUpdate" value="true"/>
    </bean>

　　　　SpringProcessEngineConfiguration

　　　　通过org.activiti.spring.SpringProcessEngineConfiguration与spring整合；

　　　　创建spring与activiti的整合配置文件：

　　　　activiti-spring.cfg.xml（名称不固定）

　　　　创建processEngineConfiguration

    public static void main(String[] arrgs){
        //加载配置文件
        ProcessEngineConfiguration configuration = ProcessEngineConfiguration.createProcessEngineConfigurationFromResource("activiti.cfg.xml");
        //获取对象
        ProcessEngine processEngine = configuration.buildProcessEngine();
    }

ProcessEngine

　　工作流引擎，相当于一个门面接口，通过ProcessEngineConfiguration创建ProcessEngine，通过ProcessEngine创建各个service接口；

　　　　一般创建方式

//获取对象
ProcessEngine processEngine = configuration.buildProcessEngine();

　　　　简单创建方式

　　　　　　将activiti.cfg.xml文件名及路径固定，且activiti.cfg.xml文件中有processEngineConfiguration的配置，可以使用如下代码创建processEngine；

//获取ProcessEngine
ProcessEngine processEngine = ProcessEngines.getDefaultProcessEngine();

service

　　　service创建方式

　　　　通过ProcessEngine创建service，service是工作流引擎提供用于进行工作部署，执行，管理的服务接口；

　　　　方式如下：

//获取RepositoryService对象进行流程部署
RepositoryService repositoryService = processEngine.getRepositoryService();
//获取RuntimeService对象
RuntimeService runtimeService = processEngine.getRuntimeService();
//获取TaskService对象进行流程部署
TaskService taskService = processEngine.getTaskService();

　　service总览

 　　RepositoryService 

　　　　是activiti的资源管理类，提供了管理和控制流程发布包和流程定义的操作；使用工作流建模工具设计的业务流程图需要使用此service将流程定义文件的内容部署到计算机；

　　　　除了部署流程定义以外还可以：查询引擎中的发布包和流程定义；

　　　　暂停或激活发布包，对应全部和特定流程定义；暂停意味着他们不能再执行任何操作了，激活是对应的反向操作；

　　　　获得多种资源，像是包含在发布包里的文件，或引擎自动生成的流程图；获得流程定义的pojo版本，可以用来通过java解析流程，而不必通过xml;

　　RuntimeService

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

　　TaskService

　　　　它是activiti的任务管理类，可以从这个类中后去任务的信息

　　HistoryService

　　　　它是activiti的历史管理类，可以查询历史信息，执行流程时，引擎会保存很多数据（根据配置），比如流程实例启动时间，任务的参与者，完成任务的时间，每个流程实例的执行路径等等，这个服务主要通过查询功能来获取这些数据；

　　ManagementService

　　　　它是activiti的引擎管理类，提供了对activiti流程引擎的管理和维护功能，这些功能不在工作流驱动的应用程序中使用，主要用于activiti系统的日常维护；

Activiti使用步骤：

　　1.流程定义
　　　　使用Activiti Designer工具创建流程图
　　　　新建一个BPMNFile流程图，可更改该流程图的ID和每个任务环节的执行人，流程图就是一个xml文件，每一个流程需要生成一张流程图保存，首先将.bpmn文件改为.xml文件然后右键该xml文件Diagrams--->show BPMN 2.0 Designer就能生成一张流程图，将流程图导出保存到项目对应目录即可，然后将xml改回bpmn即可

　　2.流程部署

　　　　部署流程定义就是要将上边绘制的图形即流程定义（.bpmn）部署在工作流引擎activiti中，方法如下：

　　　　使用ProcessEngine创建RepositoryService，代码如下：

/*流程部署
* `act_ge_bytearray`    流程定义的资源信息，包含bpmn和png流程文件信息
* `act_re_deployment`   流程部署信息 包含流程名称，ID，key等
* `act_re_procdef`      流程定义信息
* */
public class ActivitiTest {
    public static void main(String[] args) {
        //获取ProcessEngine
        ProcessEngine processEngine = ProcessEngines.getDefaultProcessEngine();
        //获取RepositoryService对象进行流程部署
        RepositoryService repositoryService = processEngine.getRepositoryService();
        //进行部署，将对应的流程定义文件生成到数据库当中，作为记录进行保存
        Deployment  deployment= repositoryService.createDeployment()
                .addClasspathResource("bpmnfile/hoilday.bpmn")       //加载流程文件
                .addClasspathResource("bpmnfile/hoilday.png")
                .name("请假流程")   //设置流程名称
                .deploy();//部署
        //输出部署信息
        System.out.println("流程名称："+deployment.getName());
        System.out.println("流程ID："+deployment.getId());
        System.out.println("流程key:"+deployment.getKey());
    }
}

　　执行此操作后activiti会将上边代码中执行的bpmn文件和图片文件保存在activiti数据库中；

　　3.启动一个流程实例

　　流程定义部署在activiti后就可以通过工作流管理业务流程了，也就是说上边部署的请假申请流程可以使用了；

　　针对该流程，启动一个流程表示发起一个新的请假申请单，这就相当于java类与java对象的关系，类定义好后需要new创建一个对象使用，当然可以new多个对象；对于请假申请流程，张三发起一个请假申请需要启动一个流程实例，请假申请单发起一个请假单也需要启动一个流程实例；

/*启动流程实例
*`act_hi_actinst`           已经开始和执行完毕的活动信息
*`act_hi_identitylink`      历史参与者信息
*`act_hi_procinst`          流程实例信息
*`act_hi_taskinst`          历史任务实例
*`act_ru_execution`         任务执行信息
*`act_ru_identitylink`      当前任务执行参与者
 *`act_ru_task`             任务信息
*
* */
public class StartInstance {
    public static void main(String[] args) {
        //获取ProcessEngine
        ProcessEngine processEngine = ProcessEngines.getDefaultProcessEngine();
        //获取RuntimeService对象
        RuntimeService runtimeService = processEngine.getRuntimeService();
        //创建流程实例
        ProcessInstance hoilday = runtimeService.startProcessInstanceByKey("hoilday");
        //输出实例信息
        System.out.println("获取流程部署ID："+hoilday.getDeploymentId());
        System.out.println("获取流程实例ID："+hoilday.getId());
        System.out.println("获取流程活动ID："+hoilday.getActivityId());
    }
}

　　4.任务查询

　　　　流程启动后，各个任务的负责人就可以查看自己当前需要处理的任务，查询出来的任务都是该用户的代办任务；

/*查看代办任务*/
public class GetTask {
    public static void main(String[] args) {
        //获取ProcessEngine
        ProcessEngine processEngine = ProcessEngines.getDefaultProcessEngine();
        //获取一个TaskService对象
        TaskService taskService = processEngine.getTaskService();
        //查询代办业务 createTaskQuery查询任务  taskCandidateOrAssigned查询任务执行者    processDefinitionKey执行查看流程
        //查看hoilday流程中zhangsan代办的任务
        //taskCandidateOrAssigned匹配规则： 1.Assigned   2.配置bpmn文件中定义的值
        /*List<Task> list = taskService.createTaskQuery().taskCandidateOrAssigned("zhangsan").processDefinitionKey("hoilday").list();*/
        //taskAssignee查看当前指定人的指定任务
        List<Task> list = taskService.createTaskQuery().taskAssignee("zhangsan").processDefinitionKey("hoilday").list();
        for (Task task:list){
            System.out.println("任务名称："+task.getName());
            System.out.println("任务执行人："+task.getAssignee());
            System.out.println("任务ID："+task.getId());
            System.out.println("流程实例ID："+task.getProcessInstanceId());
        }
    }
}

　　5.任务处理

　　　　任务负责人查询代办任务，选择任务进行处理，完成任务；

/*任务处理
* `act_hi_identitylink`     历史参与者信息
* `act_hi_taskinst`         历史任务信息
* `act_ru_execution`        任务执行信息
* `act_ru_task`             任务信息
* 当所有任务处理完毕，对应当前流程实例信息删除，但是可以在历史中查看该信息
* */
public class CompleteTask {
    public static void main(String[] args) {
        //获取ProcessEngine
        ProcessEngine processEngine = ProcessEngines.getDefaultProcessEngine();
        //获取TaskService对象进行流程部署
        TaskService taskService = processEngine.getTaskService();
        //任务处理
        taskService.complete("15005");
        
    }
}