Java Activiti(5)--核心API

1、流程引擎ProcessEngine

说明：
1) 在Activiti中最核心的类，其他的类都是由他而来。

2) 产生方式：
在前面看到了两种创建ProcessEngine（流程引擎）的方式，而这里要简化很多，调用ProcessEngines的getDefaultProceeEngine方法时会自动加载classpath下名为activiti.cfg.xml文件。

3) 可以产生RepositoryService

4) 可以产生RuntimeService

5) 可以产生TaskService

各个Service的作用：

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

2、RepositoryService管理流程定义
是Activiti的仓库服务类。所谓的仓库指流程定义文档的两个文件：bpmn文件和流程图片。
1) 产生方式

RepositoryService repositoryService = processEngine.getRepositoryService();

2) 可以产生DeploymentBuilder，用来定义流程部署的相关参数

DeploymentBuilder builder = processEngine.getRepositoryService().createDeployment();

3) 删除流程定义

processEngine.getRepositoryService().deleteDeployment(deploymentId);

3、RuntimeService执行管理，包括启动、推进、删除流程实例等操作
是activiti的流程执行服务类。可以从这个服务类中获取很多关于流程执行相关的信息。

//2、根据流程定义的key启动流程实例,启动版本version最高的
    @Test
    public void startProcessInstanceByKey() throws Exception {
        String processDefinitionKey = "baoxiaoFlow";
        ProcessInstance processInstance = processEngine.getRuntimeService().startProcessInstanceByKey(processDefinitionKey);
        System.out.println("processInstance.getId()===" + processInstance.getId());
        System.out.println("processInstance.getProcessDefinitionId()===" + processInstance.getProcessDefinitionId());
    }

4、TaskService任务管理
是activiti的任务服务类。可以从这个类中获取任务的信息。

//3、根据流程实例，查询任务列表  ,说明一个流程定义对应多个流程实例，一个流程实例对应多个任务列表
    @Test
    public void getProcessTask() throws Exception {
        String processInstanceId = "5001";
        //1
        String assignee = "tom";
        //2
        //String assignee = "jack";
        //3
        //String assignee = "smith";
        //任务列表
        TaskQuery taskQuery = processEngine.getTaskService().createTaskQuery();
        //查询tom的任务列表
        taskQuery.taskAssignee(assignee);
        taskQuery.orderByTaskCreateTime().desc();
        List<Task> tasks = taskQuery.list();
        for (Task task : tasks) {
            System.out.println(task.getId() + ":" + task.getName());
        }
    }

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

//4.1.1、查询最新流程定义
    @Test
    public void queryLatestProcessDefinition() throws Exception {
        ProcessDefinitionQuery query = processEngine.getRepositoryService().createProcessDefinitionQuery();
        //添加排序
        query.orderByProcessDefinitionVersion().asc();
        List<ProcessDefinition> list = query.list();
        Map<String , ProcessDefinition> map = new HashMap<String, ProcessDefinition>();
        for (ProcessDefinition pd : list) {
            map.put(pd.getKey(), pd);//key不同leaveFlow, baoxiaoFlow
        }
        System.out.println(map);
        ArrayList<ProcessDefinition> lastList = new ArrayList<ProcessDefinition>(map.values());
        for (ProcessDefinition pd: lastList){
            System.out.println(pd.getName() + ":" + pd.getVersion());
        }
    }

6、ProcessInstance流程实例
代表流程定义的执行实例。如范冰冰请了一天的假，她就必须发出一个流程实例的申请。一个流程实例包括了所有的运行节点。我们可以利用这个对象来了解当前流程实例的进度等信息。
如图为ProcessInstance的源代码：

public interface ProcessInstance extends Execution

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

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

2）在多条上有差异

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

//4.3、根据流程定义的id启动流程实例
    @Test
    public void startProcessInstanceById() throws Exception {
        String processDefinitionId = "leaveFlow:4:10004";
        ProcessInstance processInstance = processEngine.getRuntimeService().startProcessInstanceById(processDefinitionId);
        System.out.println("processInstance.getId()===" + processInstance.getId());
    }

7、Execution
Activiti用这个对象去描述流程执行的每一个节点。在没有并发的情况下，同ProcessInstance。