Activiti类关系图

Activiti类关系图

4.1类关系图

在新版本中，IdentityService，FormService两个Service都已经删除了

4.2activiti.cfg.xml

activiti的引擎配置文件，包括: ProcessEngineConfiguration的定义、 数据源定义、事务管理器等,此文件其实就是一个spring配置文件。

4.3流程引擎配置类

流程引擎的配置类（ProcessEngineCongiuration），通过ProcessEngineCongiuration可以创建工作流引擎ProcessEngine，常用的两种方法如下：

4.3.1StandaloneProcessEngineConfiguration

使用StandaloneProcessEngineConfigurationActiviti可以单独运行，来创建ProcessEngine，Activiti会自己处理事务。
配置文件方式：
通常在activiti.cfg.xml配置文件中定义一个id为processEngineConfiguration的bean
方法如下：

<bean id="processEngineCongiuration" name="processEngineConfiguration" class="org.activiti.engine.impl.cfg.StandaloneProcessEngineConfiguration">
    <!--    配置数据库的相关信息    -->
    <!--    数据库驱动    -->
    <property name="jdbcDriver" value="com.mysql.cj.jdbc.Driver"/>
    <!--    数据库连接    -->
    <property name="jdbcUrl" value="jdbc:mysql:///activiti"/>
    <!--    数据库用户名    -->
    <property name="jdbcUsername" value="root"/>
    <!--    数据库密码    -->
    <property name="jdbcPassword" value="root"/>
    <!--    activiti数据库表在生成时的策略 true - 如果数据库中已经存在相应的表，那么直接使用，如果不存在，那么会创建    -->
    <property name="databaseSchemaUpdate" value="true"/>
</bean>

4.3.2SpringProcessEngineConfiguration

<?xml version="1.0" encoding="UTF-8"?>
<beans xmlns="http://www.springframework.org/schema/beans"
       xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
       xmlns:aop="http://www.springframework.org/schema/aop"
       xmlns:tx="http://www.springframework.org/schema/tx"
       xmlns:context="http://www.springframework.org/schema/context"
       xsi:schemaLocation="http://www.springframework.org/schema/beans
            http://www.springframework.org/schema/beans/spring-beans.xsd
            http://www.springframework.org/schema/aop
            http://www.springframework.org/schema/aop/spring-aop.xsd
            http://www.springframework.org/schema/context
            http://www.springframework.org/schema/context/spring-context.xsd
            http://www.springframework.org/schema/tx
            http://www.springframework.org/schema/tx/spring-tx.xsd">
    <!--  默认方式下bean的id 固定为processEngineCongiuration  -->
    <bean id="processEngineCongiuration" name="processEngineConfiguration"
          class="org.activiti.spring.SpringProcessEngineConfiguration">
        <!--    数据源    -->
        <property name="dataSource" ref="dataSource"/>
        <!--    使用spring事务管理器    -->
        <property name="transactionManager" ref="transactionManager"/>
        <!--    activiti数据库表在生成时的策略    -->
        <property name="databaseSchemaUpdate" value="drop-create"/>
        <!--    activiti的定时任务关闭    -->
        <property name="jobExecutorActivate" value="false"/>
    </bean>
    <!--  流程引擎  -->
    <bean id="processEngine" class="org.activiti.spring.ProcessEngineFactoryBean">
        <property name="processEngineConfiguration" ref="processEngineConfiguration"/>
    </bean>
    <!--  资源服务service  -->
    <bean id="repositoryService" factory-bean="processEngine" factory-method="getRepositoryService"/>
    <!--  流程运行service  -->
    <bean id="runtimeService" factory-bean="processEngine" factory-method="getRuntimeService"/>
    <!--  任务管理service  -->
    <bean id="taskService" factory-bean="processEngine" factory-method="getTaskService"/>
    <!--  历史管理service  -->
    <bean id="historyService" factory-bean="processEngine" factory-method="getHistoryService"/>
    <!--  引擎管理service  -->
    <bean id="managementService" factory-bean="processEngine" factory-method="getManagementService"/>
    <!--  dbcp连接池  -->
    <bean id="dataSource" class="org.apache.commons.dbcp.BasicDataSource">
        <property name="driverClassName" value="com.mysql.cj.jdbc.Driver"/>
        <property name="url" value="jdbc:mysql:///activiti"/>
        <property name="username" value="root"/>
        <property name="password" value="root"/>
        <property name="maxActive" value="3"/>
        <property name="maxIdle" value="1"/>
    </bean>
    <!--  事务管理器  -->
    <bean id="transactionManager" class="org.springframework.jdbc.datasource.DataSourceTransactionManager">
        <property name="dataSource" ref="dataSource"/>
    </bean>
    <!--  通知  -->
    <tx:advice id="txAdvice" transaction-manager="transactionManager">
        <tx:attributes>
            <!--      传播行为      -->
            <tx:method name="save*" propagation="REQUIRED"/>
            <tx:method name="insert*" propagation="REQUIRED"/>
            <tx:method name="delete*" propagation="REQUIRED"/>
            <tx:method name="update*" propagation="REQUIRED"/>
            <tx:method name="find*" propagation="SUPPORTS" read-only="true"/>
            <tx:method name="get*" propagation="SUPPORTS" read-only="true"/>
        </tx:attributes>
    </tx:advice>
    <!--  切面，根据具体项目修改切点配置  -->
    <aop:config proxy-target-class="true">
        <aop:advisor advice-ref="txAdvice" pointcut="execution(* com.itheima.ihrm.service.impl.*.(..))"*/>
    </aop:config>
