test(公司范围): G2 断言 B 走同源参数谓词,公司参数判定改声明窗口,豁免降到 handler 级
Fix round 2 补 round 1 自留的三条缺口(生产代码与其它测试一字未改,只动这一支):
- N1 断言 B 触发键从下划线字面量换成与 A 同源的 handler.takesCompanyParam(),
"驼峰参数名+真调 readScope+全文不出现 company_id" 那记静默绿现会被 B 咬红。
- N2 公司参数判定从"同行"改成"声明窗口"(mapping 行到第一个以 { 结尾的行),
覆盖折行签名;并把 request.getParameter("company*") 同族纳入触发;
窗口取不到判红并报块名,不再"窗口取不到就当没公司参数"。
- N3 豁免键从整文件降到 handler 级(路径#@GetMapping(...)),hasSize(1) 保留;
liveness 语义跟改准,既咬僵尸条目也咬被豁免文件里没点名的第二记公司 id handler。
This commit is contained in:
+149
-34
@@ -8,6 +8,7 @@ import java.nio.file.Files;
|
||||
import java.nio.file.Path;
|
||||
import java.util.ArrayList;
|
||||
import java.util.Arrays;
|
||||
import java.util.HashSet;
|
||||
import java.util.List;
|
||||
import java.util.Set;
|
||||
import java.util.regex.Pattern;
|
||||
@@ -25,7 +26,7 @@ import org.junit.jupiter.api.Test;
|
||||
* controller 调,再把算好的成员集当参数传进去(docs/plans/19-company-tab.md「Task 11 已确认现状」第 2 条)。
|
||||
* 因此"handler 体内出现 readScope("就是这一页接了唯一出口的证据。</p>
|
||||
*
|
||||
* <p>三条口径都是评审实测出的洞,逐条钉住:</p>
|
||||
* <p>口径都是评审实测出的洞,逐条钉住:</p>
|
||||
* <ol>
|
||||
* <li><b>断言只打在可执行行上</b>。原先全文比对时,把 {@code readScope(} 与 {@code name = "company_id"}
|
||||
* 只写进 javadoc、参数实际用驼峰 {@code Long companyId} 的 controller 照样绿(评审 I-4a:
|
||||
@@ -37,23 +38,39 @@ import org.junit.jupiter.api.Test;
|
||||
* 也要补(评审 I-4b:文件级比对下 list() 没收、detail() 收了 ⇒ 整文件仍绿)。
|
||||
* 所以按 mapping 注解把文件切成 handler 块,逐块跑两条断言;切不进 handler 的残块
|
||||
* (package/import/类级注解/字段)由一条<b>显式</b>断言看守,不许静默跳过。</li>
|
||||
* <li><b>白名单键是相对 src/main/java 的路径</b>,不再是裸文件名。按裸文件名时任意包下的同名文件
|
||||
* 自动豁免(评审 I-5:{@code modules/tmpmutation/AdminUserController.java} 收 company_id、
|
||||
* 不走出口 ⇒ 绿)。另加 liveness:白名单每一项必须仍在取样集里,否则就是僵尸条目。</li>
|
||||
* <li><b>白名单键是 handler 级</b>(相对 {@code src/main/java} 的路径 + 该 handler 的 mapping 注解文本,
|
||||
* 形如 {@code .../AdminUserController.java#@GetMapping("/users")})。round 1 用文件级键,往被豁免
|
||||
* 文件里新加的任何端点会被一并免掉;round 1 的裸文件名版更是让任意包下同名文件自动豁免(评审 I-5)。
|
||||
* 降级到 handler 级后,{@code hasSize(1)} 钉条目数、liveness 钉"每一项仍对应一个真在收公司 id 的
|
||||
* handler",并额外咬住"被豁免文件里冒出第二个没点名的公司 id handler"。</li>
|
||||
* <li><b>断言 A 与 B 用同一个"该 handler 是否收公司 id 参数"谓词</b>({@link Block#takesCompanyParam()})。
|
||||
* round 1 的 B 用下划线字面量 {@code company_id} 当触发键、A 用参数形状键,两者不同源 ⇒
|
||||
* "驼峰参数名 + 真调 readScope + 全文不出现下划线"这种形状 A 绿、B 根本不触发(评审 N1:
|
||||
* 正是"接口 200、前端发 company_id=、参数恒 null、tab 切了纹丝不动"那一记)。统一谓词后它必红。</li>
|
||||
* <li><b>"公司参数"判定认声明窗口,不认同行</b>。round 1 要求公司 token 与 {@code @RequestParam}
|
||||
* 落在同一物理行,本仓签名大量折行({@code AdminUserController:36-43} 一次摊 7 个参数),
|
||||
* 折行写法就被静默跳过(评审 N2)。现从该 handler 的 mapping 注解行起、到第一个以 <code>{</code>
|
||||
* 结尾的行为止取"声明窗口",窗口内同时出现 {@code @RequestParam} 与公司 token(排除
|
||||
* {@code @Operation}/{@code description=} 这类文档串)即算"收公司 id 参数";另把
|
||||
* {@code request.getParameter("company_id"/"companyId")} 这一族也纳入触发。窗口取不到(整块没有
|
||||
* 以 <code>{</code> 结尾的行)判红并报块名,不许"窗口取不到就当没有公司参数"。</li>
|
||||
* </ol>
|
||||
*
|
||||
* <p>取样键(第 4 条修的是 Important 5):可执行行里出现 {@code company_id},<b>或</b>同一行同时出现
|
||||
* {@code @RequestParam} 与驼峰 {@code companyId}。只按下划线字面量取样时,一支纯驼峰的端点根本进不了
|
||||
* 样本,整条护栏被绕过。今天加了驼峰形状后新样本为 0 支(只有 {@code AdminUserController:43} 命中,
|
||||
* 已在白名单),零假阳性,白名单不必重写。</p>
|
||||
* <p>取样键:可执行行里出现 {@code company_id} <b>或</b> {@code companyId}(裸 token 即入样本,交给逐 handler
|
||||
* 的窗口谓词判定是否真收参数)。只按 {@code @RequestParam}+驼峰同行取样时,折行签名的文件根本进不了样本、
|
||||
* 连窗口判定都不会跑(N2 的静默跳过正是这么发生的)。真实树今天含这两个 token 的 controller 恰有 3 支
|
||||
* ({@code AdminUserController}/{@code AdminConsoleController}/{@code ZiniaoAuthController}),后两支的公司
|
||||
* token 只在 {@code @Operation}/{@code item.put} 里、不在 {@code @RequestParam} 声明窗口上 ⇒ 零假阳性,
|
||||
* 白名单不必重写。</p>
|
||||
*/
|
||||
class CompanyIdParamGoesThroughReadScopeTest {
|
||||
|
||||
private static final Path MAIN_ROOT = Path.of("src/main/java");
|
||||
|
||||
/**
|
||||
* 点名白名单(<b>相对 {@code src/main/java} 的路径</b>、统一正斜杠,精确匹配,不许通配/前缀/裸文件名;
|
||||
* 今天唯一一项是 {@code com/nanri/aiimage/modules/admin/controller/AdminUserController.java})。
|
||||
* 点名白名单(<b>handler 级键</b>:相对 {@code src/main/java} 的路径 + {@code #} + 该 handler 的
|
||||
* mapping 注解文本,统一正斜杠,精确匹配,不许通配/前缀/裸文件名/整文件)。今天唯一一项是
|
||||
* {@code com/nanri/aiimage/modules/admin/controller/AdminUserController.java#@GetMapping("/users")}。
|
||||
*
|
||||
* <p>只放一条:{@code AdminUserController} 的 {@code GET /api/admin/users?company_id=} 是<b>先于本计划
|
||||
* 存在、已在生产</b>的那"第二个 if"——用户管理页不在本计划 8 个 tab 页里
|
||||
@@ -62,18 +79,21 @@ class CompanyIdParamGoesThroughReadScopeTest {
|
||||
* 正是全局约束 2 点名的参考形状。本批次不迁它:迁了等于把 140 值的 {@code id IN(...)} 换回
|
||||
* {@code company_id =} 直查,性能方向是负的;已另记为批次 1 之后独立一笔。</p>
|
||||
*
|
||||
* <p>豁免语义(评审 Important 4 定稿):只豁免<b>该文件各 handler 的 {@code readScope(} 断言</b>,
|
||||
* 不豁免取样(剔掉白名单再自检非空会当场红,全局约束 15 要的就是这条),也不豁免
|
||||
* {@code name = "company_id"}——驼峰参数名静默失效那一类错不能被白名单盖住。</p>
|
||||
* <p>豁免语义:键精确到一个 handler,只豁免<b>该 handler 的 {@code readScope(} 断言(断言 A)</b>,
|
||||
* 不豁免取样(剔掉白名单再自检非空会当场红,全局约束 15 要的就是这条),不豁免 {@code name =
|
||||
* "company_id"}(断言 B,驼峰参数名静默失效那一类错不能被白名单盖住),也不豁免"该文件的其它
|
||||
* handler"——往这一条里塞第二个端点会同时被 A 和 liveness 咬住。</p>
|
||||
*/
|
||||
private static final Set<String> READ_SCOPE_ALLOWLIST =
|
||||
Set.of("com/nanri/aiimage/modules/admin/controller/AdminUserController.java");
|
||||
Set.of("com/nanri/aiimage/modules/admin/controller/AdminUserController.java#@GetMapping(\"/users\")");
|
||||
|
||||
private static final String READ_SCOPE_CALL = "readScope(";
|
||||
private static final String EXPLICIT_PARAM_NAME = "name = \"company_id\"";
|
||||
private static final String SNAKE_PARAM = "company_id";
|
||||
private static final String CAMEL_PARAM = "companyId";
|
||||
private static final String REQUEST_PARAM = "@RequestParam";
|
||||
private static final String GET_PARAMETER = "getParameter(";
|
||||
private static final String WINDOW_OPEN = "{";
|
||||
|
||||
/** handler 的边界:这些注解组后面跟方法签名的是端点,跟类型声明的是类级。 */
|
||||
private static final List<String> MAPPING_ANNOTATIONS = List.of(
|
||||
@@ -123,16 +143,23 @@ class CompanyIdParamGoesThroughReadScopeTest {
|
||||
Blocks blocks = splitBlocks(lines);
|
||||
for (Block handler : blocks.handlers()) {
|
||||
String where = rel + " 的 handler " + handler.header();
|
||||
// 断言 A:收了公司 id 参数的 handler 必须在该 handler 体内走唯一出口。
|
||||
if (handler.takesCompanyParam() && !READ_SCOPE_ALLOWLIST.contains(rel)) {
|
||||
// 声明窗口取不到 = 切块形状失效,绝不能"当作没公司参数"静默放过,必须红并报块名。
|
||||
if (handler.windowUndeterminable()) {
|
||||
fail(where + " 里找不到以 " + WINDOW_OPEN + " 结尾的行,无法确定声明窗口 —— "
|
||||
+ "切块形状失效(折行签名/单行体等),必须人工核对,不许当作\"该 handler 没收公司参数\"静默跳过");
|
||||
}
|
||||
// A 与 B 共用同一个参数形状谓词(N1:触发键必须同源,否则"驼峰+走了出口"的错没人看守)。
|
||||
boolean takesCompanyParam = handler.takesCompanyParam();
|
||||
// 断言 A:收了公司 id 参数的 handler 必须在该 handler 体内走唯一出口(handler 级豁免)。
|
||||
if (takesCompanyParam && !READ_SCOPE_ALLOWLIST.contains(exemptionKey(rel, handler))) {
|
||||
assertThat(handler.text())
|
||||
.as(where + " 收了公司 id 参数,但该 handler 体内没有出现 readScope( —— 文件里别处接了不算")
|
||||
.contains(READ_SCOPE_CALL);
|
||||
}
|
||||
// 断言 B:块里出现 company_id 就必须写显式 name=(白名单不豁免这条)。
|
||||
if (handler.text().contains(SNAKE_PARAM)) {
|
||||
// 断言 B:收了公司 id 参数的 handler 必须写显式 name=(白名单不豁免这条)。
|
||||
if (takesCompanyParam) {
|
||||
assertThat(handler.text())
|
||||
.as(where + " 的 company_id 没写显式 name=,会和驼峰参数名混成两种拼写")
|
||||
.as(where + " 的公司 id 参数没写显式 name = \"company_id\"")
|
||||
.contains(EXPLICIT_PARAM_NAME);
|
||||
}
|
||||
}
|
||||
@@ -149,17 +176,29 @@ class CompanyIdParamGoesThroughReadScopeTest {
|
||||
}
|
||||
|
||||
@Test
|
||||
@DisplayName("白名单每一项都仍在取样集里:条目一旦不再含公司 id 形状就红(防僵尸豁免)")
|
||||
@DisplayName("白名单每一项都仍对应一个真在收公司 id 的 handler:条目失效或被豁免文件冒出第二记都红(防僵尸豁免/整文件级豁免)")
|
||||
void allowlistEntriesAreStillSampled() throws IOException {
|
||||
Set<String> sampledKeys = sampledControllers().stream()
|
||||
.map(CompanyIdParamGoesThroughReadScopeTest::relativeKey)
|
||||
.collect(Collectors.toSet());
|
||||
assertThat(sampledKeys)
|
||||
.as("白名单里的文件已经不含 company_id/companyId 端点了,请把这条豁免一起删掉")
|
||||
Set<String> companyHandlerKeys = companyScopedHandlerKeys();
|
||||
|
||||
assertThat(companyHandlerKeys)
|
||||
.as("白名单条目对应的 handler 已经不收公司 id 参数了(改名/删端点/参数换形状),请把这条豁免一起删掉")
|
||||
.containsAll(READ_SCOPE_ALLOWLIST);
|
||||
|
||||
// 降级到 handler 级后新增的看守:被豁免点名过的文件里,每一个收公司 id 的 handler 都必须自己点名,
|
||||
// 否则就是"以为整文件被豁免、其实只免了一条"的第二记端点——必须红,不许靠 hasSize(1) 蒙混。
|
||||
Set<String> exemptedFiles = READ_SCOPE_ALLOWLIST.stream()
|
||||
.map(CompanyIdParamGoesThroughReadScopeTest::filePartOf)
|
||||
.collect(Collectors.toSet());
|
||||
List<String> unNamedInExemptedFile = companyHandlerKeys.stream()
|
||||
.filter(key -> exemptedFiles.contains(filePartOf(key)))
|
||||
.filter(key -> !READ_SCOPE_ALLOWLIST.contains(key))
|
||||
.collect(Collectors.toList());
|
||||
assertThat(unNamedInExemptedFile)
|
||||
.as("被豁免点名的文件里出现了第二个收公司 id 的 handler,却没被单独点名——豁免是 handler 级,不是整文件级")
|
||||
.isEmpty();
|
||||
}
|
||||
|
||||
/** 取样=可执行行里出现下划线字面量,或同一行的 @RequestParam 用了驼峰 companyId。 */
|
||||
/** 取样=可执行行里出现公司 token(下划线或驼峰),逐 handler 的窗口谓词再判定是否真收参数。 */
|
||||
private static List<Path> sampledControllers() throws IOException {
|
||||
if (!Files.isDirectory(MAIN_ROOT)) fail("找不到 " + MAIN_ROOT + " —— 用例依赖以 backend-java 为工作目录");
|
||||
try (Stream<Path> walk = Files.walk(MAIN_ROOT)) {
|
||||
@@ -172,14 +211,51 @@ class CompanyIdParamGoesThroughReadScopeTest {
|
||||
}
|
||||
}
|
||||
|
||||
/** 断言 A 的触发条件:必须是"参数"形状(同一行有 @RequestParam),不是任意出现。 */
|
||||
private static boolean isCompanyParamLine(String line) {
|
||||
return line.contains(REQUEST_PARAM) && (line.contains(SNAKE_PARAM) || line.contains(CAMEL_PARAM));
|
||||
/** 全部"收公司 id 参数"的 handler 的豁免键集合。 */
|
||||
private static Set<String> companyScopedHandlerKeys() throws IOException {
|
||||
Set<String> keys = new HashSet<>();
|
||||
for (Path controller : sampledControllers()) {
|
||||
String rel = relativeKey(controller);
|
||||
for (Block handler : splitBlocks(executableLines(read(controller))).handlers()) {
|
||||
if (handler.takesCompanyParam()) keys.add(exemptionKey(rel, handler));
|
||||
}
|
||||
}
|
||||
return keys;
|
||||
}
|
||||
|
||||
/** 取样与残块的触发条件。 */
|
||||
/** handler 级豁免键:相对路径 + '#' + 该 handler 自己的 mapping 注解文本。 */
|
||||
private static String exemptionKey(String rel, Block handler) {
|
||||
return rel + "#" + handler.mappingLine();
|
||||
}
|
||||
|
||||
private static String filePartOf(String key) {
|
||||
int hash = key.indexOf('#');
|
||||
return hash < 0 ? key : key.substring(0, hash);
|
||||
}
|
||||
|
||||
/** 取样与残块的触发条件:可执行行里出现公司 token(下划线或驼峰)。 */
|
||||
private static boolean isCompanyShapeLine(String line) {
|
||||
return line.contains(SNAKE_PARAM) || (line.contains(REQUEST_PARAM) && line.contains(CAMEL_PARAM));
|
||||
return hasCompanyToken(line);
|
||||
}
|
||||
|
||||
private static boolean hasCompanyToken(String line) {
|
||||
return line.contains(SNAKE_PARAM) || line.contains(CAMEL_PARAM);
|
||||
}
|
||||
|
||||
private static boolean isMappingLine(String line) {
|
||||
return MAPPING_ANNOTATIONS.stream().anyMatch(line::startsWith);
|
||||
}
|
||||
|
||||
/**
|
||||
* 文档串行:{@code @Operation}/{@code @Parameter}/{@code @ApiResponse} 或带 {@code summary =}/
|
||||
* {@code description =} 的注解行——这些里出现的 companyId 只是文案,不代表该 handler 真收了公司参数。
|
||||
*/
|
||||
private static boolean isDocLine(String line) {
|
||||
return line.startsWith("@Operation")
|
||||
|| line.startsWith("@Parameter")
|
||||
|| line.startsWith("@ApiResponse")
|
||||
|| line.contains("summary =")
|
||||
|| line.contains("description =");
|
||||
}
|
||||
|
||||
/**
|
||||
@@ -198,7 +274,7 @@ class CompanyIdParamGoesThroughReadScopeTest {
|
||||
int runEnd = i;
|
||||
while (runEnd + 1 < ex.size() && ex.get(runEnd + 1).startsWith("@")) runEnd++;
|
||||
boolean mappingRun = ex.subList(i, runEnd + 1).stream()
|
||||
.anyMatch(line -> MAPPING_ANNOTATIONS.stream().anyMatch(line::startsWith));
|
||||
.anyMatch(CompanyIdParamGoesThroughReadScopeTest::isMappingLine);
|
||||
String signature = runEnd + 1 < ex.size() ? ex.get(runEnd + 1) : "";
|
||||
if (mappingRun && !signature.isEmpty() && !TYPE_DECL.matcher(signature).find()) {
|
||||
starts.add(i);
|
||||
@@ -224,8 +300,47 @@ class CompanyIdParamGoesThroughReadScopeTest {
|
||||
return String.join("\n", lines);
|
||||
}
|
||||
|
||||
/** 该 handler 的 mapping 注解文本,作为 handler 级豁免键的后缀;没有 mapping 行就退回块首行。 */
|
||||
String mappingLine() {
|
||||
return lines.stream()
|
||||
.filter(CompanyIdParamGoesThroughReadScopeTest::isMappingLine)
|
||||
.findFirst()
|
||||
.orElse(lines.get(0));
|
||||
}
|
||||
|
||||
/**
|
||||
* 声明窗口:从本块的 mapping 注解行起、到第一个以 <code>{</code> 结尾的行为止(含该行)。
|
||||
* 返回 {@code null} 表示整块找不到以 <code>{</code> 结尾的行(切块形状失效),由调用方判红并报块名。
|
||||
*/
|
||||
List<String> declarationWindow() {
|
||||
int start = 0;
|
||||
while (start < lines.size() && !isMappingLine(lines.get(start))) start++;
|
||||
for (int j = start; j < lines.size(); j++) {
|
||||
if (lines.get(j).endsWith(WINDOW_OPEN)) {
|
||||
return lines.subList(start, j + 1);
|
||||
}
|
||||
}
|
||||
return null;
|
||||
}
|
||||
|
||||
boolean windowUndeterminable() {
|
||||
return declarationWindow() == null;
|
||||
}
|
||||
|
||||
/**
|
||||
* 该 handler 是否收公司 id 参数(A、B 共用,N1 要求同源):
|
||||
* ① 声明窗口里同时出现 {@code @RequestParam} 与非文档行的公司 token(覆盖 inline 与折行签名,
|
||||
* 排除 {@code @Operation}/{@code description=} 里的文案提及);
|
||||
* ② 或整块里出现 {@code request.getParameter("company_id"/"companyId")} 同族写法(这一族写在方法体内)。
|
||||
*/
|
||||
boolean takesCompanyParam() {
|
||||
return lines.stream().anyMatch(CompanyIdParamGoesThroughReadScopeTest::isCompanyParamLine);
|
||||
List<String> window = declarationWindow();
|
||||
boolean viaRequestParam = window != null
|
||||
&& window.stream().anyMatch(line -> line.contains(REQUEST_PARAM))
|
||||
&& window.stream().anyMatch(line -> hasCompanyToken(line) && !isDocLine(line));
|
||||
boolean viaGetParameter = lines.stream()
|
||||
.anyMatch(line -> line.contains(GET_PARAMETER) && hasCompanyToken(line));
|
||||
return viaRequestParam || viaGetParameter;
|
||||
}
|
||||
}
|
||||
|
||||
@@ -241,7 +356,7 @@ class CompanyIdParamGoesThroughReadScopeTest {
|
||||
.collect(Collectors.toList());
|
||||
}
|
||||
|
||||
/** 白名单键:相对 src/main/java、统一正斜杠,与取样路径同源,避免平台分隔符造成静默不匹配。 */
|
||||
/** 白名单键的文件部分:相对 src/main/java、统一正斜杠,与取样路径同源,避免平台分隔符造成静默不匹配。 */
|
||||
private static String relativeKey(Path controller) {
|
||||
return MAIN_ROOT.relativize(controller).toString().replace('\\', '/');
|
||||
}
|
||||
|
||||
Reference in New Issue
Block a user