kcode-pi 0.1.0

package/vendor/kingdee-skills/cosmic-unittest/patterns/formplugin.md

@@ -0,0 +1,235 @@
+# FormPlugin 表单插件测试模式
+
+## 适用范围
+
+`<模块组>-formplugin` 工程中继承以下基类的插件类：
+- `kd.bos.form.plugin.AbstractFormPlugin`（表单插件）
+- `kd.bos.list.plugin.AbstractListPlugin`（列表插件）
+- `kd.bos.bill.plugin.AbstractBillPlugin`（单据插件）
+
+这些插件在表单/列表/单据生命周期（打开、值更新、按钮点击等）的各阶段介入处理。
+
+## 测试文件位置
+
+```
+<模块组>-formplugin/src/test/java/kd/<包路径>/formplugin/{subpackage}/XxxPluginTest.java
+```
+
+与被测类保持相同的包路径。
+
+---
+
+## 基类与参数获取
+
+### 优先级链
+
+formplugin 测试的基类和参数获取遵循以下优先级：
+
+1. **优先从 BasePluginTest 获取**
+   - 在 `<模块组>-formplugin/src/test/java/` 下搜索 `BasePluginTest`
+   - 该基类封装了 AbstractFormPlugin 测试所需的通用参数和 mock 取値逻辑（如 IFormView、IDataModel、表单上下文等）
+
+2. **参考同包下已有测试类**
+   - 路径：`<模块组>-formplugin/src/test/java/kd/<包路径>/formplugin/` 及其子包
+   - 查找以 `Test` 结尾的类，参考其中的类似写法
+
+3. **降级到苍穹公共单测框架**
+   - 若以上均无可参考案例，使用苍穹公共单测框架
+   - **必须主动告知用户**缺失的取值逻辑，由用户补充到 BasePluginTest
+
+### 使用方式
+
+```java
+package kd.<包路径>.formplugin.subpackage;
+
+// 继承 BasePluginTest 获取通用 mock 和参数
+public class XxxPluginTest extends BasePluginTest<XxxPlugin> {
+    // BasePluginTest 已预置的 mock 和参数可直接使用
+    // 额外需要的 mock 在此声明
+}
+```
+
+---
+
+## 表单插件生命周期方法
+
+| 方法 | 触发时机 | 测试重点 |
+|------|---------|---------|
+| `afterCreateNewData` | 新建单据后 | 字段默认值设置 |
+| `afterLoadData` | 数据加载后 | 界面控件状态设置 |
+| `afterBindData` | 数据绑定后 | 控件可见性/可编辑性 |
+| `beforeDoOperation` | 操作执行前 | 前置校验逻辑 |
+| `propertyChanged` | 字段值变更 | 联动逻辑（switch/if 分支） |
+| `itemClick` | 按钮/菜单点击 | 按钮响应逻辑 |
+| `beforeClosed` | 表单关闭前 | 清理逻辑 |
+| `closedCallBack` | 子表单关闭回调 | 回调处理逻辑 |
+
+---
+
+## 模板结构
+
+```java
+package kd.<包路径>.formplugin.subpackage;
+
+import kd.bos.dataentity.entity.DynamicObject;
+import kd.bos.form.plugin.AbstractFormPlugin;
+import kd.bos.test.ext.annotaions.UnittestCaseInfo;
+import kd.bos.form.unittest.DisplayName;
+import kd.bos.unittest.mock.DynamicObjectMocker;
+import org.junit.After;
+import org.junit.Before;
+import org.junit.Test;
+import org.mockito.MockedStatic;
+import org.mockito.Mockito;
+
+import static org.junit.Assert.*;
+import static org.mockito.ArgumentMatchers.*;
+import static org.mockito.Mockito.*;
+
+public class XxxPluginTest extends BasePluginTest<XxxPlugin> {
+
+    // 1. 声明额外需要 Mock 的静态类（BasePluginTest 未覆盖的）
+    private MockedStatic<SomeHelper> someHelper;
+
+    @Before
+    public void before() {
+        // 若 BasePluginTest 有 @Before，调用 super.before()
+        someHelper = Mockito.mockStatic(SomeHelper.class);
+    }
+
+    @After
+    public void after() {
+        // 若 BasePluginTest 有 @After，调用 super.after()
+        someHelper.close();
+    }
+
+    // ========== propertyChanged 方法测试（switch 分支拆分）==========
+
+    @UnittestCaseInfo(
+        author = "<name> <<name>@kingdee.com>",
+        title = "Test propertyChanged when field is materialId",
+        targetClass = "kd.<包路径>.formplugin.subpackage.XxxPlugin",
+        targetMethod = "propertychanged",
+        lastUpdateTime = "yyyy-MM-dd HH:mm:ss",
+        lastUpdateAuthor = "<name> <<name>@kingdee.com>",
+        methodSignature = "public void propertyChanged(PropertyChangedArgs e)",
+        testPoints = {"Functionality"},
+        description = "Test propertyChanged switch case: materialId"
+    )
+    @Test
+    @DisplayName("propertyChanged - switch case: materialId 字段变更")
+    public void testPropertyChanged_CaseMaterialId() {
+        //step 构建 PropertyChangedArgs，fieldKey = "materialId"
+        // ... 使用 BasePluginTest 提供的方式构建参数
+
+        //step 执行被测方法
+        XxxPlugin plugin = new XxxPlugin();
+        // ... 设置插件上下文
+        // plugin.propertyChanged(args);
+
+        //assert 验证联动结果
+        // assertEquals(expectedValue, ...);
+    }
+
+    @UnittestCaseInfo(
+        author = "<name> <<name>@kingdee.com>",
+        title = "Test propertyChanged when field is qty",
+        targetClass = "kd.<包路径>.formplugin.subpackage.XxxPlugin",
+        targetMethod = "propertychanged",
+        lastUpdateTime = "yyyy-MM-dd HH:mm:ss",
+        lastUpdateAuthor = "<name> <<name>@kingdee.com>",
+        methodSignature = "public void propertyChanged(PropertyChangedArgs e)",
+        testPoints = {"Functionality"},
+        description = "Test propertyChanged switch case: qty"
+    )
+    @Test
+    @DisplayName("propertyChanged - switch case: qty 字段变更")
+    public void testPropertyChanged_CaseQty() {
+        //step 构建 PropertyChangedArgs，fieldKey = "qty"
+        // ...
+
+        //step 执行被测方法
+        // ...
+
+        //assert 验证联动结果
+        // ...
+    }
+
+    // ========== 判断分支覆盖（笛卡尔积）==========
+
+    @Test
+    @DisplayName("beforeDoOperation - 条件组合覆盖")
+    public void testBeforeDoOperation_ConditionCombinations() {
+        //step 条件组合1: status=A, hasEntry=true -> 允许操作
+        // ...
+        //assert
+        // ...
+
+        //step 条件组合2: status=A, hasEntry=false -> 阻止操作
+        // ...
+        //assert
+        // ...
+
+        //step 条件组合3: status=B, hasEntry=true -> 阻止操作
+        // ...
+        //assert
+        // ...
+
+        //step 条件组合4: status=B, hasEntry=false -> 阻止操作
+        // ...
+        //assert
+        // ...
+    }
+}
+```
+
+---
+
+## 特殊 Mock 要求
+
+> **DB 类 ClassPool defrost** 和 **ProcessSettleMockHelper** 是所有工程通用的特殊 Mock 规则，详见 SKILL.md 2.6 / 2.7 节。此处不再重复，formplugin 工程同样遵循。
+
+### MockedStatic 生命周期规则
+
+| 场景 | 方式 |
+|------|------|
+| 同一静态类在 > 1 个测试方法中使用 | 定义为**成员变量**，@Before 赋值，@After close |
+| 同一静态类仅在 1 个测试方法中使用 | 使用 **try-with-resources** 局部 mock |
+
+---
+
+## DynamicObject 断言规范
+
+对 DynamicObject 取值进行断言时的默认值规则：
+
+| 取值方法 | 默认值（字段未赋值时） | 断言写法 |
+|---------|---------------------|---------|
+| `getString(key)` | `""` (空字符串，不为 null) | `assertEquals("", obj.getString("field"))` |
+| `getLong(key)` | `0L` | `assertEquals(0L, obj.getLong("field"))` |
+| `getInt(key)` | `0` | `assertEquals(0, obj.getInt("field"))` |
+| `getBigDecimal(key)` | `BigDecimal.ZERO` | `assertEquals(BigDecimal.ZERO, obj.getBigDecimal("field"))` |
+| `getBoolean(key)` | `false` | `assertFalse(obj.getBoolean("field"))` |
+| `getDate(key)` | **可能为 null** | `assertNull(obj.getDate("field"))` 或具体日期值 |
+
+**原则：除 getDate 外，DynamicObject 的 getter 方法默认不返回 null，使用基本值断言。**
+
+---
+
+## 常量/枚举类引用规则
+
+- 测试代码中引用常量、枚举时，**必须使用原始常量类/枚举类的引用**（如 `StatusEnum.APPROVED`），而非字面值（如 `"A"`）
+- 若常量类/枚举类**无法找到**（如未在 classpath 中、编译报错等），**必须主动告知用户**，由用户补充：
+  - 文件路径
+  - 或完整源码
+- **禁止**忽略使用逻辑或用字面值替代
+
+---
+
+## 关键要点总结
+
+1. **基类优先级**：BasePluginTest -> 同包 *Test 类参考 -> 苍穹公共框架（缺失告知用户）
+2. **switch 必须拆方法**：propertyChanged / itemClick 等含 switch 的方法，每个 case 独立测试方法
+3. **判断分支笛卡尔积**：if/else 条件组合需全面覆盖，可合并到一个方法中
+4. **DB 类 / ProcessSettleMockHelper**：通用规则，详见 SKILL.md 2.6 / 2.7 节
+5. **DynamicObject 断言**：getString/getLong/getBigDecimal 等用基本值断言，getDate 除外
+6. **常量/枚举**：禁止字面值替代，找不到就告知用户

