Activiti学习笔记二 核心API

上一篇简单记录了工作流的概念,以及对Activiti5进行了简单介绍,生成了23张数据库表。

这一篇记录下Activiti的几个核心API

引擎API(图例)

Activiti学习笔记二 核心API_第1张图片

一. ProcessEngine

  1. 在Activiti中最核心的类,其他的类都是由他而来。

  2. 最简单的创建方式(Activiti流程引擎是通过acitiviti.cfg.xml文件进行配置的。注意,这不适用于使用Spring构建流程引擎的情况。)

    ProcessEngine processEngine = ProcessEngines.getDefaultProcessEngine();
  3. 使用配置文件(activiti.cfg.xml)
      <!-- 数据库配置文件 -->
     <bean id="processEngineConfiguration" class="org.activiti.engine.impl.cfg.StandaloneProcessEngineConfiguration">
      <property name="jdbcDriver" value="com.mysql.jdbc.Driver"></property>
      <property name="jdbcUrl" value="jdbc:mysql://localhost:3306/activitims?useUnicode=true&amp;characterEncoding=utf8"></property>
      <property name="jdbcUsername" value="srtc"></property>
      <property name="jdbcPassword" value="srtc"></property>
      <!-- 没有表创建表 -->
      <property name="databaseSchemaUpdate" value="true"></property>
     </bean>
     
  4.    /**
         * 功能: 使用配置文件.<br/>
         * date: 2014年12月15日 下午2:37:26 <br/>
         * 
         * @author [email protected]
         */
        @Test
        public void createTableByCfg() {
            // 流程引擎对象
            ProcessEngine processEngine = ProcessEngineConfiguration
                    .createProcessEngineConfigurationFromResource("activiti.cfg.xml").buildProcessEngine();
            System.out.println("ProcessEngine:" + processEngine);
        }
     
  5. 由流程引擎创建各个Service,这些Service是用来调用工作流23张表的服务
  • 创建RepositoryService
RepositoryService repositoryService = processEngine.getRepositoryService();
  • 创建RuntimeService
RuntimeService runtimeService = processEngine.getRuntimeService();
  • 创建TaskService
TaskService taskService = processEngine.getTaskService();

6.各个Service的作用

       

RepositoryService

管理流程定义

RuntimeService

执行管理,包括启动、推进、删除流程实例等操作

TaskService

任务管理

HistoryService

历史管理(执行完的数据的管理)

IdentityService

组织机构管理

FormService

一个可选服务,任务表单管理

ManagerService

 

 

二.RepositoryService

是Activiti的仓库服务类。所谓的仓库指流程定义文档的两个文件:bpmn文件和流程图片。
  • 可以产生DeploymentBuilder,用来定义流程部署的相关参数
DeploymentBuilder deploymentBuilder = repositoryService.createDeployment();
  • 删除流程定义
repositoryService.deleteDeployment(deploymentId);
 

三.RuntimeService

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

四.TaskService

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

五.HistoryService

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

六.ProcessDefinition

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

七.ProcessInstance

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

八.Execution

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

ProcessInstance的源代码:

Activiti学习笔记二 核心API_第2张图片

从源代码中可以看出ProcessInstance就是Execution。但在现实意义上有所区别:Activiti学习笔记二 核心API_第3张图片

在单线流程中,如上图的贷款流程,ProcessInstance与Execution是一致的。

Activiti学习笔记二 核心API_第4张图片

这个例子有一个特点:wire money(汇钱)和archive(存档)是并发执行的。   这个时候,总线路代表ProcessInstance,而分线路中每个活动代表Execution。

总结:

  • 一个流程中,执行对象可以存在多个,但是流程实例只能有一个。
  • 当流程按照规则只执行一次的时候,那么流程实例就是执行对象。

你可能感兴趣的:(工作流,工作流引擎,activiti5)