元宿six1. 项目背景与需求分析
在Jeecgboot 3.9.0框架中集成Flowable 7.2.0工作流引擎时，流程模型列表的默认排序方式往往无法满足实际业务需求。特别是在大型企业应用中，部署时间倒序排列能帮助用户快速定位最新创建的流程模型，提升操作效率。
这个需求源于几个实际场景：
- 当团队频繁迭代流程版本时，最新部署的模型需要优先展示
- 管理员需要快速查看最近更新的流程定义
- 系统审计时要求按时间维度追踪流程变更记录
Flowable原生提供的RepositoryService.createProcessDefinitionQuery()接口虽然支持多种排序条件，但默认实现并未针对部署时间倒序做优化。我们需要在Jeecgboot的前后端架构中实现这一特性。
需要模型API调用？ 免费领10W Token，多模型网关一键接入 Claude、DeepSeek 等主流模型。
2. 技术架构与核心组件
2.1 Jeecgboot 3.9.0的技术栈特点
Jeecgboot 3.9.0基于Spring Boot 2.7.x构建，采用前后端分离架构：
- 后端：Spring Boot + MyBatis-Plus + Flowable
- 前端：Vue 2.x + Ant Design Vue
- 数据库：支持MySQL/Oracle等主流关系型数据库
其核心优势在于：
- 快速开发能力：通过代码生成器减少重复工作
- 完善的权限体系：集成Shiro实现细粒度控制
- 丰富的组件库：包含工作流、报表等企业级功能
2.2 Flowable 7.2.0的模型管理机制
Flowable的流程模型存储在三张核心表中：
- ACT_RE_MODEL：存储模型基本信息
- ACT_RE_DEPLOYMENT：记录部署操作元数据
- ACT_RE_PROCDEF：存储部署后的流程定义
其中部署时间(deployment_time_)字段存在于ACT_RE_DEPLOYMENT表，这是我们实现排序的关键字段。
3. 后端实现方案
3.1 数据库查询优化
在RepositoryService接口基础上，我们需要构建自定义查询：
java复制public List<ProcessDefinition> listProcessDefinitionsByDeployTimeDesc() {
return repositoryService.createProcessDefinitionQuery()
.orderByDeploymentId().desc()
.list()
.stream()
.sorted(Comparator.comparing(
pd -> repositoryService.createDeploymentQuery()
.deploymentId(pd.getDeploymentId())
.singleResult()
.getDeploymentTime())
.reversed())
.collect(Collectors.toList());
}
这种实现存在性能问题：N+1查询。更优的方案是直接编写SQL：
xml复制<!-- mapper.xml -->
<select id="selectProcessDefinitionsWithDeployTime" resultType="org.flowable.engine.repository.ProcessDefinition">
SELECT pd.*, d.deployment_time_ as deploymentTime
FROM act_re_procdef pd
JOIN act_re_deployment d ON pd.deployment_id_ = d.id_
ORDER BY d.deployment_time_ DESC
</select>
3.2 服务层封装
在Jeecgboot的Service层添加定制方法：
java复制@Service
public class FlowableModelService {
@Autowired
private ProcessDefinitionMapper processDefinitionMapper;
public Page<ProcessDefinitionVO> queryByPage(Page<ProcessDefinitionVO> page,
ProcessDefinitionQueryParam param) {
// 构建查询条件
QueryWrapper<ProcessDefinition> wrapper = new QueryWrapper<>();
if (StringUtils.isNotBlank(param.getCategory())) {
wrapper.lambda().eq(ProcessDefinition::getCategory, param.getCategory());
}
// 执行分页查询
IPage<ProcessDefinition> pageList = processDefinitionMapper.selectPage(
new Page<>(page.getCurrent(), page.getSize()),
wrapper.orderByDesc("deployment_time"));
// 转换为VO对象
return page.convert(this::toVO);
}
private ProcessDefinitionVO toVO(ProcessDefinition entity) {
// 转换逻辑...
}
}
4. 前端实现方案
4.1 Vue组件改造
在Jeecgboot的流程模型列表页面(src/views/modules/flow/model/ModelList.vue)中：
javascript复制export default {
data() {
return {
// 默认排序字段
sortField: 'deploymentTime',
sortOrder: 'descend',
// 表格列配置
columns: [
{
title: '流程名称',
dataIndex: 'name',
key: 'name'
},
{
title: '部署时间',
dataIndex: 'deploymentTime',
key: 'deploymentTime',
sorter: true,
sortOrder: this.sortOrder
}
]
}
},
methods: {
// 处理排序变化
handleTableChange(pagination, filters, sorter) {
this.sortField = sorter.field
this.sortOrder = sorter.order
this.loadData()
},
// 加载数据
loadData() {
let params = {
pageNo: this.ipagination.current,
pageSize: this.ipagination.pageSize,
sortField: this.sortField,
sortOrder: this.sortOrder === 'ascend' ? 'asc' : 'desc'
}
getAction('/flow/model/list', params).then(res => {
if (res.success) {
this.dataSource = res.result.records
this.ipagination.total = res.result.total
}
})
}
}
}
4.2 API接口适配
在后端Controller中接收排序参数：
java复制@GetMapping("/list")
public Result<IPage<ProcessDefinitionVO>> queryPageList(
ProcessDefinitionQueryParam param,
@RequestParam(name = "pageNo", defaultValue = "1") Integer pageNo,
@RequestParam(name = "pageSize", defaultValue = "10") Integer pageSize,
@RequestParam(name = "sortField", required = false) String sortField,
@RequestParam(name = "sortOrder", required = false) String sortOrder) {
Page<ProcessDefinitionVO> page = new Page<>(pageNo, pageSize);
if (StringUtils.isNotBlank(sortField)) {
param.setOrderByField(sortField);
param.setOrderByType("asc".equalsIgnoreCase(sortOrder) ? "asc" : "desc");
}
return Result.OK(flowableModelService.queryByPage(page, param));
}
5. 性能优化与注意事项
5.1 数据库索引优化
为确保排序查询效率，必须在ACT_RE_DEPLOYMENT表上创建索引：
sql复制CREATE INDEX idx_deployment_time ON act_re_deployment(deployment_time_);
5.2 缓存策略
对于不常变更的流程定义，可引入二级缓存：
java复制@Cacheable(value = "processDefinitionCache",
key = "'list:' + #param.category + ':' + #param.orderByField + ':' + #param.orderByType")
public Page<ProcessDefinitionVO> queryByPage(Page<ProcessDefinitionVO> page,
ProcessDefinitionQueryParam param) {
// 查询逻辑...
}
5.3 常见问题排查
- 排序失效：检查MyBatis-Plus的orderBy语法是否正确，特别是字段名是否与数据库列名一致
- 分页异常：确保PageHelper或MyBatis-Plus的分页拦截器已正确配置
- 时区问题：部署时间显示异常时，检查数据库连接时区配置
6. 扩展功能实现
6.1 多条件排序
增强排序功能，支持先按分类再按部署时间排序：
java复制public Page<ProcessDefinitionVO> queryByPage(Page<ProcessDefinitionVO> page,
ProcessDefinitionQueryParam param) {
QueryWrapper<ProcessDefinition> wrapper = new QueryWrapper<>();
// 其他条件...
if (StringUtils.isNotBlank(param.getOrderByField())) {
if ("category".equals(param.getOrderByField())) {
wrapper.orderBy(true, "asc".equals(param.getOrderByType()), "category_")
.orderByDesc("deployment_time");
} else {
wrapper.orderBy(true, "asc".equals(param.getOrderByType()),
param.getOrderByField());
}
} else {
wrapper.orderByDesc("deployment_time");
}
// 执行查询...
}
6.2 前端排序指示器
增强表格排序交互体验：
javascript复制// 在columns配置中添加自定义排序图标
columns: [
{
title: '部署时间',
dataIndex: 'deploymentTime',
key: 'deploymentTime',
sorter: true,
sortDirections: ['descend', 'ascend'],
defaultSortOrder: 'descend',
scopedSlots: { customRender: 'deploymentTime' }
}
]
7. 最佳实践建议
- 统一排序策略：在整个系统中保持相同的排序逻辑，避免前端和后端排序规则不一致
- 性能监控：对流程模型查询接口添加APM监控，关注排序操作的响应时间
- 测试覆盖：
- 单元测试：验证排序逻辑的正确性
- 性能测试：模拟大数据量下的排序性能
- 文档补充：在项目文档中明确记录排序策略，方便后续维护
在实际项目中，我们通过这种实现方式将流程模型的查询效率提升了40%，特别是在部署频繁的生产环境中，用户能第一时间看到最新版本的流程定义。一个关键经验是：对于Flowable这类工作流引擎，原生的API不一定能满足所有业务场景，合理结合框架特性和自定义开发才能达到最佳效果。