SpringBoot + Low-Code + JSON 表单引擎:5 分钟配置一套审批流,告别重复 CRUD

前言

在企业级应用开发中,审批流是一个高频需求。无论是请假申请、费用报销,还是采购审批,都需要一套完整的表单和流程系统。传统开发模式下,每个审批流都需要单独开发表单页面、验证逻辑、数据存储和流程控制,不仅耗时耗力,还容易出现重复造轮子的情况。今天,我将和大家分享一个基于SpringBoot的低代码表单引擎解决方案,通过JSON配置,实现5分钟配置一套审批流,彻底告别重复的CRUD开发。
原文链接

为什么需要低代码表单引擎?

1. 开发效率问题

传统审批流开发需要经历以下步骤:

  • 设计表单UI界面
  • 实现前端交互逻辑
  • 开发后端API接口
  • 编写数据验证逻辑
  • 集成工作流引擎
  • 实现审批节点配置
  • 部署和测试

整个过程可能需要几天甚至几周时间,而且每个新流程都要重复这些步骤。

2. 维护成本高昂

随着业务发展,表单字段经常需要调整,流程节点需要变更,每次修改都需要开发人员介入,增加了维护成本和响应时间。

3. 业务人员参与度低

业务人员无法直接参与表单和流程的设计,只能被动接受开发结果,导致最终产品与实际需求存在偏差。

核心技术方案

1. 架构设计

我们的解决方案采用以下核心技术栈:

  • Spring Boot: 快速开发框架
  • JSON Schema: 定义表单结构
  • Activiti: 工作流引擎
  • Thymeleaf: 模板引擎用于动态表单渲染
  • Redis: 缓存表单定义和流程定义
  • MySQL: 数据持久化存储

2. 核心组件

表单定义(FormDefinition)
{"formKey":"leave_application","formName":"请假申请","formTitle":"员工请假申请表","formSchema":{"type":"object","properties":{"employeeName":{"type":"string","title":"员工姓名","required":true},"department":{"type":"string","title":"所属部门","enum":["技术部","市场部","人事部","财务部"],"enumNames":["技术部","市场部","人事部","财务部"]},"leaveType":{"type":"string","title":"请假类型","enum":["年假","病假","事假","婚假","产假"],"enumNames":["年假","病假","事假","婚假","产假"]},"startDate":{"type":"string","format":"date","title":"开始日期"},"endDate":{"type":"string","format":"date","title":"结束日期"},"reason":{"type":"string","title":"请假原因","maxLength":200}},"required":["employeeName","leaveType","startDate","endDate"]},"formUiSchema":{"employeeName":{"ui:widget":"input"},"department":{"ui:widget":"select"},"leaveType":{"ui:widget":"radio"},"reason":{"ui:widget":"textarea"}},"processDefinitionKey":"leave_approval_process"}
流程定义(ApprovalProcess)
{"processKey":"leave_approval_process","processName":"请假审批流程","processDefinition":"<?xml version=\"1.0\" encoding=\"UTF-8\"?>...","description":"员工请假申请审批流程"}

3. 核心实现

