Activiti入门教程十（详解历史服务组件HistoryService）

最新推荐文章于 2025-03-02 21:53:43 发布
最新推荐文章于 2025-03-02 21:53:43 发布
阅读量2.3w 收藏 28
点赞数 1
分类专栏： Java学习 Activiti入门教程
版权声明：本文为博主原创文章，遵循 CC 4.0 BY-SA 版权协议，转载请附上原文出处链接和本声明。
本文链接：https://blog.csdn.net/luckyzhoustar/article/details/48652783
版权


     Activiti在删除流程定义、删除任务和删除流程实例时，均会将删除的数据保存到历史数据中，初次外，已经完成的流程实例以及相关数据，都会保持到历史数据中，如果要对这些数据进行管理的话，就需要用到HistoryService组件了。


     正如上面所说,Activiti在整个流程执行过程中，会把所有相关的信息，都想历史表中保存，因此HistoryService该组件的查询方法特别的丰富，下面小编带大家来见识一下吧！


     历史流程实例查询 

     使用HistoryService的createHistoricProcessInstanceQuery（）方法就可以得到HistoricProcessInstanceQuery对象，该对象主要用于流程实例的历史数据查询。对于流程实例，不管流程是否完成，都会保存到ACT_HI_PROCINST表中。

<span style="font-family:Comic Sans MS;font-size:18px;">public class ProcessInstanceQuery {

	public static void main(String[] args) throws Exception {
		// 创建流程引擎
		ProcessEngine engine = ProcessEngines.getDefaultProcessEngine();
		// 得到流程存储服务实例
		RepositoryService repositoryService = engine.getRepositoryService();
		// 得到运行时服务组件
		RuntimeService runtimeService = engine.getRuntimeService();
		// 得到历史服务组件
		HistoryService historyService = engine.getHistoryService();
		// 部署流程文件
		Deployment deploy = repositoryService.createDeployment()
				.addClasspathResource("bpmn/ProcessInstanceQuery.bpmn").deploy();
		// 查询流程定义 
				ProcessDefinition define = repositoryService
						.createProcessDefinitionQuery().deploymentId(deploy.getId()).singleResult();
				// 开始流程
				ProcessInstance pi1 = runtimeService.startProcessInstanceByKey("testProcess", "businessKey1");
				ProcessInstance pi2 = runtimeService.startProcessInstanceByKey("testProcess", "businessKey2");
				// 查询执行流
				Execution exe1 = runtimeService.createExecutionQuery()
						.processInstanceId(pi1.getId()).singleResult();
				Execution exe2 = runtimeService.createExecutionQuery()
						.processInstanceId(pi2.getId()).singleResult();
				// 完成第一条流程
				runtimeService.signal(exe1.getId());
				exe1 = runtimeService.createExecutionQuery()
						.processInstanceId(pi1.getId()).singleResult();
				runtimeService.signal(exe1.getId());
				// 查询已完成的流程
				List<HistoricProcessInstance> datas = historyService
						.createHistoricProcessInstanceQuery().finished().list();
				System.out.println("使用finished方法：" + datas.size());
				// 根据流程定义ID查询
				datas = historyService.createHistoricProcessInstanceQuery()
						.processDefinitionId(define.getId()).list();
				System.out.println("使用processDefinitionId方法： " + datas.size());
				// 根据流程定义key（流程描述文件的process节点id属性）查询
				datas = historyService.createHistoricProcessInstanceQuery()
						.processDefinitionKey(define.getKey()).list();
				System.out.println("使用processDefinitionKey方法： " + datas.size());
				// 根据业务主键查询
				datas = historyService.createHistoricProcessInstanceQuery()
						.processInstanceBusinessKey("businessKey1").list();
				System.out.println("使用processInstanceBusinessKey方法： " + datas.size());
				// 根据流程实例ID查询
				datas = historyService.createHistoricProcessInstanceQuery()
						.processInstanceId(pi1.getId()).list();
				System.out.println("使用processInstanceId方法： " + datas.size());
				// 查询没有完成的流程实例
				historyService.createHistoricProcessInstanceQuery().unfinished().list();
				System.out.println("使用unfinished方法： " + datas.size());
	}
}
</span>


     历史任务查询

     通过HistoryService的createHistoricTaskInstanceQuery（）方法，就可以得到HistoricTaskInstanceQuery对象，主要用来根据查询条件，到历史任务表ACT_HI_TASKINST中查询符合条件的数据。

