565 lines
33 KiB
Java
565 lines
33 KiB
Java
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 的等价性守卫。
|
||
*
|
||
* <p>基准是<b>搬迁前注解的原文</b>({@code src/test/resources/sql-layering/migrated-statements.tsv},
|
||
* 85 条),而且比对发生在 <b>MyBatis 解析之后</b>:把注解原文现场交给
|
||
* {@code LanguageDriver.createSqlSource}(注解当年就是走这条路进 MyBatis 的),
|
||
* 与 XML 解析出来的 {@code MappedStatement} 各渲染一遍 {@code BoundSql} 再对撞。
|
||
* 这样"元素体该怎么转义"由 MyBatis 判定,不由生成脚本判定——
|
||
* 上一轮正是拿生成器的输出当基准,同一个解析器错两遍,85 条"逐字相等"全绿而 SQL 已经残缺。
|
||
*
|
||
* <p>渲染用两组参数各对撞一次:空参数(所有 {@code <if>} 走 false 支)与把
|
||
* {@code <foreach collection>} 喂满 2 个元素(动态支展开成 {@code ?,?})。
|
||
* 两边同抛异常也算一致,但必须是同一异常类型与同一消息,不许一边过一边炸。
|
||
*
|
||
* <p>第二支管 {@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,让基准继续只描述真正未改动的迁移件。
|
||
// 83 → 82:47fc0e08(2026-11-16 平台超管 500 热修)给 ShopManageGroupMapper#selectAllGroups 的 XML
|
||
// 补 g.company_id AS companyId(注解时代原文没有这列)——改动是有意的,按 selectTaskPage/V188
|
||
// 同款处理整行摘出、点名 NOT_MIGRATED;新形状由 47fc0e08 那单的守卫钉。该笔走 fast 档发版
|
||
// 没点本支,2026-11-17 京东分类管理发版窗 full 闸门抓到补记。
|
||
private static final int LEDGER_ROWS = 82;
|
||
// 60 → 59:摘出去那行是一条 select。(59 → 58:摘 ShopManageGroupMapper#selectAllGroups 同上。)
|
||
private static final int LEDGER_SELECTS = 58;
|
||
/** 全部 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)。
|
||
// 109 → 111:v1.4 Phase 5(2026-11-14)后管只读页在 JdProductMapper 新写 2 条只读 select
|
||
//(countProducts + selectProductPage)。注意本格是「全部 XML 的 select 总数」(不走
|
||
// NOT_MIGRATED 豁免——豁免只作用于等价性那支),新写 select 也计入本分母。
|
||
// 111 → 112:2026-11-15 类目筛选下拉在 JdProductMapper 新写 1 条 select
|
||
//(selectProductCategories,DISTINCT category_path +行数),从来没有注解原文可对撞,
|
||
// 逐条点名进 NOT_MIGRATED。
|
||
// 113 → 114:2026-11-15 商品上架配额计数(b9b66bcb)在 JdProductMapper 新写 1 条只读 select
|
||
//(countByUserIds,按 owner uid 集计 biz_jd_product 行数),逐条点名进 NOT_MIGRATED。
|
||
// 该笔当时只点编译没跑整量、两处账本都漏记,2026-11-15 发版前整量抓到补记。
|
||
// 114 → 103:keywordshare 模块整体下线(Project-Slimming 第三轮:6.4 天访问日志零流量、
|
||
// 四树零引用、V165 已撤菜单),随删 11 条 select 与下方 NOT_MIGRATED 的 12 条点名。
|
||
private static final int XML_SELECT_TOTAL = 103;
|
||
|
||
/**
|
||
* 不是「从注解搬过来」的语句:注解时代没有原文可对撞,等价性这支只能跳过它们。
|
||
* 登记在此而不是让它们红,是为了让「谁新写了语句」这件事留痕;新增一条不记名的,照样红。
|
||
*/
|
||
private static final java.util.Set<String> 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",
|
||
// 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",
|
||
// v1.4 京东数据库(2026-11-14,V193/V194 同窗):jd 模块首份起的两份 mapper,
|
||
// 各 1 条新写的 upsert(覆盖最新 uk_company_shop_code / 图片登记
|
||
// uk_product_image),注解时代没有原文可对撞,逐条点名留痕
|
||
//(SqlLayeringConventionTest.XML_STATEMENT_TOTAL 同轮 155 → 157)。
|
||
"JdProductMapper#upsertBatch",
|
||
"JdProductImageMapper#upsertBatch",
|
||
// v1.4 Phase 5(2026-11-14):后管只读页在 JdProductMapper 新写 2 条只读 select
|
||
//(countProducts + selectProductPage,同一过滤面、offset/limit 由服务钳制后传参),
|
||
// 注解时代没有原文可对撞,逐条点名留痕
|
||
//(SqlLayeringConventionTest.XML_STATEMENT_TOTAL 同轮 157 → 159)。
|
||
"JdProductMapper#countProducts",
|
||
"JdProductMapper#selectProductPage",
|
||
// 2026-11-15 类目筛选下拉(京麦末级类目 distinct +行数)新写 1 条 select,
|
||
// 同样没有注解原文可对撞,点名留痕(XML_SELECT_TOTAL 同轮 111 → 112)。
|
||
"JdProductMapper#selectProductCategories",
|
||
// 2026-11-15 商品上架配额计数(b9b66bcb)在 JdProductMapper 新写 1 条只读 select
|
||
//(countByUserIds,按 owner uid 集计 biz_jd_product 行数,JdPublishQuotaService
|
||
// 配额原语),没有注解原文可对撞,点名留痕。该笔当时只点编译没跑整量、漏记两处
|
||
// 账本,2026-11-15 发版前整量抓到补记(XML_SELECT_TOTAL 113 → 114,
|
||
// SqlLayeringConventionTest.XML_STATEMENT_TOTAL 同轮 163 → 164)。
|
||
"JdProductMapper#countByUserIds",
|
||
// 47fc0e08(2026-11-16 平台超管 500 热修)给 selectAllGroups 的 XML 补
|
||
// g.company_id AS companyId:注解时代原文没有这列,等价性这支对撞即红。
|
||
// 有意改动按先例整行摘账本点名留痕(LEDGER_ROWS 83 → 82 / SELECTS 59 → 58);
|
||
// 该笔 fast 档发版漏记,2026-11-17 京东分类管理发版窗 full 闸门抓到补记。
|
||
"ShopManageGroupMapper#selectAllGroups");
|
||
|
||
/** 账本 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_]+)\"([^>]*)>(.*?)</\\1>");
|
||
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<String> OGNL_WORDS =
|
||
Set.of("null", "true", "false", "and", "or", "not", "size", "isEmpty", "equals", "length");
|
||
|
||
@Test
|
||
void ledgerItselfIsTheExpectedShape() throws IOException {
|
||
List<String[]> 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,说明抽取器漏了形状");
|
||
// 基准得是「整条注解串」:半截 <script> 外壳说明抽取被截断(上一轮就是把常量与标签吃了)
|
||
assertTrue(rows.stream().allMatch(r ->
|
||
r[BASELINE_COL].startsWith("<script>") == r[BASELINE_COL].contains("</script>")),
|
||
"有基准行的 <script> 外壳不成对——抽取时注解表达式被截断了");
|
||
assertTrue(rows.stream().allMatch(r ->
|
||
r[BASELINE_COL].contains("<if") == r[BASELINE_COL].contains("</if>")),
|
||
"有基准行的 <if> 不成对——常量插值没展开");
|
||
assertTrue(rows.stream().noneMatch(r -> r[BASELINE_COL].contains("IN ()")),
|
||
"有基准行出现空的 IN (),说明 foreach/常量被吞了");
|
||
}
|
||
|
||
@Test
|
||
void everyMigratedStatementRendersTheSameSqlAsTheAnnotationDid() throws Exception {
|
||
Map<String, String> baselines = new LinkedHashMap<>();
|
||
Map<String, String> kinds = new LinkedHashMap<>();
|
||
for (String[] row : readLedger()) {
|
||
baselines.put(row[0] + "#" + row[1], unescapeJava(row[4]));
|
||
kinds.put(row[0] + "#" + row[1], row[2].toLowerCase());
|
||
}
|
||
List<String> problems = new ArrayList<>();
|
||
int checked = 0;
|
||
for (Path xml : mapperXmls()) {
|
||
String iface = stem(xml);
|
||
if (!baselines.keySet().stream().anyMatch(k -> k.startsWith(iface + "#"))) {
|
||
continue; // TaskImageCache / AsinResultCache 由各自用例钉,不在这本账里
|
||
}
|
||
Class<?> mapperClass = Class.forName(namespaceOf(xml));
|
||
MybatisConfiguration configuration = parseInto(xml, new MybatisConfiguration());
|
||
Matcher m = STATEMENT.matcher(read(xml));
|
||
while (m.find()) {
|
||
String key = iface + "#" + m.group(2);
|
||
String baseline = baselines.get(key);
|
||
if (baseline == null) {
|
||
if (NOT_MIGRATED.contains(key)) {
|
||
continue;
|
||
}
|
||
problems.add(key + " 在基准账本里没有对应注解(XML 多出一条语句)");
|
||
continue;
|
||
}
|
||
checked++;
|
||
if (!kinds.get(key).equals(m.group(1))) {
|
||
problems.add(key + " 注解是 @" + kinds.get(key) + ",XML 用了 <" + m.group(1) + ">");
|
||
continue;
|
||
}
|
||
MappedStatement fromXml =
|
||
configuration.getMappedStatement(mapperClass.getName() + "." + m.group(2));
|
||
// 注解当年就是走这条驱动进 MyBatis 的(MapperAnnotationBuilder 用的正是默认脚本语言),
|
||
// 所以这里拿它现场编译基准串,等价性由 MyBatis 判定而不是由生成脚本判定。
|
||
SqlSource fromAnnotation = configuration.getDefaultScriptingLanguageInstance()
|
||
.createSqlSource(configuration, baseline, Object.class);
|
||
for (Map<String, Object> params : renderParams(baseline)) {
|
||
String where = key + "(" + params.get("_case") + ")";
|
||
compare(fromXml.getBoundSql(params), fromAnnotation.getBoundSql(params), where, problems);
|
||
}
|
||
}
|
||
}
|
||
int checkedRows = checked;
|
||
assertEquals(LEDGER_ROWS, checkedRows,
|
||
() -> "只比对了 " + checkedRows + " 条,其余没在 XML 里落地(应为 " + LEDGER_ROWS + " 条)");
|
||
assertTrue(problems.isEmpty(),
|
||
() -> "这些语句搬完之后 MyBatis 渲染出的 SQL 与注解时不同(" + problems.size() + " 处):"
|
||
+ System.lineSeparator() + String.join(System.lineSeparator(), problems));
|
||
}
|
||
|
||
/** 两边各渲染一次:都出 SQL 就逐字比,都抛就比异常,一边过一边炸必须算问题。 */
|
||
private static void compare(BoundSql a, BoundSql b, String where, List<String> problems) {
|
||
String sqlA, sqlB;
|
||
try {
|
||
sqlA = normalize(a.getSql());
|
||
} catch (RuntimeException e) {
|
||
problems.add(where + " XML 侧渲染就抛:" + e);
|
||
return;
|
||
}
|
||
try {
|
||
sqlB = normalize(b.getSql());
|
||
} catch (RuntimeException e) {
|
||
problems.add(where + " 注解侧渲染抛 " + e.getClass().getSimpleName()
|
||
+ " 而 XML 侧正常出 SQL: " + sqlA);
|
||
return;
|
||
}
|
||
if (!sqlA.equals(sqlB)) {
|
||
problems.add(where + System.lineSeparator()
|
||
+ " 注解渲染: " + sqlB + System.lineSeparator()
|
||
+ " XML 渲染 : " + sqlA);
|
||
return;
|
||
}
|
||
if (a.getParameterMappings().size() != b.getParameterMappings().size()) {
|
||
problems.add(where + " 占位符数不同:注解 " + b.getParameterMappings().size()
|
||
+ " vs XML " + a.getParameterMappings().size() + " —— " + sqlA);
|
||
}
|
||
}
|
||
|
||
/** 空参数走所有 <if> 的 false 支;再喂满 foreach 走动态支。两支都要两边一致。 */
|
||
private static List<Map<String, Object>> renderParams(String baseline) {
|
||
Map<String, Object> full = new HashMap<>();
|
||
Set<String> collections = new java.util.LinkedHashSet<>();
|
||
Matcher fc = FOREACH_COLLECTION.matcher(baseline);
|
||
while (fc.find()) {
|
||
collections.add(fc.group(1));
|
||
}
|
||
Set<String> names = new java.util.LinkedHashSet<>(collections);
|
||
Matcher t = TEST_NAME.matcher(baseline);
|
||
while (t.find()) {
|
||
Matcher word = Pattern.compile("\\w+").matcher(t.group(1));
|
||
while (word.find()) {
|
||
String w = word.group();
|
||
if (!OGNL_WORDS.contains(w)) {
|
||
names.add(w);
|
||
}
|
||
}
|
||
}
|
||
Matcher h = HASH_PARAM.matcher(baseline);
|
||
while (h.find()) {
|
||
names.add(h.group(1));
|
||
}
|
||
for (String name : names) {
|
||
full.put(name, collections.contains(name) ? List.of("a", "b") : "v");
|
||
}
|
||
return List.of(Map.of("_case", "空参数"), Map.of("_case", "带参数"))
|
||
.stream().map(marker -> {
|
||
Map<String, Object> params =
|
||
new HashMap<>("_case".equals(marker.get("_case")) ? Map.of() : full);
|
||
params.putAll(marker);
|
||
return params;
|
||
}).collect(Collectors.toList());
|
||
}
|
||
|
||
/** resultType 必须与接口方法签名一致;期望值由反射算,不用生成脚本的结论。 */
|
||
@Test
|
||
void everySelectKeepsTheReturnTypeItsAnnotationHad() throws Exception {
|
||
List<String> problems = new ArrayList<>();
|
||
int checked = 0;
|
||
for (Path xml : mapperXmls()) {
|
||
String text = read(xml);
|
||
Matcher ns = Pattern.compile("namespace=\"([^\"]+)\"").matcher(text);
|
||
if (!ns.find()) {
|
||
problems.add(xml + " 缺 namespace");
|
||
continue;
|
||
}
|
||
Class<?> iface = Class.forName(ns.group(1));
|
||
MybatisConfiguration configuration = parseInto(xml, new MybatisConfiguration());
|
||
Matcher m = STATEMENT.matcher(text);
|
||
while (m.find()) {
|
||
if (!"select".equals(m.group(1))) {
|
||
continue;
|
||
}
|
||
String method = m.group(2);
|
||
checked++;
|
||
MappedStatement statement =
|
||
configuration.getMappedStatement(iface.getName() + "." + method);
|
||
Class<?> resolved = statement.getResultMaps().get(0).getType();
|
||
Matcher attrs = RESULT_TYPE.matcher(m.group(3));
|
||
String declared = attrs.find() ? attrs.group(1) : null;
|
||
if (declared == null) {
|
||
problems.add(iface.getSimpleName() + "#" + method + " 的 <select> 没写 resultType");
|
||
continue;
|
||
}
|
||
Class<?> expected = expectedType(iface, method);
|
||
if (expected == null) {
|
||
problems.add(iface.getSimpleName() + "#" + method + " 找不到接口方法签名");
|
||
} else if (!compatible(expected, resolved)) {
|
||
problems.add(iface.getSimpleName() + "#" + method
|
||
+ " resultType=" + declared + " 解析成 " + resolved.getName()
|
||
+ ",而方法签名要的是 " + expected.getName());
|
||
}
|
||
}
|
||
}
|
||
int checkedSelects = checked;
|
||
assertTrue(problems.isEmpty(), () -> "resultType 与接口签名不一致(" + problems.size() + " 条):"
|
||
+ System.lineSeparator() + String.join(System.lineSeparator(), problems));
|
||
// 这支扫的是全部 mapper XML,所以分母比账本大:本轮 60 + TaskImageCache 5 + AsinResultCache 1
|
||
assertEquals(XML_SELECT_TOTAL, checkedSelects,
|
||
() -> "只检查了 " + checkedSelects + " 条 select,应为 " + XML_SELECT_TOTAL
|
||
+ " 条(正则或 XML 漂了)");
|
||
}
|
||
|
||
/** 只把 XML 解析进配置:XMLMapperBuilder 会顺带按 namespace 绑上接口。 */
|
||
private static MybatisConfiguration parseInto(Path xml, MybatisConfiguration configuration)
|
||
throws IOException {
|
||
try (InputStream in = Files.newInputStream(xml)) {
|
||
new XMLMapperBuilder(in, configuration, xml.toString(),
|
||
configuration.getSqlFragments()).parse();
|
||
}
|
||
return configuration;
|
||
}
|
||
|
||
private static Class<?> expectedType(Class<?> iface, String method) {
|
||
for (Method m : iface.getDeclaredMethods()) {
|
||
if (!m.getName().equals(method)) {
|
||
continue;
|
||
}
|
||
return unwrap(m.getGenericReturnType());
|
||
}
|
||
return null;
|
||
}
|
||
|
||
/** List<X> / Set<X> / Collection<X> 取 X;byte[] 原样;泛型数组元素再解一层。 */
|
||
private static Class<?> unwrap(Type type) {
|
||
if (type instanceof ParameterizedType pt) {
|
||
Type raw = pt.getRawType();
|
||
if (raw instanceof Class<?> c && (c == List.class || c == java.util.Set.class
|
||
|| c == java.util.Collection.class || c == Iterable.class)) {
|
||
return unwrap(pt.getActualTypeArguments()[0]);
|
||
}
|
||
return (Class<?>) raw;
|
||
}
|
||
if (type instanceof GenericArrayType ga) {
|
||
Class<?> component = unwrap(ga.getGenericComponentType());
|
||
if (component == byte.class) {
|
||
return byte[].class;
|
||
}
|
||
return java.lang.reflect.Array.newInstance(component, 0).getClass();
|
||
}
|
||
if (type instanceof Class<?> c) {
|
||
if (c == long.class) {
|
||
return Long.class;
|
||
}
|
||
if (c == int.class) {
|
||
return Integer.class;
|
||
}
|
||
if (c == boolean.class) {
|
||
return Boolean.class;
|
||
}
|
||
if (c == double.class) {
|
||
return Double.class;
|
||
}
|
||
return c;
|
||
}
|
||
return Object.class;
|
||
}
|
||
|
||
private static boolean compatible(Class<?> expected, Class<?> resolved) {
|
||
if (expected == resolved) {
|
||
return true;
|
||
}
|
||
if (Map.class.isAssignableFrom(expected)) {
|
||
return Map.class.isAssignableFrom(resolved);
|
||
}
|
||
return resolved != null && expected.isAssignableFrom(resolved);
|
||
}
|
||
|
||
private static List<String[]> readLedger() throws IOException {
|
||
try (InputStream in = Resources.getResourceAsStream(FIXTURE)) {
|
||
String text = new String(in.readAllBytes(), StandardCharsets.UTF_8);
|
||
List<String[]> rows = new ArrayList<>();
|
||
for (String line : text.split("\n")) {
|
||
if (line.isBlank()) {
|
||
continue;
|
||
}
|
||
String[] cols = line.split("\t", -1);
|
||
if (cols.length != 5) {
|
||
throw new IllegalStateException("fixture 列数不对: " + line.substring(0,
|
||
Math.min(80, line.length())));
|
||
}
|
||
rows.add(cols);
|
||
}
|
||
return rows;
|
||
}
|
||
}
|
||
|
||
private static List<Path> mapperXmls() throws IOException {
|
||
Path dir = moduleRoot().resolve("src/main/resources/mapper");
|
||
if (!Files.isDirectory(dir)) {
|
||
fail("找不到 " + dir + " —— 本用例依赖以 backend-java 为工作目录运行");
|
||
}
|
||
try (Stream<Path> walk = Files.walk(dir)) {
|
||
return walk.filter(p -> p.getFileName().toString().endsWith(".xml"))
|
||
.sorted().collect(Collectors.toList());
|
||
}
|
||
}
|
||
|
||
private static String namespaceOf(Path xml) {
|
||
Matcher m = Pattern.compile("namespace=\"([^\"]+)\"").matcher(read(xml));
|
||
if (!m.find()) {
|
||
throw new IllegalStateException(xml + " 缺 namespace");
|
||
}
|
||
return m.group(1);
|
||
}
|
||
|
||
/** tsv 里的基准行是 Java 转义过的(一行一条),还原成注解当年真正的那个字符串。 */
|
||
private static String unescapeJava(String s) {
|
||
StringBuilder out = new StringBuilder(s.length());
|
||
for (int i = 0; i < s.length(); i++) {
|
||
char c = s.charAt(i);
|
||
if (c == '\\' && i + 1 < s.length()) {
|
||
char n = s.charAt(++i);
|
||
switch (n) {
|
||
case 'n' -> out.append('\n');
|
||
case 't' -> out.append('\t');
|
||
case 'r' -> out.append('\r');
|
||
case '\\' -> out.append('\\');
|
||
default -> out.append(n);
|
||
}
|
||
continue;
|
||
}
|
||
out.append(c);
|
||
}
|
||
return out.toString();
|
||
}
|
||
|
||
private static String normalize(String text) {
|
||
return text.replaceAll("\\s+", " ").trim();
|
||
}
|
||
|
||
private static String read(Path path) {
|
||
try {
|
||
return Files.readString(path, StandardCharsets.UTF_8);
|
||
} catch (IOException e) {
|
||
throw new IllegalStateException("读取失败: " + path, e);
|
||
}
|
||
}
|
||
|
||
private static String stem(Path path) {
|
||
String name = path.getFileName().toString();
|
||
return name.substring(0, name.length() - 4);
|
||
}
|
||
|
||
private static Path moduleRoot() {
|
||
Path here = Path.of("").toAbsolutePath();
|
||
if (Files.isDirectory(here.resolve("src/main/java"))) {
|
||
return here;
|
||
}
|
||
Path nested = here.resolve("backend-java");
|
||
if (Files.isDirectory(nested.resolve("src/main/java"))) {
|
||
return nested;
|
||
}
|
||
throw new IllegalStateException("无法定位 backend-java 模块目录(cwd=" + here + ")");
|
||
}
|
||
}
|