</beans>

4.4工作流引擎创建

工作流引擎（ProcessEngine），相当于一个门面接口，通过ProcessEngineConfiguration创建processEngine，通过ProcessEngine创建各个Service接口。

4.4.1默认创建方式

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

ProcessEngine defaultProcessEngine = ProcessEngines.getDefaultProcessEngine();
System.out.println(defaultProcessEngine);

4.4.2一般创建方式

//使用自定义方式
//配置文件的名字可以自定义,bean的名字也可以自定义
ProcessEngineConfiguration configuration = ProcessEngineConfiguration.createProcessEngineConfigurationFromResource("activiti.cfg.xml","processEngineConfigration");
//获取流程引擎对象
ProcessEngine processEngine = configuration.buildProcessEngine();

4.5Service服务接口

Service是工作流引擎提供用于进行工作流部署、执行、管理的服务接口，我们使用这些接口可以就是操作服务对应的数据表

4.5.1Service创建方式

通过ProcessEngine创建Service
方式如下：

RuntimeService runtimeService = processEngine.getRuntimeService();
RepositoryService repositoryService = processEngine.getRepositoryService();
TaskService taskService = processEngine.getTaskService();

4.5.2Service总览

service名称	service作用
RepositoryService	activiti的资源管理类
RuntimeService	activiti的流程运行管理类
TaskService	activiti的任务管理类
HistoryService	activiti的历史管理类
ManagerService	activiti的引擎管理类

简单介绍：
RepositoryService
是activiti的资源管理类，提供了管理和控制流程发布包和流程定义的操作。使用工作流建模工具设计的业务流程图需要使用此service将流程定义文件的内容部署到计算机。
除了部署流程定义以外还可以:查询引擎中的发布包和流程定义。
暂停或激活发布包，对应全部和特定流程定义。暂停意味着它们不能再执行任何操作了，激活是对应的反向操作。获得多种资源，像是包含在发布包里的文件，或引擎自动生成的流程图。
获得流程定义的pojo版本，可以用来通过java解析流程， 而不必通过xml。
RuntimeService
Activiti的流程运行管理类。可以从这个服务类中获取很多关于流程执行相关的信息
TaskService
Activiti的任务管理类。可以从这个类中获取任务的信息。
HistoryService
Activiti的历史管理类，可以查询历史信息，执行流程时,引擎会保存很多数据(根据配置)，比如流程实例启动
时间，任务的参与者，完成任务的时间，每个流程实例的执行路径，等等。这个服务主要通过查询功能来获得这
些数据。
ManagementService
Activiti的引擎管理类,提供了对Activiti流程引擎的管理和维护功能，这些功能不在工作流驱动的应用程序中使
用,主要用于Activiti 系统的日常维护。