package com.nanri.aiimage; import com.baomidou.mybatisplus.core.MybatisConfiguration; import org.apache.ibatis.builder.xml.XMLMapperBuilder; import org.apache.ibatis.io.Resources; import org.apache.ibatis.mapping.BoundSql; import org.apache.ibatis.mapping.MappedStatement; import org.apache.ibatis.mapping.SqlSource; import org.junit.jupiter.api.Test; import java.io.IOException; import java.io.InputStream; import java.lang.reflect.GenericArrayType; import java.lang.reflect.Method; import java.lang.reflect.ParameterizedType; import java.lang.reflect.Type; import java.nio.charset.StandardCharsets; import java.nio.file.Files; import java.nio.file.Path; import java.util.ArrayList; import java.util.HashMap; import java.util.LinkedHashMap; import java.util.List; import java.util.Map; import java.util.Set; import java.util.regex.Matcher; import java.util.regex.Pattern; import java.util.stream.Collectors; import java.util.stream.Stream; import static org.junit.jupiter.api.Assertions.assertEquals; import static org.junit.jupiter.api.Assertions.assertTrue; import static org.junit.jupiter.api.Assertions.fail; /** * 注解 SQL 平移到 mapper XML 的等价性守卫。 * *

基准是搬迁前注解的原文({@code src/test/resources/sql-layering/migrated-statements.tsv}, * 85 条),而且比对发生在 MyBatis 解析之后:把注解原文现场交给 * {@code LanguageDriver.createSqlSource}(注解当年就是走这条路进 MyBatis 的), * 与 XML 解析出来的 {@code MappedStatement} 各渲染一遍 {@code BoundSql} 再对撞。 * 这样"元素体该怎么转义"由 MyBatis 判定,不由生成脚本判定—— * 上一轮正是拿生成器的输出当基准,同一个解析器错两遍,85 条"逐字相等"全绿而 SQL 已经残缺。 * *

渲染用两组参数各对撞一次:空参数(所有 {@code } 走 false 支)与把 * {@code } 喂满 2 个元素(动态支展开成 {@code ?,?})。 * 两边同抛异常也算一致,但必须是同一异常类型与同一消息,不许一边过一边炸。 * *

第二支管 {@code resultType}:期望类型由反射从接口签名反推,不由生成脚本算, * 避免"生成时解错、断言时照着错的对"。 */ class MigratedSqlEquivalenceTest { private static final String FIXTURE = "sql-layering/migrated-statements.tsv"; // 85 → 84:Phase 5(AC-19/P1-B1)有意把 {@code TaskCenterQueryMapper#selectTaskPage} 从 // OFFSET 改成 keyset 游标。账本记的是「注解时代原文」,改一行基准就等于让等价性测试照着 // 新 SQL 自证 ⇒ 把该行整条摘出账本、点名进下方 NOT_MIGRATED,让基准继续只描述真正未改动的迁移件。 private static final int LEDGER_ROWS = 83; // 60 → 59:摘出去那行是一条 select。 private static final int LEDGER_SELECTS = 59; /** 全部 mapper XML 里的 select 总数:账本 60 + TaskImageCache 5 + AsinResultCache 1。 */ /** 66 → 67:会话容忍新增的 {@code AdminUserMapper#countLiveWorkFor} 也是一条 select。 */ // 67 → 78:keywordshare 模块新写 11 条 select,逐条登记进下方 NOT_MIGRATED。 // 78 → 86:brandgating 模块新写 8 条 select,同样逐条点入 // (与 SqlLayeringConventionTest.XML_STATEMENT_TOTAL 同轮 99 → 115 → 124)。 // 86 → 88:损耗监控在 UserSecretUsageMapper 新写 2 条聚合 select,逐条点入 // (SqlLayeringConventionTest.XML_STATEMENT_TOTAL 同轮 124 → 126)。 // 88 → 89:B28 新增 TaskFileJobMapper#selectFileTaskStatus(按主键读父任务状态),逐条点入 // (SqlLayeringConventionTest.XML_STATEMENT_TOTAL 同轮 128 → 129)。 // 89 → 99:关键词使用记录管理端(keywordusage 模块)新写 10 条只读 select,逐条点入 // (SqlLayeringConventionTest.XML_STATEMENT_TOTAL 同轮 130 → 140)。 // 99 → 99:客户端全量同步新写 1 条 insert(KeywordShareMapper#upsertBatchFromSync), // 点名进 NOT_MIGRATED 但不是 select ⇒ select 总数不动(SqlLayeringConventionTest 同轮 140 → 141)。 // 99 → 100:Phase 5(AC-19)为任务中心深翻页新增窄锚点语句 {@code TaskCenterQueryMapper#selectTaskPageAnchor} // (两列投影算页首游标),同轮点名进 NOT_MIGRATED;同轮的 selectTaskPage 改写让它从账本搬进 // NOT_MIGRATED(select 总数不变,只是记账位置换了)。 // 100 → 102:P1-1 把两条认领查询的通道谓词下推进 SQL,FileTaskMapper 新写 2 条 select, // 逐条点名进 NOT_MIGRATED(SqlLayeringConventionTest.XML_STATEMENT_TOTAL 同轮 144 → 146)。 // 102 → 103:P1-B6 把 claim 循环的「父任务是否终态」折成批量档 // TaskFileJobMapper#selectTerminalFileTaskIds,点名进下方 NOT_MIGRATED // (SqlLayeringConventionTest.XML_STATEMENT_TOTAL 同轮 146 → 147)。 // 103 → 105:v1.3(外观专利无侵权数据同步后管)appearancepatent 模块首份 mapper 新写 // 2 条只读 select(count/page),逐条点名进 NOT_MIGRATED // (SqlLayeringConventionTest.XML_STATEMENT_TOTAL 同轮 147 → 151)。 // 105 → 109:2026-11-11「按主管划分」同一 mapper 再落 4 条 select(主管聚合 count/page // +按主管导出 count/page),同样从来没有注解原文可对撞,逐条点名 //(SqlLayeringConventionTest.XML_STATEMENT_TOTAL 同轮 151 → 155)。 private static final int XML_SELECT_TOTAL = 109; /** * 不是「从注解搬过来」的语句:注解时代没有原文可对撞,等价性这支只能跳过它们。 * 登记在此而不是让它们红,是为了让「谁新写了语句」这件事留痕;新增一条不记名的,照样红。 */ private static final java.util.Set NOT_MIGRATED = java.util.Set.of("AdminUserMapper#countLiveWorkFor", // V188(2026-11-04)给计次 upsert 加 source 列(唯一键四元组),SQL 文本 // 不再是注解时代的逐字原文:整行从 migrated-statements.tsv 摘掉、点名到 // 这里(与 selectTaskPage 改写时同款处理,LEDGER_ROWS 84→83);新形状 // 由 V188 迁移测试与 UserSecretUsageServiceTest 钉。 "UserSecretUsageMapper#increment", // V157 加 token 两列时新写的累加语句;注解时代没有原文可对撞,等价性这支只能跳过它。 // 与 increment 分两条是口径要求(计次先于响应、token 只在响应后有读数),不是随手加的第二条 SQL。 "UserSecretUsageMapper#addTokens", // 失败任务重试:INSERT ... SELECT 复制采集明细行,非注解迁移件。 "CollectDataItemMapper#copyItemsForRetry", // keywordshare 模块(五国关键词共享网页化,2026-10-23)新写 11 条 select。 "KeywordShareMapper#countHit", "KeywordShareMapper#selectRows", "KeywordShareMapper#selectRandomUnused", "KeywordShareMapper#countDupKeywords", "KeywordShareMapper#selectFilterCountries", "KeywordShareMapper#selectFilterTreeRows", "KeywordShareMapper#selectCountryCounts", "KeywordShareMapper#selectCategoryCounts", "KeywordShareMapper#selectSubCategoryCounts", "KeywordShareMapper#selectCategoryL3Counts", "KeywordShareMapper#selectExistingKeywords", // 工作台客户端全量同步新写的词本体 UPSERT:注解时代没有原文可对撞,按新写语句点名留痕。 // 它是 insert 不是 select,故 XML_SELECT_TOTAL 不随之变。 "KeywordShareMapper#upsertBatchFromSync", // brandgating 模块(品牌Gating库并入管理后台,2026-10-23)新写 8 条 select。 "BrandGatingMapper#countByFilter", "BrandGatingMapper#selectRows", "BrandGatingMapper#countAll", "BrandGatingMapper#countByStatus", "BrandGatingMapper#countDistinctBrands", "BrandGatingMapper#countGroupByType", "BrandGatingMapper#countGroupByCountry", "BrandGatingMapper#countGroupBySource", // 损耗监控(2026-10-24)新写的 2 条聚合 select:当日全量扫描 + 单用户读数。 "UserSecretUsageMapper#sumByUserAndModule", "UserSecretUsageMapper#sumForUser", // B28(2026-10-25)新写的 1 条主键点查:父任务是否已终态。 "TaskFileJobMapper#selectFileTaskStatus", // P1-B6(2026-11-03)新写的 1 条批量档:一次问回这批父任务里已终态的 id // (终态值域由调用方传入,XML 里没有第二份字符串)。 "TaskFileJobMapper#selectTerminalFileTaskIds", // CR-01(2026-10-25)新写的 1 条写侧语句:会话世代原子自增。 "LoginUserMapper#incrementSessionEpoch", // 关键词使用记录管理端(2026-10-25)新写的 10 条只读 select。 "KeywordUsageAdminMapper#countUsageRows", "KeywordUsageAdminMapper#selectUsageRows", "KeywordUsageAdminMapper#countCopy", "KeywordUsageAdminMapper#countCopyExisting", "KeywordUsageAdminMapper#countAdd", "KeywordUsageAdminMapper#countDeletes", "KeywordUsageAdminMapper#selectDeleteRows", "KeywordUsageAdminMapper#selectStats", "KeywordUsageAdminMapper#selectUsers", "KeywordUsageAdminMapper#selectCountries", // Phase 5(AC-19/P1-B1)taskcenter 两条: // selectTaskPage —— 注解时代原文带 {@code LIMIT ? OFFSET ?},本轮有意改成 // (createdAt,id) 游标。基准是搬迁前的快照,不该被改写来替新 SQL 背书, // 所以整行从 migrated-statements.tsv 摘掉、点名到这里(LEDGER_ROWS 85→84)。 // selectTaskPageAnchor —— 本轮新写的两列窄投影,从来没有注解原文可对撞。 "TaskCenterQueryMapper#selectTaskPage", "TaskCenterQueryMapper#selectTaskPageAnchor", // P1-1(2026-10-31):客户端兜底拉取与服务端内部认领的通道谓词从 Java 层下推进 SQL // ——先 limit 取页再 filter(isLocal()) 会让本机单被前面的线上单永久挡死。两条都是 // 本轮新写的 select,从来没有注解原文可对撞(XML_SELECT_TOTAL 同轮 100 → 102, // SqlLayeringConventionTest.XML_STATEMENT_TOTAL 同轮 144 → 146)。 "FileTaskMapper#selectLocalChannelPendingTasks", "FileTaskMapper#selectInternalClaimCandidates", // v1.3 Phase 1(2026-11-10):appearancepatent 模块首份 mapper,4 条全部新写 //(覆盖式重写 delete/insert + 只读页 count/page select;V189 建表同窗), // 注解时代没有原文可对撞,逐条点名留痕(XML_SELECT_TOTAL 同轮 103 → 105)。 // 2026-11-11「ASIN 累计」改造(V192 同窗):deleteByResultId+insertBatch // 退役,由 upsertBatch(ON DUPLICATE KEY UPDATE,永不删除)顶替——NOT_MIGRATED // 里的两条旧点名换成 upsertBatch 一条,净减 1(XML_STATEMENT_TOTAL 同轮 156 → 155)。 "AppearancePatentCleanItemMapper#upsertBatch", "AppearancePatentCleanItemMapper#countCleanItems", "AppearancePatentCleanItemMapper#selectCleanItemPage", // 2026-11-11「按主管划分」(一主管一卡):4 条新写的 select——主管聚合 // count/page 与按主管导出的 count/page(带 users 联表按归属表达式收窄), // 注解时代没有原文可对撞,逐条点名留痕(XML_SELECT_TOTAL 105 → 109)。 "AppearancePatentCleanItemMapper#countSupervisors", "AppearancePatentCleanItemMapper#selectSupervisorSummaries", "AppearancePatentCleanItemMapper#countSupervisorItems", "AppearancePatentCleanItemMapper#selectSupervisorItems", // 2026-11-11 卡片「删除」:1 条新写的 delete(谓词与按主管导出的 select // 逐字同源)。delete 不计 select,故 XML_SELECT_TOTAL 保持 109 // (SqlLayeringConventionTest.XML_STATEMENT_TOTAL 同轮 155 → 156)。 "AppearancePatentCleanItemMapper#deleteSupervisorItems"); /** 账本 5 列:接口 / 方法 / @Select 种类 / 是否含常量插值 / 注解原文(Java 反转义后那条串)。 */ private static final int LEDGER_COLUMNS = 5; private static final int BASELINE_COL = 4; private static final Pattern STATEMENT = Pattern.compile( "(?is)<(select|insert|update|delete)\\s+id=\"([A-Za-z0-9_]+)\"([^>]*)>(.*?)"); private static final Pattern RESULT_TYPE = Pattern.compile("resultType=\"([^\"]+)\""); private static final Pattern FOREACH_COLLECTION = Pattern.compile("collection=[\"'](\\w+)[\"']"); private static final Pattern TEST_NAME = Pattern.compile("test=[\"']([^\"']*)[\"']"); private static final Pattern HASH_PARAM = Pattern.compile("#\\{\\s*([A-Za-z_]\\w*)"); /** OGNL 里的字面量与方法名不是参数名,喂值进去会让两边同时以错误告终。 */ private static final Set OGNL_WORDS = Set.of("null", "true", "false", "and", "or", "not", "size", "isEmpty", "equals", "length"); @Test void ledgerItselfIsTheExpectedShape() throws IOException { List rows = readLedger(); assertEquals(LEDGER_ROWS, rows.size(), "fixture 行数变了——它是搬迁前的快照,不该跟着代码漂"); assertEquals(LEDGER_SELECTS, rows.stream().filter(r -> "Select".equals(r[2])).count(), "fixture 里的 Select 条数与基线不符(读侧账本 = 59)"); assertEquals(LEDGER_ROWS - LEDGER_SELECTS, rows.stream().filter(r -> !"Select".equals(r[2])).count(), "写侧条数对不上(24 = Insert+Update+Delete)"); assertTrue(rows.stream().allMatch(r -> !r[1].isEmpty() && !r[BASELINE_COL].isEmpty()), "fixture 有空方法名或空 SQL,说明抽取器漏了形状"); // 基准得是「整条注解串」:半截 ")), "有基准行的