refactor(SQL分层): 剩余 85 条注解 SQL 全量迁进 mapper XML,等价性改由 MyBatis 自己判

96 条语句现在全在 src/main/resources/mapper/<模块>/ 下,注解侧 SQL 归零;判据从"基线清单"
改成完成态(逐接口必须为 0 + XML 语句总数 96 + 反向钉:XML 有则注解必须无)。

搬法上踩实了一个坑:注解参数是 Java 表达式("…" + CLIENT_MODULE_TYPES + "…"),
用只认字面量的抽取器搬家会把常量整段吞掉——上一轮生成的 26 份 XML 里因此出现
IN ()、AS status 前面没有表达式(MySQL 语法错),<script> 形态还被多转义一次变成 &amp;lt;。
更糟的是当时"搬迁前快照"与 XML 由同一个抽取器产出,两边一起错所以逐字比对全绿,
抓到现场的是既有的语义用例(TaskCenter 15 条 + 店铺查重那条断 <> 的)。

所以 MigratedSqlEquivalenceTest 改成:账本存注解原文,Java 侧现场用
getDefaultScriptingLanguageInstance().createSqlSource 编译原文,与 XML 解析出的
MappedStatement 各渲染一遍 BoundSql 对撞(空参数 + foreach 喂满 2 元素各一次),
转义对不对由 MyBatis 判定而不是由生成器判定;账本自己再钉 <script>/<if> 成对、不许出现 IN ()。
resultType 那一支不变:期望值由接口签名反射反推,66 条分母钉住。

取数入口跟着换:6 支原本读 @Select 注解的守卫(TaskCenter/Dedupe/店铺查重/通知保留/
鉴权形状/后台扩权)改走 MapperXmlSupport,断言内容一字未动;后台扩权那条"不许有 wrapper
投影"从全文 doesNotContain(".select(") 改成只扫可执行行——接口里现在只剩签名,
而 javadoc 正写着"别用 selectList(.select(...))",全文判会被自己的注释喂饱。

隔离树全量 4059 例 0 红(基线 4054,+5 为新增等价性与 XML 用例)。这批要生效得随下一版 jar 发版。
This commit is contained in:
2026-10-08 12:00:43 +08:00
parent 4d2f3fc754
commit 419ab3be64
62 changed files with 1490 additions and 890 deletions
@@ -3,6 +3,9 @@ package com.nanri.aiimage.common.security;
import static org.assertj.core.api.Assertions.assertThat;
import static org.assertj.core.api.Assertions.fail;
import com.nanri.aiimage.common.mapper.AdminUserMapper;
import com.nanri.aiimage.testutil.MapperXmlSupport;
import java.io.IOException;
import java.nio.charset.StandardCharsets;
import java.nio.file.Files;
@@ -76,13 +79,15 @@ class AuthChainQueryShapeTest {
assertThat(service).doesNotContain("selectList(");
String mapper = read(sourceNamed("AdminUserMapper.java"));
Matcher method = Pattern.compile(
"LocalDateTime selectCompanySuperAdminEarliestExpiry\\([\\s\\S]{0,400}").matcher(mapper);
assertThat(method.find()).as("mapper 里那个标量方法还在").isTrue();
assertThat(mapper).contains("MIN(expires_at)");
assertThat(mapper).contains("LocalDateTime selectCompanySuperAdminEarliestExpiry(");
// 2026-10-08 SQL 迁进 mapper XML:断言内容一字未动,取文本的入口换到语句体本身。
// 顺带去掉原来那个「方法名起 400 字符」的定宽窗口——它会截错,也会因上面多一行注释而失明。
String sql = MapperXmlSupport.statementBody(AdminUserMapper.class,
"selectCompanySuperAdminEarliestExpiry");
assertThat(sql).contains("MIN(expires_at)");
// 判据必须仍锁死在"本公司 + 公司超管",扩到全站会把别家的到期算进这家
assertThat(mapper).contains("role = 'company_super_admin'");
assertThat(mapper).contains("company_id = #{companyId}");
assertThat(sql).contains("role = 'company_super_admin'");
assertThat(sql).contains("company_id = #{companyId}");
}
private static List<Path> scannedSources() throws IOException {
@@ -3,6 +3,9 @@ package com.nanri.aiimage.common.security;
import static org.assertj.core.api.Assertions.assertThat;
import static org.assertj.core.api.Assertions.fail;
import com.nanri.aiimage.common.mapper.AdminUserMapper;
import com.nanri.aiimage.testutil.MapperXmlSupport;
import java.io.IOException;
import java.nio.charset.StandardCharsets;
import java.nio.file.Files;
@@ -214,14 +217,20 @@ class ConsoleWideningGuardrailTest {
String mapper = read(mainSource("common/mapper/AdminUserMapper.java"));
int at = mapper.indexOf("Long countAdminMenuGrants(");
assertThat(at).as("入口探针方法还在").isGreaterThan(0);
String head = mapper.substring(Math.max(0, at - 400), at);
assertThat(head).contains("SELECT COUNT(1)");
assertThat(head).doesNotContain(".select(");
// 探针必须仍限定本公司:否则别家公司的授权能给这条账号开门
assertThat(head).contains("cm.company_id");
assertThat(head).contains("ucp.user_id = #{userId}");
assertThat(head).contains("cm.menu_type = 'admin'");
assertThat(mapper.substring(at)).contains("@Param(\"companyId\")");
// 2026-10-08 SQL 迁进 mapper XML:断言内容一字未动,只把取文本的入口换到语句体本身,
// 顺带去掉"方法名前 400 字符"那个定宽窗口(会截错,也会因注释变长而失明)。
String sql = MapperXmlSupport.statementBody(AdminUserMapper.class, "countAdminMenuGrants");
assertThat(sql).contains("SELECT COUNT(1)");
// 探针必须仍限定本公司:否则别家公司的授权能给这条账号开门
assertThat(sql).contains("cm.company_id");
assertThat(sql).contains("ucp.user_id = #{userId}");
assertThat(sql).contains("cm.menu_type = 'admin'");
// 接口侧不许出现 wrapper 投影写法。SQL 搬进 XML 后接口只剩签名与 javadoc,
// 而 javadoc 里就写着「别用 selectList(.select(columnId))」这段教训——只扫可执行行,
// 否则这条断言会被自己的注释喂饱(注释越长越像"有问题",那不是它该管的事)。
assertThat(executableLinesContaining(mapper, ".select("))
.as("mapper 源码读到了(上面 indexOf 已证),这里必须是零命中").isEmpty();
}
/** 自检:扫描面与两个分母都必须是实打实的非空,且页面门/豁免恰好铺满入口门清单。 */