Files
dacli/docs/web-patches/_codegen-ServiceImpMarco-virtual-field.md
T
2026-07-17 12:20:48 +08:00

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, 因改的是后端模板)