表单渲染服务
@Service@Slf4jpublicclassFormRenderingService{/** * 根据表单定义渲染HTML表单 */publicStringrenderForm(FormDefinition formDefinition){try{JSONObject schema = JSON.parseObject(formDefinition.getFormSchema());JSONObject uiSchema = JSON.parseObject(formDefinition.getFormUiSchema());StringBuilder html =newStringBuilder(); html.append("<form id=\"").append(formDefinition.getFormKey()).append("\" class=\"low-code-form\">\n");// 添加表单标题if(formDefinition.getFormTitle()!=null&&!formDefinition.getFormTitle().isEmpty()){ html.append(" <h3>").append(formDefinition.getFormTitle()).append("</h3>\n");}// 解析schema中的属性并生成对应的HTML元素if(schema.containsKey("properties")){JSONObject properties = schema.getJSONObject("properties");for(String fieldName : properties.keySet()){JSONObject fieldSchema = properties.getJSONObject(fieldName);JSONObject fieldUiSchema = uiSchema !=null? uiSchema.getJSONObject(fieldName):null;String fieldHtml =generateFieldHtml(fieldName, fieldSchema, fieldUiSchema); html.append(fieldHtml).append("\n");}}// 添加提交按钮 html.append(" <div class=\"form-actions\">\n"); html.append(" <button type=\"submit\" class=\"btn btn-primary\">提交</button>\n"); html.append(" <button type=\"reset\" class=\"btn btn-secondary\">重置</button>\n"); html.append(" </div>\n"); html.append("</form>\n");return html.toString();}catch(Exception e){ log.error("渲染表单失败: {}", formDefinition.getFormKey(), e);return"<div class=\"error\">表单渲染失败</div>";}}/** * 根据字段类型生成HTML元素 */privateStringgenerateFieldHtml(String fieldName,JSONObject fieldSchema,JSONObject fieldUiSchema){StringBuilder fieldHtml =newStringBuilder();// 获取字段标签String label = fieldSchema.getString("title");if(label ==null|| label.isEmpty()){ label = fieldName;}// 获取字段类型String type = fieldSchema.getString("type");String widget = fieldUiSchema !=null? fieldUiSchema.getString("ui:widget"):null;// 生成字段HTML fieldHtml.append(" <div class=\"form-group\">\n"); fieldHtml.append(" <label for=\"").append(fieldName).append("\">").append(label).append("</label>\n");if("string".equals(type)){if("textarea".equals(widget)){// 文本域 fieldHtml.append(" <textarea id=\"").append(fieldName).append("\" name=\"").append(fieldName).append("\"").append(" class=\"form-control\"");// 添加验证规则addValidationAttributes(fieldHtml, fieldSchema); fieldHtml.append(">");if(fieldSchema.containsKey("default")){ fieldHtml.append(fieldSchema.getString("default"));} fieldHtml.append("</textarea>\n");}else{// 输入框 fieldHtml.append(" <input type=\"text\" id=\"").append(fieldName).append("\" name=\"").append(fieldName).append("\"").append(" class=\"form-control\"");// 添加默认值if(fieldSchema.containsKey("default")){ fieldHtml.append(" value=\"").append(fieldSchema.getString("default")).append("\"");}// 添加验证规则addValidationAttributes(fieldHtml, fieldSchema); fieldHtml.append(" />\n");}}// ... 其他类型的字段处理 fieldHtml.append(" </div>\n");return fieldHtml.toString();}}
表单验证服务
@Service@Slf4jpublicclassFormValidationService{/** * 根据表单定义验证表单数据 */publicValidationResultvalidateFormData(String formKey,String formData,FormDefinition formDefinition){ValidationResult result =newValidationResult();try{JSONObject data = JSON.parseObject(formData);JSONObject schema = JSON.parseObject(formDefinition.getFormSchema());// 获取必填字段if(schema.containsKey("required")){JSONArray requiredFields = schema.getJSONArray("required");for(int i =0; i < requiredFields.size(); i++){String fieldName = requiredFields.getString(i);if(!data.containsKey(fieldName)|| data.getString(fieldName)==null|| data.getString(fieldName).trim().isEmpty()){ result.addError(fieldName, fieldName +" 是必填字段");}}}// 验证字段类型和约束if(schema.containsKey("properties")){JSONObject properties = schema.getJSONObject("properties");for(String fieldName : properties.keySet()){JSONObject fieldSchema = properties.getJSONObject(fieldName);Object fieldValue = data.get(fieldName);if(fieldValue !=null){validateField(fieldName, fieldValue, fieldSchema, result);}}}}catch(Exception e){ log.error("验证表单数据失败: {}", formKey, e); result.addError("system","表单验证系统错误");}return result;}/** * 验证单个字段 */privatevoidvalidateField(String fieldName,Object value,JSONObject fieldSchema,ValidationResult result){String type = fieldSchema.getString("type");if("string".equals(type)){if(!(value instanceofString)){ result.addError(fieldName, fieldName +" 必须是字符串类型");return;}String strValue =(String) value;// 长度验证if(fieldSchema.containsKey("minLength")){int minLength = fieldSchema.getIntValue("minLength");if(strValue.length()< minLength){ result.addError(fieldName, fieldName +" 长度不能少于 "+ minLength +" 个字符");}}if(fieldSchema.containsKey("maxLength")){int maxLength = fieldSchema.getIntValue("maxLength");if(strValue.length()> maxLength){ result.addError(fieldName, fieldName +" 长度不能超过 "+ maxLength +" 个字符");}}// 格式验证if(fieldSchema.containsKey("pattern")){String pattern = fieldSchema.getString("pattern");if(!strValue.matches(pattern)){ result.addError(fieldName, fieldName +" 格式不正确");}}}// ... 其他类型的字段验证}publicstaticclassValidationResult{privateboolean valid =true;privateMap<String,String> errors =newHashMap<>();publicvoidaddError(String field,String message){ valid =false; errors.put(field, message);}publicbooleanisValid(){return valid;}publicMap<String,String>getErrors(){return errors;}}}
工作流服务
@Service@Slf4jpublicclassWorkflowService{@AutowiredprivateRuntimeService runtimeService;@AutowiredprivateTaskService taskService;/** * 启动审批流程实例 */@TransactionalpublicStringstartProcessInstance(String processKey,String businessKey,Map<String,Object> variables){try{// 启动流程实例ProcessInstance processInstance = runtimeService.startProcessInstanceByKey( processKey, businessKey, variables);String processInstanceId = processInstance.getId(); log.info("启动审批流程实例: {}, 业务键: {}", processInstanceId, businessKey);return processInstanceId;}catch(Exception e){ log.error("启动审批流程实例失败: {}", processKey, e);thrownewRuntimeException("启动审批流程实例失败", e);}}/** * 完成审批任务 */@TransactionalpublicvoidcompleteTask(String taskId,String assignee,Map<String,Object> variables){try{// 设置办理人 taskService.setAssignee(taskId, assignee);// 完成任务 taskService.complete(taskId, variables); log.info("完成审批任务: {}, 办理人: {}", taskId, assignee);}catch(Exception e){ log.error("完成审批任务失败: {}", taskId, e);thrownewRuntimeException("完成审批任务失败", e);}}/** * 提交表单并启动审批流程 */@TransactionalpublicStringsubmitFormWithWorkflow(String formKey,String formData,String submitter){// 1. 提交表单实例FormInstance formInstance = formService.submitFormInstance(formKey, formData, submitter);// 2. 获取表单关联的流程定义FormDefinition formDefinition = formService.getFormDefinition(formKey);if(formDefinition ==null|| formDefinition.getProcessDefinitionKey()==null){thrownewRuntimeException("表单未关联审批流程或表单定义不存在: "+ formKey);}// 3. 启动审批流程Map<String,Object> variables =newHashMap<>(); variables.put("assignee", submitter); variables.put("formInstanceKey", formInstance.getInstanceKey());String processInstanceId =startProcessInstance( formDefinition.getProcessDefinitionKey(), formInstance.getInstanceKey(), variables);return processInstanceId;}}

实际应用案例

让我们以请假审批为例,看看如何在5分钟内配置一套完整的审批流。

第一步:定义表单结构(1分钟)

{"formKey":"leave_app_001","formName":"请假申请","formTitle":"员工请假申请表","formSchema":{"type":"object","properties":{"employeeId":{"type":"string","title":"工号","pattern":"^\\d{6}$","required":true},"employeeName":{"type":"string","title":"姓名","required":true},"leaveType":{"type":"string","title":"请假类型","enum":["年假","病假","事假","婚假","产假"],"enumNames":["年假","病假","事假","婚假","产假"],"required":true},"startTime":{"type":"string","format":"date","title":"开始时间","required":true},"endTime":{"type":"string","format":"date","title":"结束时间","required":true},"reason":{"type":"string","title":"请假事由","maxLength":200}},"required":["employeeId","employeeName","leaveType","startTime","endTime"]},"formUiSchema":{"employeeId":{"ui:widget":"input"},"employeeName":{"ui:widget":"input"},"leaveType":{"ui:widget":"select"},"reason":{"ui:widget":"textarea"}},"processDefinitionKey":"leave_approval_wf"}

第二步:配置审批流程(2分钟)

使用Activiti工作流引擎定义审批流程:

<processid="leave_approval_wf"name="请假审批流程"isExecutable="true"><startEventid="startevent1"name="开始"></startEvent><userTaskid="dept_leader_approve"name="部门领导审批"activiti:assignee="${deptLeader}"><extensionElements><activiti:taskListenerevent="create"class="com.example.listener.TaskCreateListener"/></extensionElements></userTask><exclusiveGatewayid="check_duration"name="请假天数检查"></exclusiveGateway><userTaskid="hr_approve"name="HR审批"activiti:assignee="hr_user"></userTask><endEventid="endevent1"name="结束"></endEvent><sequenceFlowid="flow1"sourceRef="startevent1"targetRef="dept_leader_approve"></sequenceFlow><sequenceFlowid="flow2"sourceRef="dept_leader_approve"targetRef="check_duration"><conditionExpressionxsi:type="tFormalExpression"><![CDATA[${approvalResult == 'approved'}]]></conditionExpression></sequenceFlow><sequenceFlowid="flow3"sourceRef="check_duration"targetRef="hr_approve"><conditionExpressionxsi:type="tFormalExpression"><![CDATA[${duration > 3}]]></conditionExpression></sequenceFlow><sequenceFlowid="flow4"sourceRef="check_duration"targetRef="endevent1"><conditionExpressionxsi:type="tFormalExpression"><![CDATA[${duration <= 3}]]></conditionExpression></sequenceFlow><sequenceFlowid="flow5"sourceRef="hr_approve"targetRef="endevent1"></sequenceFlow></process>

第三步:API调用创建(1分钟)

curl -X POST "http://localhost:8081/api/forms"\ -H "Content-Type: application/json"\ -d '{ "formKey": "leave_app_001", "formName": "请假申请", "formTitle": "员工请假申请表", "formSchema": "...", "formUiSchema": "...", "processDefinitionKey": "leave_approval_wf", "createdBy": "admin" }'

第四步:表单渲染和使用(1分钟)

前端页面只需一行代码即可渲染表单:

<divid="dynamic-form-container"><!-- 从后端API获取渲染后的表单HTML --> ${renderedForm} </div>

核心优势

1. 极致开发效率

  • 配置即开发:通过JSON配置即可完成表单开发
  • 模板复用:相同类型的表单可以复用模板
  • 可视化配置:提供可视化配置界面,业务人员也能参与

2. 强大的扩展性

  • 字段类型丰富:支持文本、数字、日期、选择等多种类型
  • 验证规则灵活:支持必填、长度、格式、范围等多种验证
  • 流程自定义:支持复杂的审批流程配置

3. 降低维护成本

  • 配置驱动:表单修改无需代码发布
  • 版本管理:支持表单定义的版本控制
  • 权限控制:细粒度的权限管理

最佳实践

1. 性能优化

  • 使用Redis缓存表单定义,减少数据库查询
  • 对表单渲染结果进行适当缓存
  • 实现分页查询表单实例

2. 安全考虑

  • 对表单数据进行严格验证
  • 实现操作权限控制
  • 记录操作日志

3. 监控和运维

  • 监控表单提交成功率
  • 跟踪审批流程执行情况
  • 提供管理后台进行配置管理

总结

通过SpringBoot + Low-Code + JSON表单引擎的方案,我们成功实现了5分钟配置一套审批流的目标。这个方案不仅大幅提升了开发效率,还降低了维护成本,让业务人员能够更好地参与到表单和流程的设计中。

在实际项目中,这个方案已经帮助我们:

  • 减少80%的重复开发工作
  • 将表单配置时间从几天缩短到几分钟
  • 提升业务响应速度,增强系统灵活性

低代码不是万能的,但在合适的场景下,它确实能发挥巨大价值。希望这个方案能对大家有所帮助,让我们一起告别重复的CRUD开发!


服务端技术精选 - 专注后端技术分享,与你一起成长!

Read more

把 AI 小助手接入企业微信:用一个回调接口做群聊机器人实战篇

你也许已经有了一个「看起来还挺像样」的 AI 小助手服务,比如: * 有 HTTP 接口 /v1/chat; * 能识别不同 Skill(待办、日报、FAQ 等); * 甚至已经有网页版前端。 但现实是:同事们每天真正打开的是企业微信,很少会专门去打开一个新网页跟机器人聊天。 这篇文章就做一件很实用的小事: 在不动你现有 AI 服务核心逻辑的前提下, 用一个企业微信“回调接口”, 把它变成「群聊里的 @ 机器人」。 一、整体思路:后端不重写,只加一层「翻译器」 假设你现在的 AI 服务长这样: * 接口:POST /v1/chat 返回: { "answer": "上午开会,下午写代码……"

By Ne0inhk

大疆无人机固件自由下载工具:DankDroneDownloader完整使用指南

大疆无人机固件自由下载工具:DankDroneDownloader完整使用指南 【免费下载链接】DankDroneDownloaderA Custom Firmware Download Tool for DJI Drones Written in C# 项目地址: https://gitcode.com/gh_mirrors/da/DankDroneDownloader 你是否曾经为无法获取大疆无人机历史固件版本而烦恼?当厂商移除旧版固件后,你就失去了选择权。DankDroneDownloader正是为解决这一痛点而生,让你重新掌握无人机固件的下载自由。 什么是DankDroneDownloader? DankDroneDownloader是一款专为大疆无人机设计的定制固件下载工具,基于C#和.NET 9.0框架开发。它打破了厂商对固件版本的限制,让你能够自由下载任意历史版本的固件。 核心优势: * 完整的历史固件版本库 * 简洁易用的用户界面 * 支持Windows应用程序直接运行 * 优化的应用体积和性能 为什么需要DankDroneDownloader

By Ne0inhk
Pico 4XVR 1.10.13安装包下载与安装教程 ico 4XVR最新版下载、4XVR 1.10.13 APK安装包、Pico VR看电影软件、4XVR完整版安装教程、Pico 4播放器推荐、V

Pico 4XVR 1.10.13安装包下载与安装教程 ico 4XVR最新版下载、4XVR 1.10.13 APK安装包、Pico VR看电影软件、4XVR完整版安装教程、Pico 4播放器推荐、V

Pico 4XVR 1.10.13安装包下载与安装教程 SEO关键词:Pico 4XVR最新版下载、4XVR 1.10.13 APK安装包、Pico VR看电影软件、4XVR完整版安装教程、Pico 4播放器推荐、VR本地播放器APK 最近在折腾 Pico 设备本地观影方案时,测试了不少播放器,最终还是回到 4XVR。作为一个开发工程师,我对播放器的解码能力、格式兼容性、播放流畅度比较敏感。实测下来,4XVR 在高码率视频、蓝光原盘播放方面表现确实稳定。 这篇文章整理一下 Pico 4XVR 最新版 1.10.13 的版本信息、下载方式以及安装流程,方便需要的朋友自行安装测试。 一、版本信息说明 * 软件名称:4XVR * 版本号:1.10.

By Ne0inhk
AI小白也能快速用五分钟复现的ERNIE-4.5系列模型单卡部署与心理健康机器人实战案例

AI小白也能快速用五分钟复现的ERNIE-4.5系列模型单卡部署与心理健康机器人实战案例

* 本文重点在于文心大模型的微调 * 一起来轻松玩转文心大模型吧👉一文心大模型免费下载地址: https://ai.gitcode.com/theme/1939325484087291906 计算机配置 * 在国内部署选个自带CUDA的会快一点,不自带还得去NVIDIA下载,而其提供的CUDA依赖需要科学上网才能下载快。换阿里清华源也没用。 * 文心模型汇总 环境配置与部署 1. 更换镜像源(使用阿里云镜像源): sudo cp /etc/apt/sources.list /etc/apt/sources.list.bak sudo sed -i 's|http://archive.ubuntu.com/ubuntu|http://mirrors.aliyun.com/ubuntu|g' /etc/apt/sources.

By Ne0inhk