package/vendor/kingdee-skills/cosmic-unittest/patterns/op-plugin.md

@@ -0,0 +1,226 @@
+# OpPlugin 操作插件测试模式
+
+## 适用范围
+
+`<模块组>-opplugin` 工程中继承 `AbstractOperationServicePlugIn` 的操作插件类。
+操作插件在单据操作（保存/提交/审核等）的各生命周期阶段介入处理。
+
+## 测试文件位置
+
+```
+<模块组>-opplugin/src/test/java/kd/<包路径>/opplugin/{module}/XxxOpTest.java
+```
+
+## 操作插件生命周期方法
+
+| 方法 | 触发时机 | 测试重点 |
+|------|---------|---------|
+| `onPreparePropertys` | 准备加载字段 | 验证字段键列表 |
+| `onAddValidators` | 添加校验器 | 验证注册的校验器 |
+| `beforeExecuteOperationTransaction` | 事务前 | 验证前置逻辑 |
+| `beginOperationTransaction` | 事务开始 | 验证核心业务逻辑 |
+| `endOperationTransaction` | 事务结束 | 验证后置处理 |
+| `afterExecuteOperationTransaction` | 事务后 | 验证收尾逻辑 |
+
+## 基类选择
+
+| 场景 | 基类 |
+|------|------|
+| 简单操作插件 | `AbstractJunitNoDependenciesResManagerTest` |
+| 需要通用操作插件框架 | 继承 `OpBaseTest`（提供 registerOpPlugin 方法） |
+
+## 模板结构（直接方式）
+
+```java
+package kd.<包路径>.opplugin.modulename;
+
+import kd.bos.dataentity.OperateOption;
+import kd.bos.dataentity.entity.DynamicObject;
+import kd.bos.entity.operate.result.OperationResult;
+import kd.bos.entity.plugin.args.BeginOperationTransactionArgs;
+import kd.bos.form.unittest.DisplayName;
+import kd.bos.test.ext.annotaions.UnittestCaseInfo;
+import kd.bos.unittest.AbstractJunitNoDependenciesResManagerTest;
+import kd.bos.unittest.mock.DynamicObjectMocker;
+import org.junit.After;
+import org.junit.Before;
+import org.junit.Test;
+import org.mockito.MockedStatic;
+
+import static org.mockito.ArgumentMatchers.*;
+import static org.mockito.Mockito.*;
+
+public class XxxOpTest extends AbstractJunitNoDependenciesResManagerTest {
+
+    MockedStatic<SomeHelper> someHelper;
+    private BeginOperationTransactionArgs beginArgs;
+
+    @Before
+    public void before() {
+        someHelper = mockStatic(SomeHelper.class);
+
+        // 构建测试单据数据
+        DynamicObject[] bills = getBills();
+
+        // Mock BeginOperationTransactionArgs
+        beginArgs = mock(BeginOperationTransactionArgs.class);
+        when(beginArgs.getDataEntities()).thenReturn(bills);
+        when(beginArgs.getOperationKey()).thenReturn("save");
+    }
+
+    @After
+    public void after() {
+        someHelper.close();
+    }
+
+    public void reset() {
+        someHelper.reset();
+    }
+
+    private DynamicObject[] getBills() {
+        DynamicObject bill = new DynamicObjectMocker()
+            .add("id", 1L)
+            .add("billno", "TEST-001")
+            .add("billstatus", "A")
+            .getObject();
+        return new DynamicObject[]{bill};
+    }
+
+    @UnittestCaseInfo(
+        author = "<name> <<name>@kingdee.com>",
+        title = "Test begin operation transaction success",
+        targetClass = "kd.<包路径>.opplugin.modulename.XxxOp",
+        targetMethod = "beginoperationtransaction",
+        lastUpdateTime = "yyyy-MM-dd HH:mm:ss",
+        lastUpdateAuthor = "<name> <<name>@kingdee.com>",
+        methodSignature = "public void beginOperationTransaction(BeginOperationTransactionArgs e)",
+        testPoints = {"Functionality"},
+        description = "Test begin operation transaction success"
+    )
+    @Test
+    @DisplayName("测试事务开始：成功场景")
+    public void testBeginOperationTransaction_Success() {
+        //step 创建操作插件实例
+        OperationResult operation = mock(OperationResult.class);
+        when(operation.isSuccess()).thenReturn(true);
+
+        XxxOp op = new XxxOp() {
+            @Override
+            public OperationResult getOperationResult() {
+                return operation;
+            }
+        };
+        OperateOption option = OperateOption.create();
+        op.setContext(null, null, option);
+
+        //step 执行方法
+        op.beginOperationTransaction(beginArgs);
+
+        //assert 验证预期行为
+        someHelper.verify(() -> SomeHelper.someMethod(any()), times(1));
+        reset();
+    }
+}
+```
+
+## 使用 OpBaseTest 基类方式
+
+```java
+public class XxxOpTest extends OpBaseTest {
+
+    MockedStatic<SomeHelper> someHelper;
+
+    @Override
+    @Before
+    public void before() {
+        super.before();  // 初始化 MainEntityType
+        someHelper = mockStatic(SomeHelper.class);
+    }
+
+    @Override
+    @After
+    public void after() {
+        super.after();
+        someHelper.close();
+    }
+
+    @Override
+    protected AbstractOperationServicePlugIn buildOpPlugin() {
+        return new XxxOp();
+    }
+
+    @Override
+    protected DynamicObject[] buildData() {
+        return new DynamicObject[]{
+            new DynamicObjectMocker()
+                .add("id", 1L)
+                .add("billno", "TEST-001")
+                .getObject()
+        };
+    }
+
+    @Test
+    public void testPlugin() {
+        //step 注册操作插件（自动调用 onPreparePropertys 和 onAddValidators）
+        XxxOp op = registerOpPlugin();
+
+        //step 测试事务方法
+        BeginOperationTransactionArgs args = createBeginOperationTransactionArgs("save");
+        op.beginOperationTransaction(args);
+
+        //assert 验证结果
+        ...
+    }
+}
+```
+
+## OpBaseTest 提供的工具方法
+
+| 方法 | 返回值 | 说明 |
+|------|--------|------|
+| `registerOpPlugin()` | T (插件实例) | 注册并初始化操作插件 |
+| `createBeforeOperationArgs(opKey)` | BeforeOperationArgs | 创建事务前参数 |
+| `createBeginOperationTransactionArgs(opKey)` | BeginOperationTransactionArgs | 创建事务开始参数 |
+| `createEndOperationTransactionArgs(opKey)` | EndOperationTransactionArgs | 创建事务结束参数 |
+| `createAfterOperationArgs(opKey)` | AfterOperationArgs | 创建事务后参数 |
+| `getValidators()` | List | 获取注册的校验器列表 |
+| `getFieldKeys()` | List | 获取准备的字段键列表 |
+
+## 测试重写 getOperationResult 的技巧
+
+操作插件中经常需要根据 `getOperationResult()` 结果做不同处理，
+用匿名子类方式注入 Mock 的 OperationResult：
+
+```java
+XxxOp op = new XxxOp() {
+    @Override
+    public OperationResult getOperationResult() {
+        OperationResult result = mock(OperationResult.class);
+        when(result.isSuccess()).thenReturn(true);
+        return result;
+    }
+};
+```
+
+## try-with-resources 模式
+
+对于只在单个测试方法内使用的 MockedStatic，推荐 try-with-resources：
+
+```java
+@Test
+public void testMethod() {
+    try (MockedStatic<OperationHelper> operationHelper = mockStatic(OperationHelper.class);
+         MockedStatic<ProcessPlanHelper> processPlanHelper = mockStatic(ProcessPlanHelper.class)) {
+
+        //step 配置 Mock
+        operationHelper.when(() -> OperationHelper.validator(any())).thenReturn(resultMap);
+
+        //step 执行
+        op.beforeExecuteOperationTransaction(args);
+
+        //assert 验证
+        assertTrue(condition);
+    }
+    // MockedStatic 自动关闭
+}
+```

