6.8 KiB
Patch: _codegen-ServiceImpMarco-virtual-field — codegen 虚拟字段 null 守卫
状态: ✅ 已应用 (2026-06-23, 单点修复)
对应文件: boot/resources/TemplateCodeVue3/PublicMacro/ServiceImpMarco.vm
基线文件: jnpf/静态资源/jnpf-resources/TemplateCodeVue3/PublicMacro/ServiceImpMarco.vm
⚠ 特例说明: 本目录通常只记录
web/.../src/**前端源码改造。本 patch 是 boot 端 Velocity 模板修改, 是 web-patches 体系的特例 (改动被 JNPF 升级覆盖的风险与 web 端等同). 按用户要求归档在此.
改动原因
dacli form codegen 用 Velocity 模板生成后端 Java + 前端 Vue 代码。
Bug 现象
当表单字段被勾选进 searchList (搜索条件) 但不在主表 (即"虚拟字段", 比如关联副表的查询条件), 模板里的 SearchTypeModel.afterVModel 和 Field.fieldAlias 为 null.
原模板无脑引用:
#set($vModelName = "${SearchTypeModel.afterVModel}")
...
#set($fieldName = "${vModelName.substring(0,1).toUpperCase()}${vModelName.substring(1)}")
Velocity 对 ${null} 的处理是输出字面字符串 ${SearchTypeModel.afterVModel.substring(0,1).toUpperCase()} 到生成的 .java 文件里 → javac 编译失败 (非法语法 get${SearchTypeModel.afterVModel.substring(0,1).toUpperCase()}()).
修复思路
虚拟字段没有对应的 Java getter / 字段, 生成代码无意义 → 直接整个字段跳过, 不输出 if(ObjectUtil.isNotEmpty(...)) 块.
实际改动 (2 处空值守卫)
改动 1: #macro(PaginationQuery ...) 块 (~第 143 行)
#foreach($SearchTypeModel in ${searchListSizes})
- #set($vModelName = "${SearchTypeModel.afterVModel}")
- #set($fieldAliasName = "${SearchTypeModel.afterVModel}")
- #set($tableAliasName = "${SearchTypeModel.tableAliasName}")
- #if($SearchTypeModel.id.contains("_jnpf_"))
- #set($fieldAliasName = "jnpf_${tableAliasName}_jnpf_${vModelName}")
- #elseif($SearchTypeModel.id.toLowerCase().startsWith("tablefield"))
- #set($fieldAliasName = "${tableAliasName}_${vModelName}")
+ ## ⚠ 2026-06-23 bug fix: SearchTypeModel.afterVModel 在虚拟字段 (searchList 但不在主表) 时为 null.
+ ## 原代码 #set($vModelName = "${SearchTypeModel.afterVModel}") 会输出字面 "${SearchTypeModel.afterVModel}"
+ ## 然后 $vModelName.substring(...) 输出字面, 最终生成 .java 含 get${SearchTypeModel.afterVModel.substring(...)}() 非法语法.
+ ## 修复: afterVModel 空时跳过该字段 (虚拟字段无对应 getter, 不生成查询代码).
+ #if("$!{SearchTypeModel.afterVModel}" == "")
+ #set($_skip = true)
+ #else
+ #set($_skip = false)
+ #set($vModelName = "${SearchTypeModel.afterVModel}")
+ #set($fieldAliasName = "${SearchTypeModel.afterVModel}")
+ #set($tableAliasName = "${SearchTypeModel.tableAliasName}")
+ #if($SearchTypeModel.id.contains("_jnpf_"))
+ #set($fieldAliasName = "jnpf_${tableAliasName}_jnpf_${vModelName}")
+ #elseif($SearchTypeModel.id.toLowerCase().startsWith("tablefield"))
+ #set($fieldAliasName = "${tableAliasName}_${vModelName}")
+ #end
+ #set($fieldName = "${vModelName.substring(0,1).toUpperCase()}${vModelName.substring(1)}")
+ #set($paginationName ="${fieldAliasName.substring(0,1).toUpperCase()}${fieldAliasName.substring(1)}")
#end
- #set($fieldName = "${vModelName.substring(0,1).toUpperCase()}${vModelName.substring(1)}")
- #set($paginationName ="${fieldAliasName.substring(0,1).toUpperCase()}${fieldAliasName.substring(1)}")
+ #if(!$_skip)
if(ObjectUtil.isNotEmpty(${name}Pagination.get${paginationName}())){
...
}
+
+ #end
#end
改动 2: 字段循环块 (~第 585 行)
#set($vModel = ${Field.vModel})
-#set($upName = "${Field.fieldAlias.substring(0,1).toUpperCase()}${Field.fieldAlias.substring(1)}")
+## ⚠ 2026-06-23 bug fix: fieldAlias 在虚拟字段 (searchList 但不在主表) 时为空,
+## 原代码无条件 substring(0,1).toUpperCase() 会输出字面 ${Field.fieldAlias.substring(0,1).toUpperCase()}
+## 导致 .java 文件含非法 Java 语法, javac 失败.
+## 修复: fieldAlias 为空时整个字段跳过 (虚拟字段无对应 Java 字段/getter, 生成代码无意义)
+#if("$!{Field.fieldAlias}" != "")
+ #set($upName = "${Field.fieldAlias.substring(0,1).toUpperCase()}${Field.fieldAlias.substring(1)}")
#if($jnpfKey == 'input' && ...)
...
#end
## 正则判断
#RegMethod($jnpfKey,"form.get${upName}()",$config)
+#end
#end
验收方法
1. 比对基线 vs 项目
diff -q ./jnpf/静态资源/jnpf-resources/TemplateCodeVue3/PublicMacro/ServiceImpMarco.vm \
./boot/resources/TemplateCodeVue3/PublicMacro/ServiceImpMarco.vm
# 期望: 输出 "differ" (补丁在)
# 期望空输出: 补丁丢了, 需重应用
2. 端到端 codegen 验证 (含 searchList 虚拟字段)
# 准备一张表单, 主表只有 [f_name], 但 searchList 里加一个副表字段 [f_dept_name]
# 跑 codegen
dacli form codegen <formId> --module=<app> --mainClassName=<Entity>
# 期望:
# - 生成的 ServiceImpl.java 可 javac 编译
# - 不含字面 ${SearchTypeModel.afterVModel.substring(...)} 或类似非法语法
# - 虚拟字段不出现在 if(ObjectUtil.isNotEmpty(getXxx())) 块里
3. 跑 baseline 验证 codegen 没回归
SKIP_PLAYWRIGHT=1 bash .claude/skills/dacli/examples/baseline/all.sh
# 期望: 0 错误, codegen 相关 baseline 全 PASS
JNPF 升级后如何重应用
JNPF 平台 release 后:
# 1. 对比基线 (升级后的 jnpf-resources) vs 项目 (boot/resources)
diff -rq ./jnpf/静态资源/jnpf-resources/TemplateCodeVue3/PublicMacro/ServiceImpMarco.vm \
./boot/resources/TemplateCodeVue3/PublicMacro/ServiceImpMarco.vm
# 期望: "differ" → 补丁还在
# 2. 如果基线已修复 (升级后模板自身已加 null 守卫):
# - boot 端可删除补丁, 保持和基线一致
# - 更新本文档状态为 "✅ 已合并到基线 (vX.Y.Z+)"
# 3. 如果基线未修复 (仍存在 null 引用):
# - 补丁仍需保留
# - 检查改动 1/2 的宏结构是否还匹配 (JNPF 升级可能改写 #macro 结构 → 重应用)
不需要做的事
- ❌ 不要改
jnpf/静态资源/jnpf-resources/TemplateCodeVue3/PublicMacro/ServiceImpMarco.vm(基线只读) - ❌ 不要在 dacli 端 (
dacli/src/commands/codegen/) 重复实现模板守卫, 应在 Velocity 模板层修 - ❌ 不要把这个守卫抽成通用工具函数 (
#macroNullGuard), 一次 bug 修一处即可, 避免过度抽象
相关链接
- 镜像架构:
dacli/docs/architecture-philosophy.md(模板层修复优先, 不在调用层打补丁) - CI 关卡 G:
dacli/src/commands/_gate_webapi.ts(本 patch 不直接走 CI G, 因改的是后端模板)