flowable入门-API服务介绍 flowable api

一、流程API定义

Flowable提供了一套流程服务接口，通过链式的调用实现流程的创建、查询、处理、转派等操作，开发者并不需要关心流程实现的细节，从而实现业务流程的开发。

二、流程服务

Flowable提供了8个服务接口，如下图所示，这些服务接口都是通过ProcessEngine的方法创建的，ProcessEngine和xxxService这些服务接口都是线程安全的，可以多个线程共用一个引用的。首先获取ProcessEngine实例，然后就可以通过流程引擎实例实例来获取流程服务接口。

获取流程服务接口的代码如下：

ProcessEngine processEngine = ProcessEngines.getDefaultProcessEngine();
RuntimeService runtimeService = processEngine.getRuntimeService();
RepositoryService repositoryService = processEngine.getRepositoryService();
TaskService taskService = processEngine.getTaskService();
ManagementService managementService = processEngine.getManagementService();
IdentityService identityService = processEngine.getIdentityService();
HistoryService historyService = processEngine.getHistoryService();
FormService formService = processEngine.getFormService();
DynamicBpmnService dynamicBpmnService = processEngine.getDynamicBpmnService();

RepositoryService：这个服务管理了流程部署发布和流程定义，这个服务是流程启动的一个服务。该服务常用的操作有：

1.流程的部署、查询、暂停、激活、删除与流程的定义(初始化ProcessDefinition对象)。

2.获取流程部署中的文件和图片。

RuntimeService：这个服务用于启动一个新的流程实例。前文介绍过，流程定义是定义了一个流程的整体结构与行为。流程实例则是流程定义的实际执行过程。该服务就是管理了流程实例的创建（startProcessInstanceByKey方法）和管理，除此之外该服务还存储和读取了流程中的变量。

TaskService：拥有了一个流程的实例后，需要一个任务来执行，这个时候，就需要使用TaskService来创建一个Task，该服务是创建并且管理流程中的任务的接口服务，例如查询分配任务、认领完成任务都是通过这个服务提供的接口。

HistoryService：当任务执行完成后，需要查询历史的执行轨迹的时候，可以使用该服务的接口完成。该服务接口可以查询流程和任务执行的各个节点的情况，如流程处理时间，任务执行人等，一般用于流程的环节查下实现流程处理人员的考核。

IdentityService：该服务是用于管理流程的组合用户。这个服务在实际的生产中可以选择的使用。

FormService：这个是表单服务的接口，管理着自定义表单的查询和管理的接口调用，因为在实际的生产中，我们表单引擎由项目组自定义，所以表单的接口可以选择使用。

ManagementService：提供了流程对作业的管理的接口服务，如定时器（Timer）、异步操作、延时暂停激活等。

DynamicBpmnService：在无需部署的情况下修改流程定义中的流程结构等。

flowable提供了链式API的操作来调用上述接口中的方法，例如查询处理人为Tom的待办任务清单并按照日期排序，可以使用如下代码：

List<Task> tasks = taskService.createTaskQuery()
    .taskAssignee("Tom")
    .orderByDueDate().asc()
    .list();

当然如果有是时候需要使用Sql查询，也是支持自定义sql语句的使用（createNativeTaskQuery），例如上面的查询通过sql来查询代码如下：

List<Task> tasks = taskService.createNativeTaskQuery()
  .sql("SELECT count(*) FROM " + managementService.getTableName(Task.class) +
      " T WHERE T.NAME_ = #{taskName}")
  .parameter("taskName", "Tom")
  .list();