test(公司tab): G2 补断言 D——公司参数必须真进 readScope/resolveScope 的实参列表
A/B/C 三条判据都只看"收了参数、调了出口、结果交出去了",对 readScope(operator, null) 这一形全部放行:参数照样绑、出口照样调、返回值照样用,tab 却一动不动、接口还是 200。 D 咬的是入口那一侧——用 @RequestParam 绑到的那个变量名必须作为整词出现在出口调用的 实参列表里(射程与 A/B/C 同源:同一个 takesCompanyParam 谓词、同一份 READ_SCOPE_ALLOWLIST, 一条豁免同时免四条,不另起第二张表)。四条探针接进同一支跑探针的 @Test,null 形必红、 经 helper 转手的正形必绿,且已实测 A/B/C 对 null 探针三条前提全绿(D 才有鉴别力)。
This commit is contained in:
+277
-1
@@ -95,6 +95,25 @@ import org.junit.jupiter.api.Test;
|
||||
* ② 该变量必须出现在 handler 体内<b>另一条方法调用的实参列表</b>里(扣掉它自己那条赋值语句,
|
||||
* 单层括号够用,今天两页都是这一形)。只要求"在别处被引用一次"不够:
|
||||
* {@code if (scoped != null) throw …} 是装饰,不算把范围交给谁 ⇒ 控制语句关键字不认。</li>
|
||||
* <li><b>调了出口不等于把公司参数交给了出口</b>(本轮新增的断言 D)。现网最难查的一刀是
|
||||
* {@code dataReadScope.readScope(operator, null)}:参数照样收下(B 绿)、{@code readScope(} 照样写在
|
||||
* handler 体内(A 绿)、算出来的范围照样接住并喂给 service(C 绿),唯独 tab 传下来的那个值
|
||||
* 没进出口——症状是"接口 200、页面一切正常、切 tab 数字永远不动",G1 只看前端文本同样不红。
|
||||
* D 因此先按 {@link Block#boundCompanyParam()} 从<b>声明窗口</b>里取出被绑定到
|
||||
* {@code company_id} 的<b>变量名</b>(不硬编码 {@code companyId}:这一支改叫 {@code orgId} 就用
|
||||
* {@code orgId} 判),再要求它作为整词实参出现在 {@code readScope}/{@code resolveScope} 的参数表里
|
||||
* (单层括号,复用 {@link #CALL_ARGUMENTS};私有收口方法 {@code resolveScope(request, companyId)}
|
||||
* 那一形算,Task 11 模板鼓励的正是它)。只写在 {@code if (companyId != null)} 里、或只出现在
|
||||
* {@code @Operation} 文案里,都不算消费——沿用 C 的 {@link #NOT_VALUE_CONSUMERS} 那把尺子,不放宽。
|
||||
* 射程与 A/B/C 同源:同一个 {@code takesCompanyParam()} 谓词、同一份
|
||||
* {@link #READ_SCOPE_ALLOWLIST}(一条豁免同时免 A/B/C/D,不许另起第二张表),并且只咬
|
||||
* {@code viaRequestParam()} 那一族(F-C 的同一把尺子:{@code getParameter("company_id")} 给不出
|
||||
* 绑定变量名,D 对它无从判定)。取不到绑定名 = 形状不认识 ⇒ 判红并报形状,不许静默放过。
|
||||
* D 的代价与射程一并交代(本轮报告有逐条清单):{@link #CALL_ARGUMENTS} 只吃单层括号,于是
|
||||
* {@code readScope(operator, normalize(companyId))} 这种嵌套写法会判红(误伤合规代码,改写法或补宽
|
||||
* D 的取法都算核对过);非 {@code Long} 型公司参数取不到绑定名,同样判红;而"handler 之外的私有
|
||||
* 收口方法里把公司参数硬写成 {@code null}"这一族 D 看不见——块边界止于该 handler 自己的闭括号
|
||||
* (第 7 条),{@code AdminImageVideoTaskController.scopeOf} 正是它,那一处是<b>故意</b>传 null 的。</li>
|
||||
* </ol>
|
||||
*
|
||||
* <p>取样键:可执行行里出现 {@code company_id} <b>或</b> {@code companyId}(裸 token 即入样本,交给逐 handler
|
||||
@@ -170,6 +189,24 @@ class CompanyIdParamGoesThroughReadScopeTest {
|
||||
private static final Set<String> NOT_VALUE_CONSUMERS = Set.of(
|
||||
"if", "for", "while", "switch", "do", "catch", "synchronized", "return", "throw", "else", "try");
|
||||
|
||||
/**
|
||||
* 断言 D 认的两个被调名:{@code readScope} 是唯一出口本身,{@code resolveScope} 是 Task 11 模板
|
||||
* 鼓励的"controller 里的私有收口方法"那一形(它内部再去 readScope)。除此之外的调用都不算
|
||||
* "把公司参数交给了出口"——尤其 {@code readScope(operator, null)} 里那个 {@code null}。
|
||||
*/
|
||||
private static final String RESOLVE_SCOPE_CALL = "resolveScope(";
|
||||
private static final Set<String> SCOPE_CALLEES = Set.of("readScope", "resolveScope");
|
||||
|
||||
/**
|
||||
* 断言 D 的取绑定名(两把锚一起用):先在声明窗口里找 {@code name = "company_id"}
|
||||
* (容 {@code name="company_id"} 这类空格写法,且窗口已 join ⇒ 折行签名也认),
|
||||
* 再取它<b>之后</b>第一个 {@code Long 变量名}。取"之后第一个"而不是"最后一个":
|
||||
* {@code ShopManageController.page} 的参数表里 {@code Long page}/{@code Long pageSize}/{@code Long groupId}
|
||||
* 都排在公司参数<b>之前</b>,抓最后一个或整窗抓都会抓错人。
|
||||
*/
|
||||
private static final Pattern EXPLICIT_COMPANY_NAME = Pattern.compile("name\\s*=\\s*\"company_id\"");
|
||||
private static final Pattern COMPANY_PARAM_DECL = Pattern.compile("Long\\s+([A-Za-z_$][\\w$]*)");
|
||||
|
||||
/**
|
||||
* 参数绑定注解(F-A):一行里出现它们,这一行就是<b>真参数声明</b>,无论同行是否还写着
|
||||
* {@code description =}——本仓 93 行 {@code @Parameter(description = "…") @RequestParam(…)} 挤同一行的
|
||||
@@ -256,8 +293,68 @@ class CompanyIdParamGoesThroughReadScopeTest {
|
||||
}
|
||||
""";
|
||||
|
||||
/**
|
||||
* 断言 D 的负探针(<b>D 的存在理由</b>):公司参数收了、{@code readScope(} 也写在 handler 体内、
|
||||
* 结果也接住并喂给了 service——唯独 tab 传下来的那个值被写成了 {@code null}。
|
||||
* <p>A/B/C 三条判据对这段源码<b>都判通过</b>(用例里带了这三条反面证据,判不过就说明探针没有区分度、
|
||||
* D 只是重复劳动),G1 只看前端文本同样不红;现网症状"接口 200、页面正常、切 tab 数字永远不动"
|
||||
* 就是这一形。只有 D 红。</p>
|
||||
*/
|
||||
private static final String SCOPE_PASSED_NULL_PROBE = """
|
||||
@GetMapping("/probe")
|
||||
public String passedNull(@RequestParam(name = "company_id", required = false) Long companyId) {
|
||||
List<Long> ids = dataReadScope.readScope(operator, null).userIdsOr(null);
|
||||
shopService.page(page, ids);
|
||||
return "ok";
|
||||
}
|
||||
""";
|
||||
|
||||
/**
|
||||
* 断言 D 的正探针:{@code companyId} 交给同文件的私有收口方法({@code resolveScope(request, companyId)},
|
||||
* Task 11 模板那一形,内部再去 readScope)⇒ D 不许红。
|
||||
*/
|
||||
private static final String SCOPE_PASSED_THROUGH_HELPER_PROBE = """
|
||||
@GetMapping("/probe")
|
||||
public String passedHelper(@RequestParam(name = "company_id", required = false) Long companyId,
|
||||
HttpServletRequest request) {
|
||||
ScopeContext scope = resolveScope(request, companyId);
|
||||
return String.valueOf(taskCenterQueryService.overview(scope));
|
||||
}
|
||||
""";
|
||||
|
||||
/**
|
||||
* 断言 D 的负探针 2(任务书 D.3 最后那一记"别放宽"的独立证据):{@code companyId} 只被 {@code if}
|
||||
* 读了一次(控制语句不算消费,与 C 共用 {@link #NOT_VALUE_CONSUMERS} 那把尺子),进出口的是 {@code null}
|
||||
* ⇒ D 必须红。断言 A/B/C 对它同样全绿:{@code readScope(} 在、{@code name = "company_id"} 在、
|
||||
* 结果接进 {@code scoped} 又喂给了 {@code shopService.page(…, scoped)}。
|
||||
*/
|
||||
private static final String SCOPE_ONLY_IF_DECOR_PROBE = """
|
||||
@GetMapping("/probe")
|
||||
public String onlyIf(@RequestParam(name = "company_id", required = false) Long companyId) {
|
||||
if (companyId != null) {
|
||||
log.info("tab 切了");
|
||||
}
|
||||
List<Long> scoped = dataReadScope.readScope(operator, null).userIdsOr(null);
|
||||
return String.valueOf(shopService.page(page, scoped));
|
||||
}
|
||||
""";
|
||||
|
||||
/**
|
||||
* 断言 D 的"绑定名不许硬编码"探针:这一支的公司参数声明叫 {@code orgId}(有的页会把它叫别的名字),
|
||||
* 并且真把 {@code orgId} 交给了出口 ⇒ D 必须用它自己取到的名字去判,判绿。
|
||||
* 如果 D 里写死了 {@code companyId},这一支会假红——这条就是那件事的反面证据。
|
||||
*/
|
||||
private static final String SCOPE_ALTERNATE_NAME_PROBE = """
|
||||
@GetMapping("/probe")
|
||||
public String otherName(@RequestParam(name = "company_id", required = false) Long orgId) {
|
||||
List<Long> scoped = dataReadScope.readScope(operator, orgId).userIdsOr(null);
|
||||
return String.valueOf(shopService.page(page, scoped));
|
||||
}
|
||||
""";
|
||||
|
||||
@Test
|
||||
@DisplayName("每个收公司 id 参数的 handler 都走唯一出口,并且显式写了 name = \"company_id\"")
|
||||
@DisplayName("每个收公司 id 参数的 handler 都走唯一出口、显式写了 name = \"company_id\","
|
||||
+ "而且 tab 传下来的那个值真被交给了出口(A/B/C/D)")
|
||||
void everyCompanyIdHandlerGoesThroughReadScope() throws IOException {
|
||||
assertThat(READ_SCOPE_ALLOWLIST)
|
||||
.as("白名单只允许 AdminUserController 一条:多一条 = 有人新开了一个不走唯一出口的 if")
|
||||
@@ -309,10 +406,43 @@ class CompanyIdParamGoesThroughReadScopeTest {
|
||||
.as("断言 C 自检(第二形):ReadScope s = dataReadScope.readScope(…) 且 s 进了 service.page(…) 的实参 ⇒ 同样要认")
|
||||
.isNull();
|
||||
|
||||
// 断言 D 的判据自检(两个方向都要,全局约束 15)。负探针要先证明"A/B/C 三条对它都判通过"——
|
||||
// 这三条前提不成立就说明这段源码本来已经有人看守,D 没有区分度、只是重复劳动。
|
||||
String nullProbeText = String.join("\n", textsOf(sourceLines(SCOPE_PASSED_NULL_PROBE)));
|
||||
assertThat(nullProbeText)
|
||||
.as("断言 D 负样本的前提(断言 A):readScope( 确实写在 handler 体内 ⇒ A 判它绿")
|
||||
.contains(READ_SCOPE_CALL);
|
||||
assertThat(nullProbeText)
|
||||
.as("断言 D 负样本的前提(断言 B):name = \"company_id\" 字面量也在 ⇒ B 判它绿")
|
||||
.contains(EXPLICIT_PARAM_NAME);
|
||||
assertThat(scopeProbeReason(SCOPE_PASSED_NULL_PROBE, "SCOPE_PASSED_NULL_PROBE"))
|
||||
.as("断言 D 负样本的前提(断言 C):范围照样接住并喂给了 service ⇒ C 也判它绿;"
|
||||
+ "三条前提同时成立才说明『参数被传成 null』这一刀今天没人杀")
|
||||
.isNull();
|
||||
assertThat(companyIdArgProbeReason(SCOPE_PASSED_NULL_PROBE, "SCOPE_PASSED_NULL_PROBE", CAMEL_PARAM))
|
||||
.as("断言 D 自检(负样本):readScope(operator, null) —— 公司参数没进出口 ⇒ 必须判红")
|
||||
.isNotNull()
|
||||
.contains("没进任何 readScope/resolveScope 的实参列表");
|
||||
assertThat(companyIdArgProbeReason(SCOPE_ONLY_IF_DECOR_PROBE, "SCOPE_ONLY_IF_DECOR_PROBE", CAMEL_PARAM))
|
||||
.as("断言 D 自检(负样本 2):companyId 只被 if 读了一次、进出口的是 null ⇒ 同样要红"
|
||||
+ "(控制语句不算消费,与 C 同一把尺子)")
|
||||
.isNotNull()
|
||||
.contains("没进任何 readScope/resolveScope 的实参列表");
|
||||
assertThat(companyIdArgProbeReason(SCOPE_PASSED_THROUGH_HELPER_PROBE, "SCOPE_PASSED_THROUGH_HELPER_PROBE", CAMEL_PARAM))
|
||||
.as("断言 D 自检(正样本):companyId 交给同文件私有 resolveScope(request, companyId) ⇒ 判据不许恒红")
|
||||
.isNull();
|
||||
assertThat(companyIdArgProbeReason(SCOPE_ALTERNATE_NAME_PROBE, "SCOPE_ALTERNATE_NAME_PROBE", "orgId"))
|
||||
.as("断言 D 自检(改名那一族):参数声明叫 orgId、交出去的也是 orgId ⇒ 不许红"
|
||||
+ "(这条同时钉住\"D 不许硬编码 companyId\":写死了它就会在这一支假红)")
|
||||
.isNull();
|
||||
|
||||
// 断言 C 的分母由本轮实扫得出(不写死数字):扫进射程的 handler 键、走完两步的正样本支数、红因先攒后判。
|
||||
List<String> scopeCaughtSample = new ArrayList<>();
|
||||
List<String> scopeDiscarded = new ArrayList<>();
|
||||
int scopeCaughtHandlers = 0;
|
||||
// 断言 D 的分母同一把尺子(同一批 handler、同一份豁免键):被 D 评过的 handler 键 + 红因先攒后判。
|
||||
List<String> companyIdArgSample = new ArrayList<>();
|
||||
List<String> companyIdArgMissing = new ArrayList<>();
|
||||
|
||||
List<Path> sampled = sampledControllers();
|
||||
assertThat(sampled)
|
||||
@@ -361,6 +491,20 @@ class CompanyIdParamGoesThroughReadScopeTest {
|
||||
scopeDiscarded.add(where + dropped);
|
||||
}
|
||||
}
|
||||
// 断言 D(本轮新增):范围"算过"且"交出去了"还不够——C 咬的是 readScope( 的<b>返回值</b>,
|
||||
// D 咬的是它的<b>入参</b>:tab 传下来的那个变量名必须真出现在 readScope/resolveScope 的
|
||||
// 实参列表里。readScope(operator, null) 三条判据全绿而 tab 恒不动,就是这一记。
|
||||
// 射程与 A/B/C 同源:同一个 takesCompanyParam() 谓词、同一份 READ_SCOPE_ALLOWLIST
|
||||
// (一条豁免同时免 A/B/C/D,不另起第二张表);只咬 viaRequestParam() 那一族(F-C 同一把
|
||||
// 尺子:getParameter("company_id") 那一族给不出绑定变量名,D 对它无从判定,不硬判)。
|
||||
if (takesCompanyParam && handler.viaRequestParam() && handler.hasScopeCall()
|
||||
&& !READ_SCOPE_ALLOWLIST.contains(exemptionKey(rel, handler))) {
|
||||
companyIdArgSample.add(exemptionKey(rel, handler));
|
||||
String argMissing = handler.companyIdArgFailure();
|
||||
if (argMissing != null) {
|
||||
companyIdArgMissing.add(where + argMissing);
|
||||
}
|
||||
}
|
||||
}
|
||||
|
||||
// 残块(package/import/类级注解/字段,以及 handler 收口之后、下一支 handler 之前的尾随方法)
|
||||
@@ -391,6 +535,19 @@ class CompanyIdParamGoesThroughReadScopeTest {
|
||||
assertThat(scopeDiscarded)
|
||||
.as("范围算了但没接住(断言 C):readScope( 的结果要么没赋给变量,要么赋了却没交给任何方法调用")
|
||||
.isEmpty();
|
||||
|
||||
// 断言 D 的取样自检与分母(与 C 同一族纪律):空样本 = D 空转,射程不含已接线的页 = 静默脱离。
|
||||
assertThat(companyIdArgSample)
|
||||
.as("断言 D 取样集非空自检:一支『用 @RequestParam 收了公司 id 参数、体内又调了 "
|
||||
+ "readScope/resolveScope』的 handler 都没扫到 ⇒ D 一行都没评")
|
||||
.isNotEmpty();
|
||||
assertThat(companyIdArgSample)
|
||||
.as("断言 D 的射程必须覆盖已接线的那两页(改名/换 mapping 会让它静默脱离射程,分母不能自造)")
|
||||
.contains(SCOPE_CAUGHT_HISTORY_KEY, SCOPE_CAUGHT_VIDEO_KEY);
|
||||
assertThat(companyIdArgMissing)
|
||||
.as("公司参数没被交给出口(断言 D):readScope/resolveScope 的实参列表里没有出现被绑定到 "
|
||||
+ "company_id 的那个变量名 —— 参数收下、出口也调了,tab 却是死的")
|
||||
.isEmpty();
|
||||
}
|
||||
|
||||
@Test
|
||||
@@ -436,6 +593,34 @@ class CompanyIdParamGoesThroughReadScopeTest {
|
||||
return handler.scopeCatchFailure();
|
||||
}
|
||||
|
||||
/**
|
||||
* 断言 D 的探针驱动器(形状同 {@link #scopeProbeReason},不新开风格):先确认这段样本真被切成
|
||||
* "1 支用 {@code @RequestParam} 收公司 id 参数、体内调了 readScope/resolveScope"的 handler,
|
||||
* 再钉住"取到的绑定名 == 探针里写的那个参数名"——取不到或取错人 = D 没在读声明窗口而是在硬编码
|
||||
* {@code companyId},那 D 自己就是坏的,探针必须红给编写者看;最后跑
|
||||
* {@link Block#companyIdArgFailure()} 取红因。
|
||||
*/
|
||||
private static String companyIdArgProbeReason(String probeSource, String probeName, String expectedBinding) {
|
||||
List<Block> blocks = splitBlocks(sourceLines(probeSource)).handlers();
|
||||
assertThat(blocks)
|
||||
.as(probeName + " 应当恰好切出 1 支 handler;切不出来则断言 D 的自检无从判定")
|
||||
.hasSize(1);
|
||||
Block handler = blocks.get(0);
|
||||
assertThat(handler.takesCompanyParam())
|
||||
.as(probeName + " 的 handler 没被认成收公司 id 参数,断言 D 根本不会触发 ⇒ 探针失效")
|
||||
.isTrue();
|
||||
assertThat(handler.viaRequestParam())
|
||||
.as(probeName + " 的公司参数不是 @RequestParam 绑定形状,断言 D 不咬它 ⇒ 探针失效")
|
||||
.isTrue();
|
||||
assertThat(handler.boundCompanyParam())
|
||||
.as(probeName + " 取到的绑定名与探针声明的参数名不一致 ⇒ D 没在读声明窗口(硬编码 companyId 的形状)")
|
||||
.isEqualTo(expectedBinding);
|
||||
assertThat(handler.hasScopeCall())
|
||||
.as(probeName + " 的 handler 体内没有 readScope( 或 resolveScope( ,断言 D 扫不到它 ⇒ 探针失效")
|
||||
.isTrue();
|
||||
return handler.companyIdArgFailure();
|
||||
}
|
||||
|
||||
/** 取样=可执行行里出现公司 token(下划线或驼峰),逐 handler 的窗口谓词再判定是否真收参数。 */
|
||||
private static List<Path> sampledControllers() throws IOException {
|
||||
if (!Files.isDirectory(MAIN_ROOT)) fail("找不到 " + MAIN_ROOT + " —— 用例依赖以 backend-java 为工作目录");
|
||||
@@ -769,6 +954,97 @@ class CompanyIdParamGoesThroughReadScopeTest {
|
||||
}
|
||||
return false;
|
||||
}
|
||||
|
||||
/**
|
||||
* 断言 D 的"这支到底调没调出口"门槛:连 {@code readScope(}/{@code resolveScope(} 都没写的 handler,
|
||||
* 红它的是断言 A,D 不叠一条重复的红(免得同一支同时冒出两条口径不同的消息)。
|
||||
*/
|
||||
boolean hasScopeCall() {
|
||||
String src = text();
|
||||
return src.contains(READ_SCOPE_CALL) || src.contains(RESOLVE_SCOPE_CALL);
|
||||
}
|
||||
|
||||
/**
|
||||
* 断言 D 的取绑定名:在<b>声明窗口</b>(mapping 注解行 → 方法体开行,join 后判 ⇒ 折行签名与
|
||||
* {@code @Parameter(…) @RequestParam(…)} 挤同一行的主流写法都认)里找 {@code name = "company_id"},
|
||||
* 取它<b>之后</b>第一个 {@code Long 变量名}("之后"必须留、"第一个"也必须留:
|
||||
* {@code ShopManageController.page} 的 {@code Long page}/{@code Long pageSize}/{@code Long groupId}
|
||||
* 全排在公司参数前面,整窗抓最后一个就抓错人了)。
|
||||
* <p>窗口里没有显式 {@code name=} 的那一支(驼峰静默失效,断言 B 已经为它判红)退回"窗口里第一条
|
||||
* 带公司 token 的非文档行"取同一个名字。<b>取的是源码里那个名字,不是 {@link #CAMEL_PARAM} 常量</b>:
|
||||
* 有的页把它叫 {@code orgId},写死就会在合规页上假红(改名为 orgId 的探针就是这条的反面证据)。
|
||||
* <p>返回 {@code null} = 公司参数不是 {@code … Long x} 那一形,由 {@link #companyIdArgFailure()} 判红
|
||||
* 并报形状,不许"当作这支没收公司参数"静默放过;窗口本身取不到的那一支由结构守卫负责,D 不重复报。</p>
|
||||
*/
|
||||
String boundCompanyParam() {
|
||||
List<String> window = declarationWindow();
|
||||
if (window == null) {
|
||||
return null;
|
||||
}
|
||||
String joined = String.join("\n", window);
|
||||
Matcher anchor = EXPLICIT_COMPANY_NAME.matcher(joined);
|
||||
if (anchor.find()) {
|
||||
return firstLongDeclaration(joined.substring(anchor.end()));
|
||||
}
|
||||
for (String line : window) {
|
||||
if (hasCompanyToken(line) && !isDocLine(line)) {
|
||||
String name = firstLongDeclaration(line);
|
||||
if (name != null) {
|
||||
return name;
|
||||
}
|
||||
}
|
||||
}
|
||||
return null;
|
||||
}
|
||||
|
||||
/** {@code Long 变量名} 的第一个命中;窗口里根本没有 {@code Long} 型参数就取不到(返回 null)。 */
|
||||
private static String firstLongDeclaration(String declarationText) {
|
||||
Matcher declared = COMPANY_PARAM_DECL.matcher(declarationText);
|
||||
return declared.find() ? declared.group(1) : null;
|
||||
}
|
||||
|
||||
/**
|
||||
* 断言 D:被绑定到 {@code company_id} 的那个变量名,必须作为<b>整词实参</b>出现在这一支 handler
|
||||
* 体内某一次 {@code readScope}/{@code resolveScope} 调用的参数表里(单层括号,复用
|
||||
* {@link #CALL_ARGUMENTS} 的形状,与 A/B/C 同一个 handler 窗口)。
|
||||
* <ul>
|
||||
* <li>{@code dataReadScope.readScope(operator, companyId)} ⇒ 绿;</li>
|
||||
* <li>{@code resolveScope(request, companyId)}(私有收口方法内部再去 readScope)⇒ 绿;</li>
|
||||
* <li>{@code dataReadScope.readScope(operator, null)} ⇒ <b>红</b>;</li>
|
||||
* <li>{@code readScope(operator, operator.getCompanyId())} ⇒ <b>红</b>:源里那个名字是
|
||||
* {@code CompanyId}(大写 C,整词判据大小写敏感,咬不住它);而 {@link #CALL_ARGUMENTS}
|
||||
* 只吃单层括号,看不穿 {@code readScope(operator, normalize(companyId))} 这种嵌套写法 ——
|
||||
* 两种都落在"没进参数表"那一侧(后者是会误伤合规写法的已知形状,见类注释第 11 条与本轮报告);</li>
|
||||
* <li>只在 {@code if (companyId != null)} 里读一次、或只在 {@code @Operation} 文案里提一句
|
||||
* ⇒ <b>红</b>:控制语句关键字沿用 {@link #NOT_VALUE_CONSUMERS} 那把尺子(与 C 同源,不放宽),
|
||||
* 而注释与文档行根本进不到 {@link #text()} 里。</li>
|
||||
* </ul>
|
||||
* <p>返回 {@code null} = 公司参数确实交给了出口;否则返回红因片段,由调用方拼上 handler 名。
|
||||
*/
|
||||
String companyIdArgFailure() {
|
||||
String bound = boundCompanyParam();
|
||||
if (bound == null) {
|
||||
return " 认不出被绑定到 company_id 的变量名(断言 D 只认 @RequestParam(name = \"company_id\") … "
|
||||
+ "Long 变量名 那一形),这支的公司参数是怎么进出口的无从判定 —— 必须人工核对,"
|
||||
+ "不许当作\"这支没收公司参数\"静默放过";
|
||||
}
|
||||
Matcher call = CALL_ARGUMENTS.matcher(text());
|
||||
Pattern use = Pattern.compile("(?<!\\w)" + Pattern.quote(bound) + "(?!\\w)");
|
||||
while (call.find()) {
|
||||
String callee = call.group(1);
|
||||
// 与 C 同一条纪律:控制语句读它一次不算"把值交给谁";D 只认出口那两个被调名。
|
||||
if (NOT_VALUE_CONSUMERS.contains(callee) || !SCOPE_CALLEES.contains(callee)) {
|
||||
continue;
|
||||
}
|
||||
if (use.matcher(call.group(2)).find()) {
|
||||
return null;
|
||||
}
|
||||
}
|
||||
return " 的公司参数 `" + bound + "` 没进任何 readScope/resolveScope 的实参列表"
|
||||
+ "(`readScope(operator, null)`、`readScope(operator, operator.getCompanyId())` 就是这个形状:"
|
||||
+ "参数收下了、出口也调了、算出来的范围也交出去了,唯独 tab 传下来的那个值被换成了别的来源"
|
||||
+ " ⇒ 接口 200、页面正常、切 tab 数字永远不动,而 A/B/C 三条全绿没人喊)";
|
||||
}
|
||||
}
|
||||
|
||||
/** 源码行:{@code text} 已 trim(口径同仓内既有过滤器),{@code indent} 保留原始缩进(块边界靠它收口)。 */
|
||||
|
||||
Reference in New Issue
Block a user