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
@@ -1,14 +1,12 @@
package com.nanri.aiimage.modules.dedupe.mapper;
import com.baomidou.mybatisplus.core.MybatisConfiguration;
import com.nanri.aiimage.modules.dedupe.model.entity.DedupeTotalDataEntity;
import org.apache.ibatis.builder.annotation.MapperAnnotationBuilder;
import com.nanri.aiimage.testutil.MapperXmlSupport;
import org.apache.ibatis.mapping.BoundSql;
import org.apache.ibatis.mapping.MappedStatement;
import org.apache.ibatis.session.Configuration;
import org.junit.jupiter.api.Test;
import java.lang.reflect.Method;
import java.util.List;
import java.util.Map;
@@ -22,7 +20,7 @@ import static org.junit.jupiter.api.Assertions.assertTrue;
* <p>为什么必须单独有一支:服务层测试用 mock 捕获的是实体对象,看不到最终 SQL——本表写侧
* 靠的是注解里的列清单(不是 MyBatis-Plus 的实体字段推导),把 {@code company_id} 从清单里漏掉
* 或把 {@code #{row.companyId}} 写成 {@code ${...}} 都是"SQL 变了而 service 测试照样绿"。
* 走 {@code MapperAnnotationBuilder} 解析注解、向真 {@code BoundSql} 断言,
* 走真 {@code XMLMapperBuilder} 解析 mapper XML、向真 {@code BoundSql} 断言,
* 口径照抄 {@code ShopDataDuplicateCheckCompanyScopeTest#boundSqlFor}。</p>
*/
class DedupeTotalDataMapperSqlTest {
@@ -46,11 +44,10 @@ class DedupeTotalDataMapperSqlTest {
}
private static BoundSql boundSqlFor(int rowCount) throws Exception {
Method method = DedupeTotalDataMapper.class.getMethod("insertBatchIgnore", List.class);
String script = String.join(" ", method.getAnnotation(org.apache.ibatis.annotations.Insert.class).value());
assertTrue(script.contains("company_id"), "注解原文应含 company_id(生成 SQL 才可能含): " + script);
Configuration configuration = new MybatisConfiguration();
new MapperAnnotationBuilder(configuration, DedupeTotalDataMapper.class).parse();
// SQL 已从注解迁到 mapper XML(档 B 口径),原文与语句都要从 XML 那侧取
String script = MapperXmlSupport.statementBody(DedupeTotalDataMapper.class, "insertBatchIgnore");
assertTrue(script.contains("company_id"), "XML 语句体应含 company_id(生成 SQL 才可能含): " + script);
Configuration configuration = MapperXmlSupport.configurationWith(DedupeTotalDataMapper.class);
MappedStatement statement = configuration.getMappedStatement(
DedupeTotalDataMapper.class.getName() + ".insertBatchIgnore");
List<DedupeTotalDataEntity> rows = new java.util.ArrayList<>(rowCount);
@@ -3,10 +3,11 @@ package com.nanri.aiimage.modules.notification.service;
import com.nanri.aiimage.common.service.DistributedJobLockService;
import com.nanri.aiimage.config.NotificationProperties;
import com.nanri.aiimage.modules.notification.mapper.UserNotificationMapper;
import org.apache.ibatis.annotations.Delete;
import com.nanri.aiimage.testutil.MapperXmlSupport;
import org.junit.jupiter.api.Test;
import org.mockito.ArgumentCaptor;
import java.io.IOException;
import java.time.Duration;
import java.time.LocalDateTime;
import java.util.List;
@@ -153,13 +154,10 @@ class NotificationRetentionServiceTest {
private static String deleteSqlOf(String methodName) {
try {
Delete delete = UserNotificationMapper.class
.getMethod(methodName, LocalDateTime.class, int.class)
.getAnnotation(Delete.class);
assertThat(delete).as("%s 上的 @Delete 注解", methodName).isNotNull();
return String.join(" ", delete.value());
} catch (NoSuchMethodException ex) {
throw new AssertionError(ex);
// SQL 已在 mapper XML 里(档 B 口径),取原文的入口跟着换到 XML 侧
return MapperXmlSupport.statementBody(UserNotificationMapper.class, methodName);
} catch (IOException | RuntimeException ex) {
throw new AssertionError(methodName + " 的 DELETE 语句在 mapper XML 里取不到", ex);
}
}
}
@@ -8,16 +8,13 @@ import static org.mockito.Mockito.never;
import static org.mockito.Mockito.verify;
import static org.mockito.Mockito.when;
import com.baomidou.mybatisplus.core.MybatisConfiguration;
import com.nanri.aiimage.modules.shopduplicatecheck.TestFixtures;
import com.nanri.aiimage.modules.shopduplicatecheck.mapper.ShopDuplicateCheckSourceMapper;
import java.lang.reflect.Method;
import com.nanri.aiimage.testutil.MapperXmlSupport;
import java.util.Arrays;
import java.util.List;
import java.util.Map;
import java.util.Set;
import org.apache.ibatis.annotations.Select;
import org.apache.ibatis.builder.annotation.MapperAnnotationBuilder;
import org.apache.ibatis.mapping.BoundSql;
import org.apache.ibatis.mapping.MappedStatement;
import org.apache.ibatis.session.Configuration;
@@ -166,13 +163,9 @@ class ShopDataDuplicateCheckCompanyScopeTest {
}
private static BoundSql boundSqlFor(List<Long> memberIds) throws Exception {
Method method = ShopDuplicateCheckSourceMapper.class
.getMethod("selectShopNamesOwnedBy", List.class);
String script = String.join(" ", method.getAnnotation(Select.class).value());
Configuration configuration = new MybatisConfiguration();
// 走注解构建器的同一条路径:把这条语句注册进 configuration,再向它要 BoundSql
new MapperAnnotationBuilder(configuration, ShopDuplicateCheckSourceMapper.class)
.parse();
// SQL 已迁进 mapper XML:addMapper()/MapperAnnotationBuilder 都拿不到它,
// 必须用 MapperXmlSupport 把接口与同名 XML 一起装进配置。
Configuration configuration = MapperXmlSupport.configurationWith(ShopDuplicateCheckSourceMapper.class);
MappedStatement statement = configuration.getMappedStatement(
ShopDuplicateCheckSourceMapper.class.getName() + ".selectShopNamesOwnedBy");
return statement.getBoundSql(Map.of("memberIds", memberIds));
@@ -1,11 +1,13 @@
package com.nanri.aiimage.modules.taskcenter.mapper;
import com.baomidou.mybatisplus.core.MybatisConfiguration;
import com.nanri.aiimage.testutil.MapperXmlSupport;
import org.apache.ibatis.mapping.BoundSql;
import org.apache.ibatis.mapping.MappedStatement;
import org.junit.jupiter.api.BeforeAll;
import org.junit.jupiter.api.Test;
import java.io.IOException;
import java.time.LocalDateTime;
import java.util.HashMap;
import java.util.List;
@@ -28,9 +30,10 @@ class TaskCenterQueryMapperSqlTest {
private static MybatisConfiguration configuration;
@BeforeAll
static void setUp() {
configuration = new MybatisConfiguration();
configuration.addMapper(TaskCenterQueryMapper.class);
static void setUp() throws IOException {
// 2026-10-08 SQL 迁进 mapper XML:addMapper() 只会装 BaseMapper 的内置方法,
// 自定义语句必须由 MapperXmlSupport 把同名 XML 一起装进来。
configuration = MapperXmlSupport.configurationWith(TaskCenterQueryMapper.class);
}
private static BoundSql render(String method, Map<String, Object> params) {