问题从哪里来
在企业应用选型时,经常会遇到这样的争论:某个基于 Spring Boot + Vue 的项目,到底算“开发框架”还是“低代码平台”?有人认为只要还要写 Java 就是框架,也有人认为能在页面上配出增删改查就是低代码。
这两种说法都只看到了一面。框架和平台的根本区别不在于“写不写代码”,而在于业务逻辑在什么时候、以什么形式确定下来:
- 开发框架在编译期确定业务:开发者写代码(或用工具生成代码),代码编译打包后,功能才固定下来;
- 低代码平台在运行期确定业务:业务描述以元数据形式存放在数据库里,由一套通用引擎在请求到来时解析执行。
理解了这个分界,再看很多产品“既能配置又能写代码”的双层结构,就不难判断它们各自的适用范围。下面分几个层面拆开来看。
开发框架层:脚手架与代码生成器
典型的 Java 企业级开发框架,一般由三部分组成:
- 前后端分离的工程骨架:后端 Spring Boot 加 MyBatis(或 MyBatis-Plus),前端 Vue3 加组件库,二者通过 RESTful 接口和 JWT 等令牌机制交互;
- 通用基础模块:用户、角色、部门、菜单、数据字典、定时任务、消息中心、按钮权限和数据权限等,几乎每个管理系统都要用到;
- 代码生成器:根据数据库表结构和模板,批量生成分层代码。
代码生成器的原理并不复杂:读取表的元信息(字段名、类型、长度、是否为空、注释),映射成 Java 类型和前端控件类型,再交给 FreeMarker、Velocity 这类模板引擎渲染。一张表通常会生成以下文件:
entity/Equipment.java 实体类,字段与表列一一对应
mapper/EquipmentMapper.java 数据访问层接口
mapper/xml/EquipmentMapper.xml SQL 映射
service/IEquipmentService.java 服务接口
service/impl/EquipmentServiceImpl.java
controller/EquipmentController.java REST 接口
views/equipment/EquipmentList.vue 列表页
views/equipment/EquipmentModal.vue 表单弹窗
比较成熟的生成器支持单表、树表、一对多主子表等模型,提供多套页面风格模板,也允许团队维护自己的模板。
生成器的本质是“一次性的代码复制”。代码生成之后就和普通手写代码没有区别:可以随意修改、调试、做代码评审,也要走编译、测试、发布流程。它节省的是写重复样板代码的时间,并不改变软件的交付方式。
低代码平台层:元数据驱动与运行时解析
低代码平台走的是另一条路。以在线表单为例,用户在页面上新建一张“设备台账”表,配置这样几个字段:
| 字段 | 控件 | 说明 |
|---|---|---|
| 设备名称 | 文本框 | 必填 |
| 设备类型 | 下拉框 | 绑定数据字典 |
| 所属部门 | 部门选择 | 关联组织架构 |
| 采购日期 | 日期 | |
| 采购金额 | 数值 | 金额校验 |
| 设备照片 | 图片 | 上传到本地或对象存储 |
这些配置不会变成 Java 类,而是保存为几张元数据表中的记录:表头信息(表名、表类型、主子关系)、字段信息(列名、类型、控件、校验规则、字典编码、是否列表显示、是否查询条件)、按钮和权限信息。为了便于理解,可以把一份字段元数据抽象成下面这样的结构(示意,非某个产品的真实格式):
{
"tableName": "equipment",
"tableType": "single",
"fields": [
{
"name": "name", "dbType": "varchar(100)", "widget": "text", "required": true, "query": true },
{
"name": "type", "dbType": "varchar(32)", "widget": "select", "dict": "equipment_type" },
{
"name": "amount", "dbType": "decimal(10,2)", "widget": "number", "rule": "money" }
]
}
配置完成后,平台通常会提供一个“同步数据库”的动作,根据元数据执行 DDL 建出物理表。之后的运行过程大致如下:
- 前端请求某张表的配置,通用的列表页和表单组件根据字段元数据动态渲染出列表列、查询条件和录入控件;
- 用户提交查询或保存,请求进入一个通用的 CRUD 接口,后端根据表名读取元数据,动态拼装带参数绑定的 SQL 并执行;
- 分页、导入导出、必填与格式校验、字典翻译、数据权限过滤,都由引擎统一实现,不需要为每张表单独开发。
这就是“元数据驱动”的含义:新增一个业务模块,相当于往元数据表里插几条记录,不需要编译,也不需要重启服务。修改字段、调整查询条件,改完立即生效。
在线报表的思路相同。用户写一段查询 SQL:
select depart, count(*) as total
from equipment
group by depart
平台解析 SQL 的结果集,得到字段列表,再由用户配置显示名称、查询条件和字典,运行时把查询参数拼接进 SQL 执行,输出分页列表并支持导出。同一份 SQL 的结果集也可以交给图表组件,渲染成柱状图、折线图或饼图。报表设计器、大屏设计器则把这一思路推向可视化排版:数据集加单元格绑定,或数据集加图表组件的坐标布局。
流程引擎则是另一类运行时解析。BPMN 流程图以 XML 形式部署到 Flowable、Activiti 这类引擎中,节点、审批人、分支条件都在运行时求值。表单配合流程,构成了 OA 审批类应用的基础。
两种模式的技术差异
把两种模式放在一起对比,差异主要集中在以下几点:
| 维度 | 开发框架 + 代码生成 | 元数据驱动的低代码 |
|---|---|---|
| 业务确定时机 | 编译期 | 运行期 |
| 变更方式 | 改代码、构建、发布 | 改配置,即时生效 |
| 灵活性 | 不受限制 | 受引擎能力边界约束 |
| 性能调优 | 可针对每条 SQL 优化 | 依赖引擎的通用实现 |
| 调试与测试 | 断点、单元测试、代码评审 | 主要依赖功能预览,可测试性较弱 |
| 版本管理 | Git 天然支持 | 需要额外导出、比对元数据 |
| 上手门槛 | 需要 Java、Vue 开发能力 | 熟悉业务和基本数据库概念即可 |
可以看出,两者并不是谁替代谁的关系。元数据驱动换来了速度和低门槛,代价是灵活性、可测试性和版本管理上的不便;代码模式正好相反。
不写代码能覆盖到什么程度
在一个能力比较完整的元数据平台上,以下需求基本可以只靠配置完成:
- 单表、树表、一对一、一对多主子表的增删改查,比如“采购合同 + 付款计划”这样的主子结构;
- 列表分页、组合查询、Excel 导入导出、常用字段校验;
- 字典下拉、部门和用户选择、图片与附件上传;
- 基于 SQL 的统计报表、统计图表,以及拖拽设计的打印模板、数据大屏;
- 菜单配置、角色权限、按钮权限,以及行级、列级的数据权限。
粗略地说,“以录入、查询、统计为主,规则可以用字段级配置描述”的模块,是配置模式最擅长的领域。企业内部大量的台账、登记、基础资料维护类功能都属于这一类。
哪里必须写代码
一旦遇到下面这些情况,配置就很难表达,必须回到代码:
- 复杂事务:一次提交要同时更新多张表、扣减库存、生成凭证,并保证一致性;
- 跨表计算和状态机:订单状态流转、多级价格计算、依赖历史数据的规则;
- 外部系统集成:对接 ERP、财务、MES,涉及接口鉴权、重试、幂等和异步消息;
- 性能敏感的场景:大数据量查询需要专门的索引、缓存或分库分表策略;
- 特殊交互:通用表单组件之外的自定义页面、复杂的前端交互。
这些需求的共同点是:逻辑无法用“字段 + 规则”的扁平结构描述,需要真正的程序控制流。
增强扩展:介于配置与代码之间
为了缩小“配置能做的”和“必须写代码的”之间的鸿沟,很多元数据平台提供了“增强”机制,常见的有三种:
JS 增强:在表单配置中保存一段前端脚本,平台渲染页面时将其注入到表单的生命周期钩子里,例如加载后、字段值变化时、提交前。它适合做字段联动、动态显隐、前端校验、自定义按钮的点击行为。原理上相当于在通用组件中预留了扩展点,脚本在运行时被动态执行。
SQL 增强:给某个按钮或某个操作(新增、编辑、删除后)绑定一段 SQL,引擎执行完主操作后,用当前记录的字段值替换 SQL 中的占位变量再执行。适合做简单的数据回写,例如保存明细后更新主表合计金额。
Java 增强:平台定义一个扩展接口,开发者编写实现类(以 Spring Bean 或类全路径的形式注册),并在配置中指定在哪个操作的前后调用。引擎在执行增删改或导入导出时,按配置找到对应的实现并调用,开发者在其中可以拿到当前数据,做校验、修改或调用其他服务。
一个通用的增强接口,形态大致如下(示意):
public interface FormEnhance {
/**
* @param tableName 当前表名
* @param record 当前提交的数据,可在方法内修改
*/
void execute(String tableName, Map<String, Object> record);
}
需要注意,增强代码本质上依然是代码,只是“挂”在了配置上。使用时要注意三个问题:脚本和 SQL 存在数据库里,不在 Git 版本控制中,容易成为维护盲区;SQL 增强要防范拼接带来的注入风险;Java 增强仍然需要编译和部署,只是不用改动通用引擎。增强适合处理“配置差一点”的场景,如果一个模块的增强代码越写越多,就说明它已经不适合继续留在配置模式里了。
两层结构:从配置到代码的迁移路径
成熟的方案一般不会让团队二选一,而是把两层放进同一个系统里:标准模块在线配置,复杂模块生成代码后手工开发。例如某开源项目 JeecgBoot 采用“在线配置 → 代码生成 → 手工合并”的思路:在线表单的表模型可以直接交给代码生成器,产出标准的 Controller、Service、Mapper、Entity 和 Vue 页面,开发者再在生成的代码上补充业务逻辑。
这种设计的关键在于同一份元数据可以双向使用:既能被运行时引擎解析,也能作为代码生成的输入。于是一个模块可以先以配置的形式快速上线、验证需求,等业务复杂到一定程度,再“降级”为普通代码继续维护,而不需要推倒重来。两种模块共用同一套用户体系、权限模型和数据源,对终端用户来说没有区别。
迁移时有两点需要提前想清楚:一是从配置转成代码后,原来的在线配置应该停用,避免两份定义同时存在、互相覆盖;二是迁移后的代码不再享有配置模式的即时生效能力,后续变更要走正常的发布流程。
团队该用哪种模式
判断时可以从以下几个问题入手:
- 团队里有没有能维护 Java 和 Vue 代码的人? 没有的话,配置模式之外的部分都无人能接手,应优先考虑纯配置、注册即用的零代码产品;有的话,双层结构的收益才能发挥出来。
- 业务里“标准表单类”功能占多大比例? 如果大部分是台账、登记、报表,配置模式能明显缩短交付周期;如果大部分是复杂交易和系统集成,直接用框架加代码生成更合适。
- 对部署和数据有什么要求? 需要私有化部署、对接国产数据库、多数据源或多租户的场景,要确认平台底座对这些能力的支持程度。
- 变更频率如何? 需求频繁变化、需要业务人员自己调整字段和报表的场景,运行时配置的价值最大;需求稳定且性能要求高的核心系统,代码模式更可控。
- 能否接受元数据的治理成本? 配置越多,越需要建立元数据的导出、备份和环境同步机制,否则测试环境和生产环境之间的差异会越来越难以追踪。
一个比较务实的做法是:先用配置模式承接标准化模块,设定清晰的“退出条件”,例如增强脚本超过一定规模、出现跨表事务或外部集成时,就把该模块转为代码开发。
总结
开发框架与低代码平台的边界,本质上是“编译期确定业务”与“运行期解析元数据”的区别。代码生成器属于前者,它只加快写代码的速度;在线表单、在线报表、流程引擎属于后者,它们用通用引擎替代了逐个模块的开发。增强机制则在两者之间提供了一层缓冲。
对于有开发能力的团队,比较合理的架构是两层并存:标准模块交给配置,复杂业务回到代码,并且保留从配置平滑迁移到代码的路径。选型时与其纠结“它算框架还是平台”,不如先看清自己的业务里有多少可以被元数据描述,又有多少必须交给程序控制。