<span style="font-family:Comic Sans MS;font-size:18px;">public class TaskQuery {

	public static void main(String[] args) throws Exception {
		// 创建流程引擎
		ProcessEngine engine = ProcessEngines.getDefaultProcessEngine();
		// 得到流程存储服务实例
		RepositoryService repositoryService = engine.getRepositoryService();
		// 得到运行时服务组件
		RuntimeService runtimeService = engine.getRuntimeService();
		// 得到历史服务组件
		HistoryService historyService = engine.getHistoryService();
		// 得到任务组件
		TaskService taskService = engine.getTaskService();
		// 部署流程文件
		Deployment deploy = repositoryService.createDeployment()
				.addClasspathResource("bpmn/TaskQuery.bpmn").deploy();
		ProcessDefinition define = repositoryService.createProcessDefinitionQuery()
				.deploymentId(deploy.getId()).singleResult();
		// 初始化参数
		SimpleDateFormat sdf = new SimpleDateFormat("yyyy-MM-dd HH:mm:ss");
		Map<String, Object> vars = new HashMap<String, Object>();
		vars.put("varDate1", sdf.parseObject("2020-10-10 06:00:00"));
		vars.put("varDate2", sdf.parseObject("2021-10-10 06:00:00"));
		//开始流程
		ProcessInstance pi1 = runtimeService.startProcessInstanceByKey("testProcess", 
				"businessKey1", vars);
		ProcessInstance pi2 = runtimeService.startProcessInstanceByKey("testProcess", 
				"businessKey2", vars);
		//完成流程1
		Execution exe1 = runtimeService.createExecutionQuery().processInstanceId(pi1.getId())
				.singleResult();
		runtimeService.signal(exe1.getId());
		exe1 = runtimeService.createExecutionQuery().processInstanceId(pi1.getId())
				.singleResult();
		runtimeService.signal(exe1.getId());
		// 流程2完成一个任务
		List<Task> tasks = taskService.createTaskQuery().processInstanceId(pi2.getId()).list();
		for (Task task : tasks) {
			taskService.complete(task.getId());
		}
		//历史数据查询
		List<HistoricTaskInstance> datas = historyService.createHistoricTaskInstanceQuery()
				.finished().list();
		System.out.println("使用finished方法查询：" + datas.size());//结果3
		datas = historyService.createHistoricTaskInstanceQuery()
				.processDefinitionId(define.getId()).list();
		System.out.println("使用processDefinitionId方法查询：" + datas.size());//结果4
		datas = historyService.createHistoricTaskInstanceQuery()
				.processDefinitionKey("testProcess").list();
		System.out.println("使用processDefinitionKey方法查询：" + datas.size());//结果4
		datas = historyService.createHistoricTaskInstanceQuery()
				.processDefinitionName("testProcess2").list();
		System.out.println("使用processDefinitionName方法查询：" + datas.size());//结果4
		datas = historyService.createHistoricTaskInstanceQuery()
				.processFinished().list();
		System.out.println("使用processFinished方法查询：" + datas.size());//结果2
		datas = historyService.createHistoricTaskInstanceQuery()
				.processInstanceId(pi2.getId()).list();
		System.out.println("使用processInstanceId方法查询：" + datas.size());//结果2
		datas = historyService.createHistoricTaskInstanceQuery()
				.processUnfinished().list();
		System.out.println("使用processUnfinished方法查询：" + datas.size());//结果2
		datas = historyService.createHistoricTaskInstanceQuery()
				.taskAssignee("crazyit").list();
		System.out.println("使用taskAssignee方法查询：" + datas.size());//结果2
		datas = historyService.createHistoricTaskInstanceQuery()
				.taskAssigneeLike("%zy%").list();
		System.out.println("使用taskAssigneeLike方法查询：" + datas.size());//结果2
		datas = historyService.createHistoricTaskInstanceQuery()
				.taskDefinitionKey("usertask1").list();
		System.out.println("使用taskDefinitionKey方法查询：" + datas.size());//结果2
		datas = historyService.createHistoricTaskInstanceQuery()
				.taskDueAfter(sdf.parse("2020-10-11 06:00:00")).list();
		System.out.println("使用taskDueAfter方法查询：" + datas.size());//结果2
		datas = historyService.createHistoricTaskInstanceQuery()
				.taskDueBefore(sdf.parse("2022-10-11 06:00:00")).list();
		System.out.println("使用taskDueBefore方法查询：" + datas.size());//结果4
		datas = historyService.createHistoricTaskInstanceQuery()
				.taskDueDate(sdf.parse("2020-10-11 06:00:00")).list();
		System.out.println("使用taskDueDate方法查询：" + datas.size());//结果0
		datas = historyService.createHistoricTaskInstanceQuery()
				.unfinished().list();
		System.out.println("使用unfinished方法查询：" + datas.size());//结果1
	}

}</span>





     历史行为查询

     流程在进行过程中，每每走一个节点，都会记录流程节点的信息，包括节点的id，名称、类型、时间等，保存到ACT_HI_ACTINST表中。

