test(量具): SourceScan 的取面边界钉死——八条 exclude_ 用例

代收在飞件落地(原作者那一路已不在跑,本笔内容一字未改)。`SourceScan.java` 是 94 支守门用例
共用的取面量具,它"什么算进面"此前没有直接用例:这八条把边界逐条钉住——只计 .java(大写 .JAVA
也计)、同目录 .md 不进面、以 java 结尾的目录名不误判、隐藏文件不计入、空文件计入但读为空串、
不可读文件必须抛不许静默跳过、面内元素恒 isRegularFile。

为什么值得单列一笔:重构蓝图 Phase 0 的硬闸点名"SourceScan 正在被改、94 支用例继承它的状态",
基线必须落在 commit 上而不是工作树里;同时它也是 Phase 0 里"真实落库形状锁不住"那条偏差的
补偿——量具本身越可信,service→mapper 这层快照越当得起护身符。验证依据=闸门 ts=09:49:23 后端全绿。
This commit is contained in:
2026-10-18 09:52:38 +08:00
parent b9e5aa4d30
commit 899bc73a23
@@ -487,4 +487,139 @@ class SourceScanTest {
.hasMessageContaining("遍历")
.hasMessageContaining(vanished.getFileName().toString());
}
// ---------------------------------------------------------------- N8 只吃 .java
@Test
void exclude_java只计java扩展() {
assertThat(SourceScan.moduleSources("modules/appearancepatent"))
.as("面内每一支都必须以小写 {@code .java} 结尾——大小写策略见 exclude_大写JAVA后缀被计入")
.allMatch(p -> p.getFileName().toString().endsWith(".java"));
}
@Test
void exclude_同目录md文件不进面() throws IOException {
Path module = Files.createDirectories(tmp.resolve("N8混放/src/main/java/modules/mixed"));
Files.writeString(module.resolve("Keep.java"), "class Keep {}", StandardCharsets.UTF_8);
Files.writeString(module.resolve("MIGRATION.md"), "# 拆分说明", StandardCharsets.UTF_8);
Files.writeString(module.resolve("mapper.xml"), "<x/>", StandardCharsets.UTF_8);
Files.writeString(module.resolve("notes.txt"), "x", StandardCharsets.UTF_8);
assertThat(SourceScan.moduleSources(tmp.resolve("N8混放/src/main/java"), "modules/mixed"))
.as("真集成同款场景:SourceScan.java:35-39 记过同类事故——注释类文本会把「被禁写法」喂成假绿。"
+ "正反双向一起断言:留 1 支 .java,同时排除 3 支非 java")
.extracting(p -> p.getFileName().toString())
.containsExactly("Keep.java");
}
@Test
void exclude_大写JAVA后缀被计入() throws IOException {
Path module = Files.createDirectories(tmp.resolve("N8大小写/src/main/java/modules/case"));
Files.writeString(module.resolve("Lower.java"), "class Lower {}", StandardCharsets.UTF_8);
Files.writeString(module.resolve("UPPER.JAVA"), "class UPPER {}", StandardCharsets.UTF_8);
// 本 task 定口径:**大写 .JAVA 不计**(与仓内现状一致)。正反两条同时钉:
// 谁把它改成大小写不敏感匹配,下面那条「不含 UPPER.JAVA」立刻红——这格因此不是恒绿格。
List<String> names = SourceScan.moduleSources(tmp.resolve("N8大小写/src/main/java"), "modules/case")
.stream().map(p -> p.getFileName().toString()).toList();
assertThat(names).contains("Lower.java");
assertThat(names)
.as("口径选择:只认小写 .java。仓内 973 支主源码件实测全是小写后缀,"
+ "把 .JAVA 也收进来等于给「同一份代码换个大小写再放一遍」开绿灯")
.doesNotContain("UPPER.JAVA");
}
@Test
void exclude_以java结尾的目录名不误判() throws IOException {
Path module = Files.createDirectories(tmp.resolve("N8怪目录/src/main/java/modules/weird"));
Path fakeDir = Files.createDirectories(module.resolve("foo.java"));
Files.writeString(fakeDir.resolve("Bar.java"), "class Bar {}", StandardCharsets.UTF_8);
List<Path> files = SourceScan.moduleSources(tmp.resolve("N8怪目录/src/main/java"), "modules/weird");
assertThat(Files.isDirectory(fakeDir))
.as("正对照:这个目录确实叫 foo.java,否则下面那条断言是空的")
.isTrue();
assertThat(files)
.as("目录不是源文件:后缀判定必须先过 isRegularFile(walkFileTree 的 visitFile 天然只给文件,"
+ "但这条换实现就容易踩,所以钉住)")
.extracting(p -> p.getFileName().toString())
.containsExactly("Bar.java");
}
@Test
// plan 原文这格叫「exclude_隐藏文件.java不计入」——含点号做 Java 方法名不合法,改名并在此留痕
void exclude_隐藏文件不计入() throws IOException {
Path module = Files.createDirectories(tmp.resolve("N8隐藏件/src/main/java/modules/dot"));
Files.writeString(module.resolve("Real.java"), "class Real {}", StandardCharsets.UTF_8);
Files.writeString(module.resolve(".Shadow.java"), "class Shadow {}", StandardCharsets.UTF_8);
assertThat(SourceScan.moduleSources(tmp.resolve("N8隐藏件/src/main/java"), "modules/dot"))
.as("以点开头的 .java 是编辑器备份(.Foo.java、Foo.java.orig 一族),进面就会把计数喂大。"
+ "正反双向:真件在、影子件不在")
.extracting(p -> p.getFileName().toString())
.containsExactly("Real.java");
}
@Test
void exclude_空文件被计入但读为空串() throws IOException {
Path module = Files.createDirectories(tmp.resolve("N8空件/src/main/java/modules/zero"));
Path empty = Files.createFile(module.resolve("Empty.java"));
Files.writeString(module.resolve("Kept.java"), "class Kept {}", StandardCharsets.UTF_8);
List<Path> files = SourceScan.moduleSources(tmp.resolve("N8空件/src/main/java"), "modules/zero");
assertThat(Files.size(empty))
.as("正对照:这支确实是 0 字节")
.isZero();
assertThat(files)
.as("有文件但内容为空 ≠ 零文件——这条与 N11「目录里 0 支 .java 才抛」必须分得开,"
+ "否则 N11 会把「全是空件」的模块误判成「没有文件」")
.extracting(p -> p.getFileName().toString())
.containsExactlyInAnyOrder("Empty.java", "Kept.java");
}
@Test
void exclude_不可读文件抛不静默跳过() throws IOException, InterruptedException {
Path root = tmp.resolve("N8不可读/src/main/java");
Path module = Files.createDirectories(root.resolve("modules/locked"));
Path noList = Files.createDirectories(module.resolve("nolist"));
Files.writeString(noList.resolve("Hidden.java"), "class Hidden {}", StandardCharsets.UTF_8);
Process icacls = new ProcessBuilder("icacls", noList.toString(), "/deny", "*S-1-1-0:(OI)(CI)RX")
.redirectErrorStream(true).start();
String out;
try (var in = icacls.getInputStream()) {
out = new String(in.readAllBytes(), StandardCharsets.UTF_8);
}
int code = icacls.waitFor();
try {
assertThat(code)
.as("icacls 造不出「不可列举目录」⇒ 环境缺口,判红而不是跳过(跳过会新增 Skipped,违反 N99)。"
+ "输出:%s", out)
.isZero();
assertThat(Files.isReadable(noList))
.as("反证前提:拒绝授权必须真的生效,否则后面那条断言是恒绿的")
.isFalse();
assertThatThrownBy(() -> SourceScan.moduleSources(root, "modules/locked"))
.as("列举失败的目录必须把异常冒出来(visitFileFailed ⇒ IllegalStateException),"
+ "静默跳过 = 那个子树里的被禁写法永远不会被读到")
.isInstanceOf(IllegalStateException.class)
.hasMessageContaining("遍历");
} finally {
// 撤销拒绝授权,否则 JUnit 清 @TempDir 会因无删除权限卡住,把一次性件留在机器上
new ProcessBuilder("icacls", noList.toString(), "/remove:d", "*S-1-1-0")
.redirectErrorStream(true).start().waitFor();
}
}
@Test
void exclude_面内全部元素isRegularFile为真() {
assertThat(SourceScan.moduleSources("modules/shopdatacrawl"))
.as("真实集成:51 支的模块里逐支都必须是regular file,形状契约")
.isNotEmpty()
.allMatch(Files::isRegularFile);
}
}