前言
在进行企业级应用开发时,工作流引擎 Activiti 为我们提供了强大的流程管理功能。近期在实现产品的一项新需求——流程实例的模糊查询时,遇到了一个小插曲,通过深入研究源码,最终找到了正确的实现方式。本文将分享这一过程,同时也科普一下关于Activiti流程定义查询的相关知识。
正文
首先,我们遇到了这样一个需求:用户希望通过输入部分流程名称进行流程实例的模糊查询。在初步实现时,采用了如下代码:
ProcessDefinitionQuery processDefinitionQuery = repositoryService.createProcessDefinitionQuery();
if (StringUtils.isNotEmpty(pageQuery.getName())) {
processDefinitionQuery.processDefinitionNameLike(pageQuery.getName());
}
乍一看这段代码似乎没什么问题,利用processDefinitionNameLike
方法进行模糊匹配。然而经过测试发现,该查询并未达到预期的模糊搜索效果。
原因在于对processDefinitionNameLike
方法的理解不够深入。实际上,这个方法遵循SQL的LIKE操作符的语法规则,需要我们在查询参数前后添加通配符 %
来实现模糊匹配。
源码解析
查阅Activiti的工作流引擎API文档,ProcessDefinitionQuery
类下的processDefinitionNameLike
方法注释明确指出:
/**
* Only select process definitions where the name matches the given parameter.
* The syntax that should be used is the same as in SQL, eg. %activiti%
*/
ProcessDefinitionQuery processDefinitionNameLike(String processDefinitionNameLike);
这里的注释已经清楚地告诉我们,该方法接收的参数应当是一个符合SQL LIKE操作符语法的字符串,例如%activiti%
,这样才能实现流程定义名称的模糊匹配。
解决方案与优化
因此,正确的实现方式应调整为:
if (StringUtils.isNotBlank(pageQuery.getName())) {
String likePattern = "%" + pageQuery.getName() + "%";
processDefinitionQuery.processDefinitionNameLike(likePattern);
}
在这段代码中,我们先检查传入的流程名称是否非空且不为空白,然后在其前后添加通配符%
构造出符合LIKE操作符语法的查询字符串,再将其传递给processDefinitionNameLike
方法,从而实现了流程定义名称的模糊查询。
结论
通过对Activiti API的深入理解和合理使用,我们可以有效地应对各种复杂查询需求。这次经历再次强调了阅读API文档和源码注释的重要性,特别是在处理类似模糊查询这类具有一定规则限制的功能时,务必准确把握API的使用方式,才能确保功能实现的正确性和高效性。