<span style="font-family:Comic Sans MS;font-size:18px;">public class ActivityQuery {


	public static void main(String[] args) {
		// 创建流程引擎
		ProcessEngine engine = ProcessEngines.getDefaultProcessEngine();
		// 得到流程存储服务实例
		RepositoryService repositoryService = engine.getRepositoryService();
		// 得到运行时服务组件
		RuntimeService runtimeService = engine.getRuntimeService();
		// 得到历史服务组件
		HistoryService historyService = engine.getHistoryService();
		// 任务组件
		TaskService taskService = engine.getTaskService();
		// 部署流程文件
		repositoryService.createDeployment()
				.addClasspathResource("bpmn/ActivityQuery.bpmn").deploy();			
		// 开始两条流程
		ProcessInstance pi1 = runtimeService.startProcessInstanceByKey("testProcess");
		ProcessInstance pi2 = runtimeService.startProcessInstanceByKey("testProcess");
		// 结束第一个流程实例
		Execution exe = runtimeService.createExecutionQuery()
				.processInstanceId(pi1.getId()).singleResult();
		runtimeService.signal(exe.getId());
		runtimeService.signalEventReceived("mySignal");
		// 第二个流程实例完成第一个任务
		Task task = taskService.createTaskQuery().processInstanceId(pi2.getId()).singleResult();
		taskService.complete(task.getId());	
		//查询数据
		List<HistoricActivityInstance> datas = historyService.createHistoricActivityInstanceQuery()
				.activityId("endevent1").list();
		System.out.println("使用activityId查询：" + datas.size());//结果1
		datas = historyService.createHistoricActivityInstanceQuery()
				.activityInstanceId(datas.get(0).getId()).list();
		System.out.println("使用activityInstanceId查询：" + datas.size());//结果1
		datas = historyService.createHistoricActivityInstanceQuery()
				.activityType("intermediateSignalCatch").list();
		System.out.println("使用activityType查询：" + datas.size());//结果2
		datas = historyService.createHistoricActivityInstanceQuery()
				.executionId(exe.getId()).list();
		System.out.println("使用executionId查询：" + datas.size());//结果3
		datas = historyService.createHistoricActivityInstanceQuery().finished().list();
		System.out.println("使用finished查询：" + datas.size());//结果6
		datas = historyService.createHistoricActivityInstanceQuery()
				.processInstanceId(pi2.getId()).list();
		System.out.println("使用processInstanceId查询：" + datas.size());//结果3
		datas = historyService.createHistoricActivityInstanceQuery()
				.taskAssignee("crazyit").list();
		System.out.println("使用taskAssignee查询：" + datas.size());//结果2
		datas = historyService.createHistoricActivityInstanceQuery().unfinished().list();
		System.out.println("使用unfinished查询：" + datas.size());//结果1
	}

}
</span>


历史流程明细查询

在流程进行的过程中，会产生许多明细数据，只有将History设置为最高级别的时候，才会被记录到ACT_HI_DETAIL表中。

