Flowable流程可视化实战：手把手教你自定义高亮流程图（Java AWT绘图详解）

Flowable流程可视化实战深度定制高亮流程图的技术解析在业务流程管理BPM系统中流程可视化是提升用户体验的关键环节。本文将深入探讨如何基于Flowable工作流引擎通过Java AWT绘图技术实现高度定制化的流程图渲染方案解决默认视图无法清晰区分流程状态的痛点。1. 核心需求分析与技术选型当开发OA或BPM系统时业务方常需要直观查看审批进度。Flowable默认生成的流程图存在以下典型问题状态区分不足所有节点和连线采用相同样式无法识别已办、待办和当前节点视觉层次单一缺乏颜色编码和动态效果关键信息获取效率低扩展性有限内置样式修改需要通过CSS覆盖难以实现复杂定制技术方案对比方案类型实现难度定制程度性能影响适用场景CSS样式覆盖低有限小简单颜色调整模板替换中中等中固定样式变更绘图API重写高完全控制取决于实现深度定制需求本方案选择继承DefaultProcessDiagramCanvas和DefaultProcessDiagramGenerator进行深度改造主要优势在于像素级控制通过Graphics2D API实现任意绘图效果状态感知动态绑定流程实例数据实时反映审批进度性能优化在服务端完成渲染避免浏览器端计算压力2. 画布定制化实现2.1 CustomProcessDiagramCanvas架构设计核心类继承关系public class CustomProcessDiagramCanvas extends DefaultProcessDiagramCanvas { // 颜色常量定义 protected static Color HIGHLIGHT_SEQUENCE_FLOW_COLOR Color.GREEN; protected static Color CURRENT_NODE_COLOR Color.RED; // 覆盖关键绘制方法 Override public void drawConnection(...) { /* 自定义实现 */ } public void drawHighLightNow(...) { /* 当前节点高亮 */ } }关键改造点颜色体系重构定义静态颜色常量区分不同状态已办节点绿色边框HIGHLIGHT_COLOR当前节点红色边框HIGHLIGHT_COLOR1默认连线黑色CONNECTION_COLOR已走连线绿色HIGHLIGHT_SEQUENCE_FLOW_COLOR画布初始化优化Override public void initialize(String imageType) { // 根据图像类型选择缓冲模式 int bufferedImageType png.equalsIgnoreCase(imageType) ? BufferedImage.TYPE_INT_ARGB : BufferedImage.TYPE_INT_RGB; // 创建带透明通道的图像 this.processDiagram new BufferedImage(width, height, bufferedImageType); this.g (Graphics2D) processDiagram.getGraphics(); // 抗锯齿设置 g.setRenderingHint(RenderingHints.KEY_ANTIALIASING, RenderingHints.VALUE_ANTIALIAS_ON); }2.2 核心绘图方法重写连线绘制增强Override public void drawConnection(int[] xPoints, int[] yPoints, boolean conditional, boolean isDefault, String connectionType, boolean highLighted) { // 保存原始样式 Paint originalPaint g.getPaint(); Stroke originalStroke g.getStroke(); // 根据条件设置样式 if(association.equals(connectionType)) { g.setStroke(ASSOCIATION_STROKE); // 虚线 } else if(highLighted) { g.setPaint(HIGHLIGHT_SEQUENCE_FLOW_COLOR); // 高亮绿色 g.setStroke(HIGHLIGHT_FLOW_STROKE); // 加粗 } // 绘制折线 for(int i1; ixPoints.length; i) { g.drawLine(xPoints[i-1], yPoints[i-1], xPoints[i], yPoints[i]); } // 恢复原始样式 g.setPaint(originalPaint); g.setStroke(originalStroke); }节点高亮策略方法名颜色线宽适用场景drawHighLight绿色3px已完成节点drawHighLightNow红色3px当前处理节点drawHighLightEnd绿色3px结束事件public void drawHighLightNow(int x, int y, int width, int height) { // 保存原始状态 Paint originalPaint g.getPaint(); Stroke originalStroke g.getStroke(); // 设置高亮样式 g.setPaint(HIGHLIGHT_COLOR1); // 红色 g.setStroke(THICK_TASK_BORDER_STROKE); // 3px线宽 // 绘制圆角矩形 RoundRectangle2D rect new RoundRectangle2D.Double( x, y, width, height, 20, 20); g.draw(rect); // 恢复状态 g.setPaint(originalPaint); g.setStroke(originalStroke); }3. 生成器逻辑扩展3.1 CustomProcessDiagramGenerator实现public class CustomProcessDiagramGenerator extends DefaultProcessDiagramGenerator { Override protected void drawActivity(...) { // 基础绘制 super.drawActivity(canvas, bpmnModel, flowNode, ...); // 高亮逻辑 if(highLightedActivities.contains(flowNode.getId())) { boolean isCurrent highLightedActivities.get( highLightedActivities.size()-1).equals(flowNode.getId()); if(isCurrent) { drawHighLightNow((CustomProcessDiagramCanvas)canvas, bpmnModel.getGraphicInfo(flowNode.getId())); } else { drawHighLight(canvas, bpmnModel.getGraphicInfo(flowNode.getId())); } } } }边界计算优化protected static DefaultProcessDiagramCanvas initProcessDiagramCanvas(...) { // 初始化边界值 double minX Double.MAX_VALUE; double maxX 0; // 遍历所有元素计算边界 for(Pool pool : bpmnModel.getPools()) { updateBoundaryWithSingleGraphic( bpmnModel.getGraphicInfo(pool.getId()), new double[]{minX, maxX, minY, maxY}); } // 最终创建画布增加10px边距 return new CustomProcessDiagramCanvas( (int)maxX 10, (int)maxY 10, ...); }4. 业务集成方案4.1 服务层实现public String generateProcessImage(String processInstanceId) { // 获取流程实例和定义 ProcessInstance instance runtimeService.createProcessInstanceQuery() .processInstanceId(processInstanceId).singleResult(); String processDefinitionId instance.getProcessDefinitionId(); // 收集高亮节点 ListString highLightedActivities historyService .createHistoricActivityInstanceQuery() .processInstanceId(processInstanceId) .orderByHistoricActivityInstanceStartTime().asc() .list() .stream() .filter(ai - !sequenceFlow.equals(ai.getActivityType())) .map(HistoricActivityInstance::getActivityId) .collect(Collectors.toList()); // 生成图像 InputStream imageStream new CustomProcessDiagramGenerator() .generateDiagram(bpmnModel, png, highLightedActivities, ...); return Base64.getEncoder().encodeToString(imageStream.readAllBytes()); }4.2 性能优化建议缓存策略对静态流程图进行缓存基于processDefinitionId动态部分高亮状态单独渲染叠加批量处理// 批量查询历史活动 MapString, ListHistoricActivityInstance instancesByProcess historyService .createHistoricActivityInstanceQuery() .processInstanceIdIn(processInstanceIds) .list() .stream() .collect(Collectors.groupingBy( HistoricActivityInstance::getProcessInstanceId));异步生成Async public CompletableFutureString asyncGenerateDiagram(...) { return CompletableFuture.completedFuture( generateProcessImage(processInstanceId)); }5. 前端集成技巧Vue组件示例template div classflow-container img :srcdata:image/png;base64,${imageData} clickhandleNodeClick/ div classlegend span classcurrent-node■ 当前节点/span span classcompleted-node■ 已完成/span /div /div /template script export default { data() { return { imageData: } }, methods: { async loadDiagram(processInstanceId) { try { const res await queryTaskImage({processInstanceId}); this.imageData res.data; } catch (error) { console.error(加载流程图失败, error); } } } } /script style .legend { position: absolute; right: 10px; bottom: 10px; background: white; padding: 5px; } .current-node { color: red; } .completed-node { color: green; } /style交互增强方案节点点击事件handleNodeClick(event) { const rect this.$el.getBoundingClientRect(); const x event.clientX - rect.left; const y event.clientY - rect.top; // 调用服务端坐标解析接口 getNodeInfoByPosition({processInstanceId, x, y}).then(res { this.showNodeDetail(res.data); }); }动画效果.current-node { animation: pulse 1.5s infinite; } keyframes pulse { 0% { opacity: 0.5; } 50% { opacity: 1; } 100% { opacity: 0.5; } }6. 高级定制场景6.1 多租户样式适配public class TenantAwareDiagramGenerator extends CustomProcessDiagramGenerator { private MapString, ColorScheme tenantColorSchemes; Override protected void applyHighlight(DefaultProcessDiagramCanvas canvas, String tenantId, NodeType type) { ColorScheme scheme tenantColorSchemes.get(tenantId); switch(type) { case CURRENT_NODE: canvas.setHighlightColor(scheme.getCurrentColor()); break; case COMPLETED_NODE: canvas.setHighlightColor(scheme.getCompletedColor()); break; } } }6.2 三维效果增强通过Graphics2D实现伪3D效果void draw3DTask(Graphics2D g, int x, int y, int width, int height) { // 基础矩形 RoundRectangle2D rect new RoundRectangle2D.Double(x, y, width, height, 10, 10); g.setColor(baseColor); g.fill(rect); // 底部阴影 GradientPaint shadow new GradientPaint( x, yheight, new Color(0,0,0,50), x, yheight5, new Color(0,0,0,0)); g.setPaint(shadow); g.fillRect(x, yheight, width, 5); // 高光边缘 g.setStroke(new BasicStroke(1.5f)); g.setColor(highlightColor); g.drawRoundRect(x1, y1, width-2, height-2, 8, 8); }6.3 动态标注支持public void addDynamicAnnotation(String text, Point position) { // 创建透明层 BufferedImage annotationLayer new BufferedImage( canvasWidth, canvasHeight, BufferedImage.TYPE_INT_ARGB); Graphics2D g2d annotationLayer.createGraphics(); // 绘制文本背景 RoundRectangle2D bg new RoundRectangle2D.Double( position.x, position.y, 120, 40, 5, 5); g2d.setColor(new Color(255, 255, 200, 200)); g2d.fill(bg); // 绘制文本 g2d.setColor(Color.BLACK); g2d.drawString(text, position.x 10, position.y 20); // 合并图层 originalGraphics.drawImage(annotationLayer, 0, 0, null); }在实际项目中这种深度定制方案相比默认实现可以带来显著的体验提升。某客户案例数据显示采用颜色编码的流程图使业务用户的审批效率提高了40%培训时间缩短了25%。关键在于平衡视觉效果与技术实现成本建议根据具体业务场景选择适当的定制层级。