Quellcode durchsuchen

docs(进件): Task 3 修复轮 3 - 三处 javadoc 失实句订正(零行为改动)

修复轮 3 只改注释文字:不动夹具、不动 labelsIn、不动任何断言与方法体。
修的是修复轮 2 自己写出的两句新假话,以及一句前两轮都没查出来的旧全称句。

1. 夹具数组 javadoc(HEAD :1615)「……这一类就都红了」说宽了。反例:把两条标签的文案**互换**
   (商户签约负责人 ↔ 商户签约负责人电话,两者都是生产真有的标签,见 LsyMerchantRequiredFields:194-195)
   —— 每个期望标签仍原样留在文案里(落在 :1613 那个定义内),而计数仍 26、集合相等
   ⇒ 新旧判据都绿,与同一段 :1605 的「排列不参与断言」十行之内自相矛盾。
   真话更窄:单条标签文案的改动都会红(改长/加尾巴/换名字/换成另一个期望标签),
   不红的只有多条协同、净效果是一次置换的改动。

2. 同段「这是取舍不是疏忽:要让它对尾巴钝感,就得放弃『数量相等』这一半」把因果说反了。
   labelsIn(现 :1939-1943)不剥尾巴:它取第一个全角冒号之后 split("、", -1);而它自己举的那个尾巴
   (……对私账户身份证反面照片。请补全后重试)不含顿号、又粘在末项上 ⇒ 切出来仍是 26 项
   ⇒ createMerchant_missingRequiredFields_throws400ListingAll 里那条条数断言(:1571-1573)本来就绿、
   红的是挨着它的集合断言(:1574-1575)⇒ 光放弃「数量相等」救不了这个假红。
   改写成一对照的逆否:要逐字钉住末项,就必然把「末项粘了任何东西」判成不等;反过来,
   要让末项兼容**任意**后缀就等于放弃逐字钉住它,那时「末项被改长」与「被加尾巴」不可分辨。

3. 同段「—— 而『多一个』与『26 个都在、另有一个重复』这两种恰好只有数量能抓」半真半假:
   重复族那半是真的,逐字保留;「这两种」的并列是假的 —— 期望外多一项时集合也不等、两半都会红。
   改成:计数那一半独有的检出一族只有一族(所有期望标签都在、多出来的都是已有项的副本);
   「多一个期望外的标签」与「少一个」不是这一族,两半都会红。

验证:git diff 15 行(12+/3-)全部落在 javadoc 行(无代码行 / 断言行 / 夹具项);
LsyOnboardingServiceTest 改前 57 绿、改后 57 绿;
.class sha256 c64b2a31… → e07183bd…(本仓 -g 打开,LineNumberTable 进 class),
javap -c -p -l 差异 238 行、非「line N:」= 0;javap -v 差异 242 行、非「line N:」仅 2 行
(javap 自身的 Classfile 路径与 SHA-256 头);常量池逐行相同;
正对照:改前 class 最大行号 1933 / 改后 1942(差 +9 = 源文件 1935 → 1944 行)。
alphaH vor 3 Wochen
Ursprung
Commit
25437f55c9

+ 12 - 3
java/src/test/java/com/payment/platform/module/payment/leshouying/service/LsyOnboardingServiceTest.java

@@ -1612,7 +1612,10 @@ class LsyOnboardingServiceTest {
      * ★ 「一条是另一条的前缀」**不是** {@code contains} 唯一放过的一种 —— 它只是**这一类**里的一个成因:
      * 凡是**改了标签文案、却让每个期望标签仍然原样留在文案里**的改动,这组断言都放过 —— 把某条
      * **标签**改长({@code 商户客服电话} → {@code 商户客服电话(座机或手机)})或给它**加尾巴**
-     * 同样如此。换成「按顿号切回来、数量与集合都比」之后,这一类就都红了。
+     * 同样如此。换成「按顿号切回来、数量与集合都比」之后,判据钉的是「26 项**且**集合相等」⇒
+     * **单条**标签文案的改动都会红(改长 / 加尾巴 / 换名字 / 换成另一个期望标签都一样);
+     * 不红的只有**多条协同**、净效果是一次**置换**的改动 —— 例:把「商户签约负责人」与
+     * 「商户签约负责人电话」两条的文案**互换**(计数仍 26、集合相等;顺序本来就不参与断言,见上)。
      *
      * <p>★ 切分这个判据的两个前提(改本数组或改文案构造时要一起看):① 标签里不含顿号「、」
      * (用例里有断言,含了就红);② 文案的构造是「进件必填项缺失(共 N 项):」+
@@ -1621,8 +1624,14 @@ class LsyOnboardingServiceTest {
      * (例:{@code ……对私账户身份证反面照片。请补全后重试})时 26 个标签一个不缺,红的却是
      * 「标签清单必须与期望的 26 个逐字相同」;同族还有 {@code ):} 后加空格(首项多一个前导空格)、
      * 前缀改写引入**更早**的冒号({@code labelsIn} 切在第一个「:」上,切出来的位置就变了)。
-     * 这是**取舍不是疏忽**:要让它对尾巴钝感,就得放弃「数量相等」这一半 —— 而「多一个」与
-     * 「26 个都在、另有一个重复」这两种恰好只有数量能抓(集合相等时它们仍然不同)。
+     * 这是**取舍不是疏忽**:这条尾巴不含顿号、又粘在**末项**上 ⇒ 切出来仍是 26 项 ⇒
+     * {@code createMerchant_missingRequiredFields_throws400ListingAll} 里那条**条数**断言本来就绿、
+     * 红的是挨着它的**集合**断言 ⇒ 光放弃「数量相等」救不了它。要逐字钉住末项,就必然把
+     * 「末项粘了任何东西」判成不等 —— 反过来,要让末项兼容**任意**后缀就等于放弃逐字钉住它,
+     * 那时「末项被改长」与「被加尾巴」不可分辨。
+     * ★ 计数那一半**确有**独有的检出一族:所有期望标签都在、多出来的**都是已有项的副本**
+     * (例:「26 个都在、另有一个重复」;集合相等、多重集不等 ⇒ 只有计数会红);
+     * 「多一个**期望外**的标签」与「少一个」不是这一族 —— 那时集合也不等,两半都会红。
      */
     private static final String[] MERCHANT_MICRO_MISSING_LABELS = {
             "商户名称",