<span style="font-family:Comic Sans MS;font-size:18px;">public class DetailQuery {

	public static void main(String[] args) {
		// 创建流程引擎
		ProcessEngine engine = ProcessEngines.getDefaultProcessEngine();
		// 得到流程存储服务实例
		RepositoryService repositoryService = engine.getRepositoryService();
		// 得到运行时服务组件
		RuntimeService runtimeService = engine.getRuntimeService();
		// 得到历史服务组件
		HistoryService historyService = engine.getHistoryService();
		// 得到任务组件
		TaskService taskService = engine.getTaskService();
		// 部署流程文件
		repositoryService.createDeployment()
			.addClasspathResource("bpmn/DetailQuery.bpmn").deploy();
		// 初始化参数
		Map<String, Object> vars = new HashMap<String, Object>();
		vars.put("days", 10);
		//  开始流程
		ProcessInstance pi1 = runtimeService.startProcessInstanceByKey("testProcess", vars);
		ProcessInstance pi2 = runtimeService.startProcessInstanceByKey("testProcess", vars);
		// 完成第一个流程 
		Execution exe = runtimeService.createExecutionQuery()
				.processInstanceId(pi1.getId()).singleResult();
		Task task = taskService.createTaskQuery().executionId(exe.getId()).singleResult();
		taskService.complete(task.getId(), vars);
		exe = runtimeService.createExecutionQuery().processInstanceId(pi1.getId()).singleResult();
		runtimeService.signal(exe.getId());
		// 为第二个流程的第一个任务设置参数
		exe = runtimeService.createExecutionQuery().processInstanceId(pi2.getId()).singleResult();
		task = taskService.createTaskQuery().executionId(exe.getId()).singleResult();
		taskService.setVariableLocal(task.getId(), "name", "crazyit");
		// 查询历史行为
		HistoricActivityInstance act = historyService.createHistoricActivityInstanceQuery()
				.activityName("First Task").finished().singleResult();
		List<HistoricDetail> datas = historyService.createHistoricDetailQuery()
				.activityInstanceId(act.getId()).list();
		System.out.println("使用activityInstanceId方法查询：" + datas.size());//结果1
		datas = historyService.createHistoricDetailQuery().excludeTaskDetails().list();
		System.out.println("使用excludeTaskDetails方法查询：" + datas.size());//结果3
		datas = historyService.createHistoricDetailQuery().formProperties().list();
		System.out.println("使用formProperties方法查询：" + datas.size());//结果0
		datas = historyService.createHistoricDetailQuery().processInstanceId(pi1.getId()).list();
		System.out.println("使用processInstanceId方法查询：" + datas.size());//结果2
		datas = historyService.createHistoricDetailQuery().taskId(task.getId()).list();
		System.out.println("使用taskId方法查询：" + datas.size());//结果1
		datas = historyService.createHistoricDetailQuery().variableUpdates().list();
		System.out.println("使用variableUpdates方法查询：" + datas.size());//结果4
	}

}
</span>

