fix(分页台账): 通知 /groups 两个新端点按出站点登记——台账 48→52、页码口径 21→23
这红是我自己引入的,不是别人的尺子坏了:本批给 AdminNotificationController 与 NotificationController 各加了一个 /groups 端点、都带 page/pageSize 默认值, PageDefaultsLedgerTest 的"新加分页参数没登记也会红"当场判红。差值可核对: 实扫 53 处数字型 defaultValue = 23 页码 + 30 条数 + 1 处非分页(timeout_minutes), 比台账多的正是我这 4 处;page=FIRST_PAGE 从 21 长到 23 同因。 修法走测试作者留的那条正路("加页要登记,改值要表态"):逐条登记 4 处 + 同步两个 死值(hasSize 52、页码计数 23)+ PageDefaults 注释里的 49/21/28 一起改,不留会说谎 的描述。没摘 defaultValue、没动任何默认数值 ⇒ 翻页行为零变化。 验证=PageDefaultsLedgerTest 6/6 绿(在 detached 出包树实跑);反向变异 KILLED——摘掉 刚登记的那条 page 后该类 1 failed,还原后 md5 与变异前一致,主树未被写变异。 欠一条更正:上一轮汇报的"后端全绿"实为只跑了通知面 66 用例;后端全量是这次出包才跑的, 这两条红当时就该暴露。
This commit is contained in:
@@ -5,7 +5,7 @@ package com.nanri.aiimage.common.api;
|
||||
* {@code defaultValue} 里 15/20/50/1000 四种并存,31 处魔法数)。
|
||||
*
|
||||
* <p><b>这里没有"全局统一默认页容量"这一说,而且是故意的。</b>
|
||||
* 实测 49 处数字型 {@code defaultValue}(21 处页码 + 28 处条数)分属不同的真实用途:
|
||||
* 实测 53 处数字型 {@code defaultValue}(23 处页码 + 30 处条数)分属不同的真实用途:
|
||||
* 用户端列表、超管台、任务历史、扫描上限、导出取全量——把它们拍成一个值是<b>改行为</b>,
|
||||
* 不是清理。本类只做一件事:让每个数字有一个说明它<i>为什么是这个数</i>的名字,
|
||||
* 并让"同一个用途冒出第二个默认值"变成判据红({@code PageDefaultsLedgerTest})。
|
||||
@@ -21,9 +21,9 @@ public final class PageDefaults {
|
||||
private PageDefaults() {
|
||||
}
|
||||
|
||||
// ---- 页码:21 处全是 1,这一族本来就是单一口径 ----
|
||||
// ---- 页码:23 处全是 1,这一族本来就是单一口径 ----
|
||||
|
||||
/** 起始页码。全树 21 处分页入口一致取 1(不是 0);改这个数等于把所有列表第一页翻空。 */
|
||||
/** 起始页码。全树 23 处分页入口一致取 1(不是 0);改这个数等于把所有列表第一页翻空。 */
|
||||
public static final String FIRST_PAGE = "1";
|
||||
|
||||
/** {@link #FIRST_PAGE} 的数字镜像。 */
|
||||
|
||||
+11
-5
@@ -18,7 +18,7 @@ import org.junit.jupiter.api.Test;
|
||||
* 分页/条数默认值的<b>逐点台账 + 棘轮</b>(2026-10-09 评审「可读 5.0 / 交互 5.5」项 5)。
|
||||
*
|
||||
* <p>评审量到的是"15/20/50/1000 四种并存、31 处 {@code defaultValue}"。本轮实测更细:
|
||||
* 数字型 {@code defaultValue} 共 <b>49</b> 处,其中 48 处是分页/条数口径(21 处页码 + 27 处容量与上限),
|
||||
* 数字型 {@code defaultValue} 共 <b>53</b> 处,其中 52 处是分页/条数口径(23 处页码 + 29 处容量与上限),
|
||||
* 另有 1 处是 {@code timeout_minutes=30},不是分页。
|
||||
*
|
||||
* <p>这里<b>不规定"全局统一默认页容量"</b>——把 15/20/50/1000 拍成一个数是改行为。判据只做两件事:
|
||||
@@ -39,7 +39,7 @@ class PageDefaultsLedgerTest {
|
||||
|
||||
/**
|
||||
* 出站点台账:{@code 文件#参数 -> 该页当前默认值的具名出处}。
|
||||
* 48 条,逐条对应一次真实翻页行为;加页要登记,改值要表态。
|
||||
* 52 条,逐条对应一次真实翻页行为;加页要登记,改值要表态。
|
||||
*/
|
||||
private static final List<String> LEDGER = List.of(
|
||||
"AdminUserController.java#page=FIRST_PAGE",
|
||||
@@ -54,6 +54,9 @@ class PageDefaultsLedgerTest {
|
||||
"AdminImageVideoTaskController.java#page_size=ADMIN_LIST_PAGE_SIZE",
|
||||
"AdminNotificationController.java#page=FIRST_PAGE",
|
||||
"AdminNotificationController.java#pageSize=ADMIN_LIST_PAGE_SIZE",
|
||||
// (本批 /groups 端点:参数名与默认值和列表端点同,台账按出站点计数、不去重)
|
||||
"AdminNotificationController.java#page=FIRST_PAGE",
|
||||
"AdminNotificationController.java#pageSize=ADMIN_LIST_PAGE_SIZE",
|
||||
"AppearancePatentController.java#limit=DEFAULT_RESULT_LIMIT",
|
||||
"CollectDataController.java#page=FIRST_PAGE",
|
||||
"CollectDataController.java#page_size=TASK_LIST_PAGE_SIZE",
|
||||
@@ -66,6 +69,9 @@ class PageDefaultsLedgerTest {
|
||||
"InvalidAsinDataController.java#page_size=USER_LIST_PAGE_SIZE",
|
||||
"NotificationController.java#page=FIRST_PAGE",
|
||||
"NotificationController.java#pageSize=ADMIN_LIST_PAGE_SIZE",
|
||||
// (本批 /groups 端点:参数名与默认值和列表端点同,台账按出站点计数、不去重)
|
||||
"NotificationController.java#page=FIRST_PAGE",
|
||||
"NotificationController.java#pageSize=ADMIN_LIST_PAGE_SIZE",
|
||||
"PriceTrackController.java#page=FIRST_PAGE",
|
||||
"PriceTrackController.java#page_size=FULL_EXPORT_PAGE_SIZE",
|
||||
"ProductCategoryController.java#page=FIRST_PAGE",
|
||||
@@ -101,10 +107,10 @@ class PageDefaultsLedgerTest {
|
||||
List<String> constants = actual.stream().filter(s -> !s.contains("LITERAL")).sorted().toList();
|
||||
|
||||
assertThat(constants)
|
||||
.as("48 处分页/条数出站点的具名默认值必须与台账一一对应")
|
||||
.as("52 处分页/条数出站点的具名默认值必须与台账一一对应")
|
||||
.isEqualTo(LEDGER.stream().sorted().toList());
|
||||
// 同口径非零对照:台账不是空的,扫描器也确实数得出 48 处
|
||||
assertThat(constants).hasSize(48);
|
||||
assertThat(constants).hasSize(52);
|
||||
}
|
||||
|
||||
@Test
|
||||
@@ -120,7 +126,7 @@ class PageDefaultsLedgerTest {
|
||||
List<String> actual = sites();
|
||||
assertThat(kindsUsing(actual, "page", "FIRST_PAGE"))
|
||||
.as("页码口径只有一套:全部从 1 起")
|
||||
.isEqualTo(21);
|
||||
.isEqualTo(23);
|
||||
assertThat(distinctConstants(actual, "page_size"))
|
||||
.as("page_size 的默认容量集合:15/20/50/1000 四种各自登记,新来第五种要红")
|
||||
.containsExactlyInAnyOrder("USER_LIST_PAGE_SIZE", "ADMIN_LIST_PAGE_SIZE",
|
||||
|
||||
Reference in New Issue
Block a user