Activiti 通过HistoryService 接口获取历史信息

本文是建立在流程定义，流程实例的基础上的，可以参阅流程定义，流程实例。 本文主要给出了如何使用HistoryService的demo，包含历史流程实例，历史活动，历史任务，历史流程变量的查询。

import org.activiti.engine.HistoryService;
import org.activiti.engine.ProcessEngine;
import org.activiti.engine.history.HistoricActivityInstance;
import org.activiti.engine.history.HistoricProcessInstance;
import org.activiti.engine.history.HistoricTaskInstance;
import org.activiti.engine.history.HistoricVariableInstance;
import org.junit.Before;
import org.junit.Test;
import org.junit.runner.RunWith;
import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.boot.test.context.SpringBootTest;
import org.springframework.test.context.junit4.SpringRunner;

import java.util.List;

/**
 * @describe: HistoryService的使用
 * 由于数据库中保存着历史信息以及正在运行的流程实例信息，在实际项目中对已完成任务的查看频率远
 * 不及对待办和可接任务的查看，所以在activiti采用分开管理，把正在运行的交给RuntimeService、TaskService管理，
 * 而历史数据交给HistoryService来管理。可以加快流程执行的速度，因为正在执行的流程的表中数据不会很大。
 */
@RunWith(SpringRunner.class)
@SpringBootTest(classes = ActivitiApplication.class)
public class HistoryServiceTest {

    @Autowired
    private ProcessEngine processEngine;
    private HistoryService historyService;

    @Before
    public void init() {
        historyService = processEngine.getHistoryService();
    }

    /**
     * 查询历史流程实例
     * 查找按照某个流程定义的规则一共执行了多少次流程
     */
    @Test
    public void queryHistoryProcessInstanceTest() {
        List<HistoricProcessInstance> hpList = historyService.createHistoricProcessInstanceQuery()
                .processInstanceId("17501")
                .orderByProcessInstanceStartTime()
                .asc()
                .list();
        hpList.forEach(i -> {
            System.out.printf("流程定义ID：" + i.getProcessDefinitionId() + "\t实例ID:" + i.getId() + " \t 流程开始时间：" + i.getStartTime());
        });
    }

    /**
     * 查询历史活动
     *  某一次流程的执行一共经历了多少个活动
     */
    @Test
    public void queryHistoryActivityTest() {
        List<HistoricActivityInstance> hai = historyService.createHistoricActivityInstanceQuery()
                .processInstanceId("17501")
                .orderByHistoricActivityInstanceStartTime()
                .desc()
                .list();
        hai.forEach(a -> {
            System.out.printf("流程定义ID：" + a.getProcessDefinitionId() + "\t实例ID:" + a.getId() + "活动ID：" + "\t活动ID：" + a.getActivityId() + "\t活动名称：" + a.getActivityName());
        });
    }

    /**
     * 查询历史任务
     */
    @Test
    public void queryHistoryTaskTest() {
        List<HistoricTaskInstance> taskList = historyService.createHistoricTaskInstanceQuery()
                .processInstanceId("17501")
                .list();
        taskList.forEach(task->{
            System.out.println("任务ID:"+ task.getId() + "\t任务名称："+ task.getName()+"\t任务定义ID："+
                    task.getProcessDefinitionId() + "\t流程实例ID："+ task.getProcessInstanceId() + "\t流程指派人："+
                    task.getAssignee() + "\t任务开始时间："+ task.getStartTime() + "\t任务结束时间："+task.getEndTime());
        });
    }

    /**
     * 查询历史的流程变量
     */
    @Test
    public void queryHistoryProcessVariableTest() {
        List<HistoricVariableInstance> instances = historyService.createHistoricVariableInstanceQuery()
                .processInstanceId("17501")
                .orderByVariableName()
                .desc()
                .list();
        instances.forEach(instance -> {
            System.out.println("流程ID："+ instance.getProcessInstanceId()+"\t流程变量名称："+  instance.getVariableName() + "\t流程变量值" + instance.getValue());
        });
    }
}