（四）activiti7大服务service详解——6 HistoryService
06-06 5180
描述 History Service 用于获取正在运行或已经完成的流程实例的信息，与 Runtime Service 中获取的流程信息不同，历史信息包含已经持久化存储的永久信息，并已经被针对查询优化。
七、历史数据操作 - HistoryService
qq_34609370的博客
10-18 1448
1
Activity服务类-4HistoryService历史服务
一剑轻语
04-27 3875
一共个方法15个方法 用于查询历史工作流信息 1.创建查询（7个方法） //创建一个新的编程查询来搜索{@link HistoricProcessInstance}。 HistoricProcessInstanceQuery createHistoricProcessInstanceQuery(); //创建一个新的编程查询来搜索{@link HistoricActivityInst...
流程定义和流程实例
最新发布
qq_36022463的博客
03-02 561
跟流程实例流程部署的表,就是RE_开头的表都是通过操作# true: 表示去检查，，false：表示不检查，表示不会自动部署流程# 指定流程定义xml文件后缀，，默认的后缀 是 **.bpmn20.xml,**.bpmn@Autowired// 开始部署构建.name("测试工作流")// 部署表的分类.category("流程分类").key("部署的key")// 设置文件的输入流，， 通过这个输入流自动读取xml文件// 完成部署.deploy();
Activiti HistoryService
Klose1123的博客
05-21 1070
1.查询历史流程实例 /** * 查询历史流程实例 */ @Test public void test11(){ HistoryService historyService = processEngine.getHistoryService(); HistoricProcessInstance historicProc...
Activiti6.0流程引擎学习——(25)activiti的历史数据管理服务（HistoryService）
JJBOOM425的博客
02-21 4564
首先我们要知道activiti中的历史数据：当流程或节点执行完成离开了运行库放入历史库的数据称为历史数据。 HistoryService： 1、管理流程实例结束后的历史数据； 2、构建历史数据的查询对象； 3、根据流程实例Id删除流程历史数据。 HistoryService历史数据实体： 历史数据实体 描述 HistoryProcessInstance 历史流程实例实体...
【Activiti7】04 - History Service
一名学生的思考
08-17 1464
HistoryService是Activiti的历史管理类服务，提供流程相关的历史数据管理，如历史流程实例、历史活动和历史流程任务的查询等。 本文旨在介绍HistoryService在开发中的常用功能。
Activiti5详解：从入门到实践
3. **服务接口**：Activiti5提供了多种服务接口，如RepositoryService用于部署和查询流程定义，RuntimeService用于启动流程实例，TaskService用于任务的操作，HistoryService用于查询历史数据，FormService用于表单...
springboot2+activiti7+bpmn-js使用入门
nzgry_csdn的博客
06-29 8040
springboot2+activiti7+bpmn-js使用入门 本示例使用springboot2+activiti7+bpmn-js(vue+elementUI)环境； 官网：https://www.activiti.org/ 目录springboot2+activiti7+bpmn-js使用入门搭建表结构和组件流程设计器API数据查询保存流程设计部署启动审批流程图 搭建 首先搭建好springboot项目的开发环境； 添加maven依赖（目前git上最新版是7.1.0.M13，但是我在阿里云的m
Activiti 5.13实现简单请假流程的Java代码详解
Activiti的请假流程实现是一个很好的入门实例，通过这个实例，开发者可以熟悉Activiti框架的使用、流程设计和业务流程自动化的基本概念。同时，Activiti官方提供的文档和社区也提供了丰富的学习资源，帮助开发者更好...
Activiti——历史数据和流程引擎管理HistoryService、ManagermentService API详解
吴声子夜歌的博客
09-06 1904
这里写自定义目录标题Activiti历史数据和流程引擎管理1、历史数据管理1.1、历史流程实例查询1.2、历史任务查询1.3、历史行为查询1.4、历史流程明细查询1.5、删除历史流程实例和历史任务2、工作的产生2.1、异步任务产生的工作2.2、定时中间事件产生的工作2.3、定时边界事件产生的工作2.4、定时开始事件产生的工作2.5、流程抛出事件产生的工作2.6、暂停工作的产生2.7、无法执行的工作3、工作管理3.1、工作查询对象3.2、获取工作异常信息3.3、转移与删除工作4、数据库管理4.1、查询引擎属性
学习篇-Activiti-25-HistoryService
东东爱编码博客
07-29 1039
文章目录一、历史管理服务二、相关代码 一、历史管理服务 HistoryService 管理流程实例结束后的历史数据 构建历史数据的查询对象 根据流程实例id删除流程历史数据 HistoryService历史数据实体 历史数据实体 描述 HistoricProcessInstance 历史流程实例实体类 HistoricVariableInstance 流程或任务变量值的实体 HistoricActivityInstance 单个活动节点执行的信息 HistoricTa
jBPM4.4：HistoryService历史服务
cfy_zybing的专栏
08-18 204
在流程实例执行的过程中，会不断触发事件。 从那些事件中，运行和完成流程的历史信息会被收集到历史表中。 HistoryService 提供了 对那些信息的访问功能。   如果想查找某一特定流程定义的所有流程实例， 可以像这样操作： List&lt;HistoryProcessInstance&gt; historyProcessInstan...
Activiti 通过HistoryService 接口获取历史信息
houkai的博客
12-05 4154
本文是建立在流程定义，流程实例的基础上的，可以参阅流程定义，流程实例。本文主要给出了如何使用HistoryService的demo，包含历史流程实例，历史活动，历史任务，历史流程变量的查询。 import org.activiti.engine.HistoryService; import org.activiti.engine.ProcessEngine; import org.activ...
[自学Activti]5历史任务HistoryService 查询历史记录 Day5
weixin_46172301的博客
09-14 613
历史记录综合信息: HistoricTaskInstance。历史变量: HistoricVariableInstance。
【Activiti系列学习】--17.Activiti核心API之HistoryService和ManagementService
长林攻城狮的博客
04-05 1812
HistoryService HistoryService历史服务 1.功能： 管理流程结束后的历史数据 构建历史数据的查询对象 根据流程实例ID删除流程历史数据 2.HistoryService历史数据实体 HistoryProcessInstance ->历史流程实例实体类 HistoricVariableInstance ->流程或任务...
activiti框架 之 利用 HistoryService接口连获取 审批流程的执行历史（个人备忘）截图转载
zy103118的博客
10-10 1679
Flowable的RepositoryService、RuntimeService、TaskService、HistoryService、IdentityService
kimi
02-22 5315
Flowable的RepositoryService、RuntimeService、TaskService、HistoryService、IdentityService
评论 11
添加红包

请填写红包祝福语或标题

个

红包个数最小为10个

元

红包金额最低5元

当前余额3.43元 前往充值 >
需支付：10.00元
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付元
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明：

1.余额是钱包充值的虚拟货币，按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载，可以购买VIP、付费专栏及课程。

余额充值