前言
在进行企业级应用开发时，工作流引擎 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的使用方式，才能确保功能实现的正确性和高效性。