package/vendor/kingdee-skills/cosmic-unittest/patterns/validator.md

@@ -0,0 +1,206 @@
+# Validator 校验器测试模式
+
+## 适用范围
+
+`<模块组>-opplugin` 工程中 `Validator` 目录下的所有校验器类，
+即继承 `AbstractValidator` 的类。
+
+## 测试文件位置
+
+```
+<模块组>-opplugin/src/test/java/kd/<包路径>/opplugin/validator/XxxValidatorTest.java
+```
+
+## 核心思路
+
+校验器的 `validate()` 方法在数据不满足条件时会调用 `addMessage()` / `addErrorMessage()` 等方法。
+测试时通过**匿名子类**重写这些方法，将错误消息收集到 List 中，然后断言错误数量和内容。
+
+## 基类选择
+
+| 场景 | 基类 |
+|------|------|
+| 简单校验器（少量依赖） | 直接继承 `AbstractJunitNoDependenciesResManagerTest` |
+| 需要通用校验器框架 | 继承 `ValidatorBaseTest`（提供 registerValidator 方法） |
+
+## 模板结构（直接方式，推荐）
+
+```java
+package kd.<包路径>.opplugin.validator;
+
+import kd.bos.dataentity.entity.DynamicObject;
+import kd.bos.entity.ExtendedDataEntity;
+import kd.bos.entity.validate.ErrorLevel;
+import kd.bos.form.unittest.DisplayName;
+import kd.bos.test.ext.annotaions.UnittestCaseInfo;
+import kd.bos.unittest.AbstractJunitNoDependenciesResManagerTest;
+import kd.bos.unittest.mock.DynamicObjectMocker;
+import org.junit.After;
+import org.junit.Before;
+import org.junit.Test;
+import org.mockito.MockedStatic;
+import org.mockito.Mockito;
+
+import java.math.BigDecimal;
+import java.util.ArrayList;
+import java.util.List;
+
+import static org.mockito.ArgumentMatchers.*;
+
+public class XxxValidatorTest extends AbstractJunitNoDependenciesResManagerTest {
+
+    // 1. Mock 依赖的静态类
+    private MockedStatic<SomeHelper> someHelper;
+
+    // 2. 错误消息收集器
+    private final List<String> errorMessages = new ArrayList<>();
+    private final List<Integer> errorIndexs = new ArrayList<>();
+
+    @Before
+    public void before() {
+        someHelper = Mockito.mockStatic(SomeHelper.class);
+    }
+
+    @After
+    public void after() {
+        someHelper.close();
+    }
+
+    // 3. 构建校验器（匿名子类重写消息收集方法）
+    private XxxValidator buildValidator() {
+        return new XxxValidator() {
+            @Override
+            protected void addMessage(ExtendedDataEntity dataEntity, String content) {
+                errorIndexs.add(dataEntity.getDataEntityIndex());
+                errorMessages.add(content);
+            }
+            @Override
+            protected void addMessage(ExtendedDataEntity dataEntity, String content, ErrorLevel errorLevel) {
+                errorIndexs.add(dataEntity.getDataEntityIndex());
+                errorMessages.add(content);
+            }
+            @Override
+            protected void addErrorMessage(ExtendedDataEntity dataEntity, String content) {
+                errorIndexs.add(dataEntity.getDataEntityIndex());
+                errorMessages.add(content);
+            }
+            @Override
+            protected void addWarningMessage(ExtendedDataEntity dataEntity, String content) {
+                errorIndexs.add(dataEntity.getDataEntityIndex());
+                errorMessages.add(content);
+            }
+        };
+    }
+
+    // 4. 构建测试数据
+    private ExtendedDataEntity[] buildValidatorData() {
+        DynamicObject bill = new DynamicObjectMocker()
+            .add("id", 1L)
+            .add("billstatus", "A")
+            .add("entryentity", new DynamicObjectMocker()
+                .add("id", 10L)
+                .add("qty", BigDecimal.TEN)
+                .getCollection())
+            .getObject();
+
+        ExtendedDataEntity entity = new ExtendedDataEntity(bill, 0, 0);
+        return new ExtendedDataEntity[]{entity};
+    }
+
+    // 5. 测试方法
+    @UnittestCaseInfo(
+        author = "<name> <<name>@kingdee.com>",
+        title = "Test validate should pass",
+        targetClass = "kd.<包路径>.opplugin.Validator.XxxValidator",
+        targetMethod = "validate",
+        lastUpdateTime = "yyyy-MM-dd HH:mm:ss",
+        lastUpdateAuthor = "<name> <<name>@kingdee.com>",
+        methodSignature = "public void validate()",
+        testPoints = {"Functionality"},
+        description = "Test validate should pass"
+    )
+    @Test
+    @DisplayName("校验通过：数据满足所有条件")
+    public void testValidate_ShouldPass() {
+        //step 配置 Mock 返回值
+        someHelper.when(() -> SomeHelper.getData(any())).thenReturn(validData);
+
+        //step 构建校验器和数据
+        ExtendedDataEntity[] dataEntities = buildValidatorData();
+        XxxValidator validator = buildValidator();
+        validator.setDataEntities(dataEntities);
+
+        //step 执行校验
+        validator.validate();
+
+        //assert 无错误消息
+        assertEquals(0, errorMessages.size());
+    }
+
+    @Test
+    @DisplayName("校验失败：数据不满足条件")
+    public void testValidate_ShouldFail() {
+        //step 配置 Mock 返回值（构造不满足条件的数据环境）
+        someHelper.when(() -> SomeHelper.getData(any())).thenReturn(invalidData);
+
+        //step 构建校验器和数据
+        ExtendedDataEntity[] dataEntities = buildValidatorData();
+        XxxValidator validator = buildValidator();
+        validator.setDataEntities(dataEntities);
+
+        //step 执行校验
+        validator.validate();
+
+        //assert 应有错误消息
+        assertTrue(errorMessages.size() > 0);
+    }
+}
+```
+
+## 使用 ValidatorBaseTest 基类方式
+
+**两种方式的选择：**
+- **直接匿名子类**（上方模板）：适用于大多数场景，提供最大灵活性，可自由控制 Mock 和数据构造
+- **继承 ValidatorBaseTest**（本节）：适用于校验逻辑简单、仅需验证“是否报错”的场景，提供 `registerValidator()` / `getValidatorErrorMessages()` 等便捷方法，省去手动构建 ExtendedDataEntity 的样板代码
+
+当校验器测试逻辑较为简单且数据构造模式可复用时，推荐继承 `ValidatorBaseTest`：
+
+```java
+public class XxxValidatorTest extends ValidatorBaseTest {
+
+    @Override
+    protected AbstractValidator buildValidator() {
+        return new XxxValidator() {
+            @Override
+            protected void addErrorMessage(ExtendedDataEntity dataEntity, String content) {
+                addValidatorErrorMessage(content); // 基类提供的收集方法
+            }
+        };
+    }
+
+    @Override
+    protected DynamicObject[] buildData() {
+        return new DynamicObject[]{
+            new DynamicObjectMocker()
+                .add("id", 1L)
+                .add("status", "A")
+                .getObject()
+        };
+    }
+
+    @Test
+    public void testValidate() {
+        AbstractValidator validator = registerValidator("submit", "提交");
+        validator.validate();
+        assertEquals(0, getValidatorErrorMessages().size());
+    }
+}
+```
+
+## 关键要点
+
+1. **必须重写消息方法**：校验器的 `addMessage` / `addErrorMessage` 等方法是 protected 的，
+   必须通过匿名子类重写才能捕获校验结果
+2. **ExtendedDataEntity 包装**：校验器接收 `ExtendedDataEntity[]`，需要用 `new ExtendedDataEntity(dynamicObject, rowIndex, 0)` 包装
+3. **设置 entityKey**：部分校验器依赖 `getEntityKey()` 判断单据类型，需要调用 `validator.setEntityKey(formId)`
+4. **设置 operateKey**：部分校验器依赖操作类型，需调用 `validator.setOperateKey("submit")` 等