package com.nanri.aiimage.testutil; import java.io.IOException; import java.nio.charset.StandardCharsets; import java.nio.file.Files; import java.nio.file.Path; import java.util.List; import java.util.stream.Collectors; import java.util.stream.Stream; /** 源码扫描式护栏的取文助手。路径解析照抄 {@code common/security/InternalTokenSingleOutletTest} 的 * moduleRoot()/mainSources() 两支——surefire 的 cwd 是模块目录,从仓库根或 IDE 跑时要退到 backend-java/, * 定位不到必须 fail 而不是静默跳过(静默跳过 = 整支护栏恒绿)。 */ public final class SourceScan { private SourceScan() { } /** 按文件名(不含目录)取 {@code src/main/java} 下那份源码的全文字符串。 * ⚠️ 返回 String,与 InternalTokenSingleOutletTest 里那个返回 Path 的私有 {@code sourceOf} 不是一回事, * 别指望复用它的——那个是 private。 */ public static String sourceText(String fileName) { return mainSources().stream() .filter(p -> p.getFileName().toString().equals(fileName)) .findFirst() .map(SourceScan::read) .orElseThrow(() -> new IllegalStateException( "src/main/java 下找不到 " + fileName + " —— 文件改名/挪目录了,护栏要红在这里")); } /** * 剥掉注释,偏移不变:注释字符换成空格、换行原样保留,所以 {@link #methodBody} 这类 * 按位置切片的助手在剥前剥后切出同一段。 * *
为什么护栏必须打在它上面:源码守卫的两种断言都会被文字喂到—— * 「必须不存在」那一形会被注释里提一句顶红(假红,还能忍), * 「必须存在/次数等于 N」那一形会被 javadoc 里提一句喂饱(假绿,等于护栏没写)。 * 2026-10-07 实测:{@code AdminTaskCenterController} 的类注释里有 1 处 {@code readScope(}, * 整份原文 {@code readScope(} 数=1、剥完=0——文件级判据吃原文就会读出这种数。
* *口径:{@code //} 到行尾、{@code /* … *}{@code /} 整段、字符串与字符字面量里的斜杠不算注释、 * 三个双引号的文本块按字面量整段保留。
*/ public static String withoutComments(String java) { StringBuilder out = new StringBuilder(java.length()); int i = 0; int n = java.length(); while (i < n) { char c = java.charAt(i); char next = i + 1 < n ? java.charAt(i + 1) : '\0'; if (c == '/' && next == '/') { while (i < n && java.charAt(i) != '\n') { out.append(' '); i++; } } else if (c == '/' && next == '*') { out.append(" "); i += 2; while (i < n) { if (java.charAt(i) == '*' && i + 1 < n && java.charAt(i + 1) == '/') { out.append(" "); i += 2; break; } out.append(java.charAt(i) == '\n' ? '\n' : ' '); i++; } } else if (java.startsWith("\"\"\"", i)) { out.append("\"\"\""); i += 3; while (i < n && !java.startsWith("\"\"\"", i)) { out.append(java.charAt(i)); i++; } out.append("\"\"\""); i += 3; } else if (c == '"' || c == '\'') { out.append(c); i++; while (i < n) { if (java.charAt(i) == '\\' && i + 1 < n) { out.append(java.charAt(i)).append(java.charAt(i + 1)); i += 2; continue; } if (java.charAt(i) == '\n') { break; } out.append(java.charAt(i)); boolean closing = java.charAt(i) == c; i++; if (closing) { break; } } } else { out.append(c); i++; } } return out.toString(); } /** 大括号配平切出「某个方法」的源码:从它的签名行往前一直含到注解,到方法收尾的 `}` 为止。 * *两条它必须自己防住的坑,都写在用例里过:
*