04--activiti demo

核心API
1：ProcessEngine
说明：
1) 在Activiti中最核心的类，其他的类都是由他而来。
2) 产生方式：

ProcessEngine processEngine = ProcessEngines.getDefaultProcessEngine();// 流程引擎

3) 可以产生RepositoryService
processEngine.getRepositoryService()// 与流程定义和部署对象相关的Service

4) 可以产生RuntimeService
processEngine.getRuntimeService()// 与正在执行的流程实例和执行对象相关的Service

5) 可以产生TaskService
processEngine.getTaskService()// 与正在执行的任务管理相关的Service

各个Service的作用：
RepositoryService 管理流程定义
RuntimeService 执行管理，包括启动、推进、删除流程实例等操作
TaskService 任务管理
HistoryService 历史管理(执行完的数据的管理)
IdentityService 组织机构管理
FormService 一个可选服务，任务表单管理
ManagerService

2：RepositoryService
是Activiti的仓库服务类。所谓的仓库指流程定义文档的两个文件：bpmn文件和流程图片。
1) 产生方式
 processEngine.getRepositoryService()
2) 可以产生DeploymentBuilder，用来定义流程部署的相关参数

processEngine.getRepositoryService()// 与流程定义和部署对象相关的Service
.createDeployment()// 创建一个部署对象

3) 删除流程定义
processEngine.getRepositoryService().deleteDeployment(deploymentId)

3：RuntimeService
是activiti的流程执行服务类。可以从这个服务类中获取很多关于流程执行相关的信息。
4：TaskService
是activiti的任务服务类。可以从这个类中获取任务的信息。
5：HistoryService
是activiti的查询历史信息的类。在一个流程执行完成后，这个对象为我们提供查询历史信息。
6：ProcessDefinition
流程定义类。可以从这里获得资源文件等。
7：ProcessInstance
代表流程定义的执行实例。如范冰冰请了一天的假，她就必须发出一个流程实例的申请。一个流程实例包括了所有的运行节点。我们可以利用这个对象来了解当前流程实例的进度等信息。流程实例就表示一个流程从开始到结束的最大的流程分支，即一个流程中流程实例只有一个。
8：Execution
Activiti用这个对象去描述流程执行的每一个节点。在没有并发的情况下，Execution就是同ProcessInstance。流程按照流程定义的规则执行一次的过程，就可以表示执行对象Execution。
如图为ProcessInstance的源代码：

从源代码中可以看出ProcessInstance就是Execution。但在现实意义上有所区别：

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

这个例子有一个特点：wire money(汇钱)和archive(存档)是并发执行的。 这个时候，总线路代表ProcessInstance，而分线路中每个活动代表Execution。
总结：
* 一个流程中，执行对象可以存在多个，但是流程实例只能有一个。
* 当流程按照规则只执行一次的时候，那么流程实例就是执行对象。

package cn.miye.test;

import java.util.List;

import org.activiti.engine.ProcessEngine;
import org.activiti.engine.ProcessEngines;
import org.activiti.engine.repository.Deployment;
import org.activiti.engine.runtime.ProcessInstance;
import org.activiti.engine.task.Task;
import org.junit.Test;

public class HelloWorld {

    ProcessEngine processEngine = ProcessEngines.getDefaultProcessEngine();// 流程引擎

    /** 部署流程定义 */
    @Test
    public void deploymentProcessDefinition() {
        // deployment对象存在对应act_re_deployment表中的一条数据
        // 部署流程定义会在act_re_deployment表中插入一条数据,
        // 也会在act_re_procdef中增加一条数据
        Deployment deployment = processEngine.getRepositoryService()// 与流程定义和部署对象相关的Service
                .createDeployment()// 创建一个部署对象
                .name("helloworld入门程序")// 添加部署的名称
                .addClasspathResource("diagrams/helloworld.bpmn")// 从classpath的资源中加载，一次只能加载一个文件
                .addClasspathResource("diagrams/helloworld.png")// 从classpath的资源中加载，一次只能加载一个文件
                .deploy();// 完成部署
        System.out.println("部署ID：" + deployment.getId());//
        System.out.println("部署名称：" + deployment.getName());// helloworld入门程序
    }

    /** 启动流程实例 */
    @Test
    public void startProcessInstance() {
        // 启动流程实例会在act_ru_execution中增加一条数据,表示流程开始执行
        // 在act_ru_identitylink中增加一条数据,表示流程当前的执行人
        // 在act_ru_task中增一条数据
        // 在act_hi_taskinst中增一条数据
        // 在act_hi_procinst中增一条数据
        // 在act_hi_actinst中增一条数据
        // 流程定义的key
        String processDefinitionKey = "helloworld";
        ProcessInstance pi = processEngine.getRuntimeService()// 与正在执行的流程实例和执行对象相关的Service
                .startProcessInstanceByKey(processDefinitionKey);
        // 使用流程定义的key启动流程实例，key对应helloworld.bpmn文件中id的属性值
        // 为什么使用使用key值启动，因为使用key启动,默认是按照最新版本的流程定义启动
        // 启动返回一个流程实例对象
        System.out.println("流程实例ID:" + pi.getId());// 流程实例ID 101
        System.out.println("流程定义ID:" + pi.getProcessDefinitionId());// 流程定义ID helloworld:1:4
    }

    /** 查询当前人的个人任务 */
    @Test
    public void findMyPersonalTask() {
        String assignee = "王五";
        // 在在act_ru_task中查询数据
        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());
                System.out.println("########################################################");
            }
        }
    }

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

}