cosmic-unittest 苍穹模块单元测试编写技能 v1.4

按需加载 pattern 文件

根据工程类型推荐只读取 1 个 pattern，避免全量加载：

并行全量读取

读取被测类源码后，以下全部同一轮并行发起：

智能 Mock 推断

从 import 自动匹配映射表，规则驱动取代经验驱动：

BaseTest Mock 继承去重

仅声明 BaseTest 未预置的 MockedStatic 差集：

public class SomeHelperTest extends BaseTest {
    // 仅声明 BaseTest 未预置的
    MockedStatic<ProcessPlanHelper> planHelper;

    @Before public void before() {
        super.before();  // 先触发 BaseTest
        planHelper = mockStatic(ProcessPlanHelper.class);
    }
    @After public void after() {
        planHelper.close();
        super.after();
    }
}

批量模式并行策略

同工程多被测类，最大化并行：

2.1 通用编写规则

2.2 @UnittestCaseInfo 注解规范

@UnittestCaseInfo(
    author = "<name> <<name>@kingdee.com>",
    // git config user.name 拼接邮箱
    title = "英文标题（简短描述测试目的）",
    targetClass = "被测类全限定名",
    targetMethod = "被测方法名（小写）",
    lastUpdateTime = "yyyy-MM-dd HH:mm:ss",
    lastUpdateAuthor = "<name> <<name>@kingdee.com>",
    methodSignature = "被测方法完整签名",
    testPoints = {"Functionality"},
    description = "英文描述"
)

2.3 测试方法注释规范

@Test
@DisplayName("中文描述：测试场景说明")
public void testMethodName_ScenarioDescription() {
    //step 准备测试数据 / 构建 Mock
    ...
    //step 执行被测方法
    ...
    //assert 断言结果
    ...
    reset(); // 如有 reset 方法
}

2.4–2.5 MockedStatic & DynamicObjectMocker

MockedStatic 生命周期

// 成员变量声明
MockedStatic<XxxHelper> xxxHelper;

@Before
public void before() {
    xxxHelper = mockStatic(XxxHelper.class);
}
@After
public void after() {
    xxxHelper.close(); // 推荐及时关闭！
}
public void reset() {
    xxxHelper.reset();
}

DynamicObjectMocker 链式构造

// 简单对象
DynamicObject obj = new DynamicObjectMocker()
    .add("id", 1L)
    .add("billno", "TEST-001")
    .getObject();

// 分录集合（用 getCollection）
DynamicObject bill = new DynamicObjectMocker()
    .add("entryentity", new DynamicObjectMocker()
        .add("qty", BigDecimal.TEN)
        .getCollection())
    .getObject();

[警告] 2.6 DB 类特殊 Mock（ClassPool Defrost）

DB 类存在字节码冻结问题，mock 前推荐先执行 defrost 处理：

@Before
public void before() {
    try {
        CtClass cls = ClassPool.getDefault()
            .get(DB.class.getName());
        if (cls.isFrozen()) {
            cls.defrost();
        }
    } catch (Exception e) {}
    dbMocked = Mockito.mockStatic(DB.class);
}

[警告] 2.7 ProcessSettleHelper 特殊 Mock

含分布式缓存，不可直接 mockStatic：

MockedStatic<ProcessSettleHelper> mock =
    ProcessSettleMockHelper
        .mockDistributeSessionlessCache();

2.8–2.10 高级 Mock 技巧

MockedConstruction（Mock 构造函数）

@Test
public void testMethod() {
  try (MockedConstruction<PushArgs> m =
       Mockito.mockConstruction(PushArgs.class)) {
    SomeUtil.doSomething(params);
    assertEquals(1, m.constructed().size());
  } // 自动关闭
}

thenAnswer 动态返回

helper.when(() -> QueryServiceHelper
    .query(anyString(), anyString(), any()))
  .thenAnswer(inv -> {
    String entity = inv.getArgument(0);
    if ("mmc_plan".equals(entity))
      return mockPlanData();
    return new DynamicObjectCollection();
  });

DynamicObject 断言规范

场景类型与边界值要求

边界值覆盖要求

switch / if-else 分支拆分策略

Step 4 — 验证与运行

gradle :<模块组>-common:test
gradle :<模块组>-business:test
gradle :<模块组>-opplugin:test
gradle :<模块组>-formplugin:test
# 例如 mmc-sfc 模块：
gradle :mmc-sfc-business:test

通用 BaseTest 发现规则

实际使用时推荐先读取目标工程的 BaseTest 源码，确认其预置了哪些 MockedStatic。

mmc-sfc 模块已知预置 Mock（参考）

三个工程（common/business/opplugin）共同预置 8 个 MockedStatic：OrgUnitServiceHelper、BillTypeParamHelper、ResManager、SystemParamServiceHelper、QueryServiceHelper、BusinessDataServiceHelper、OperationServiceHelper、BaseDataServiceHelper。

common 模块 — POJO 模式

public class XxxModelTest {
    private XxxModel model;

    @Before
    public void setUp() { model = new XxxModel(); }

    @UnittestCaseInfo(author = "...", ...)
    @Test
    public void testGetSetFieldName() {
        model.setFieldName("value");
        assertEquals("value", model.getFieldName());
    }

    @Test
    public void testDefaultValues() {
        // 输出字段默认为 ZERO，输入字段默认 null
        assertEquals(BigDecimal.ZERO, model.getAmount());
        assertNull(model.getFormId());
    }
}

business 模块 — Helper 模式

public class XxxHelperTest
    extends AbstractJunitNoDependenciesResManagerTest {

    MockedStatic<QueryServiceHelper> qsh;

    @Before public void before() {
        qsh = mockStatic(QueryServiceHelper.class);
    }
    @After public void after() { qsh.close(); }

    @UnittestCaseInfo(...)
    @Test
    @DisplayName("正常路径")
    public void testMethod_NormalCase() {
        qsh.when(() -> QueryServiceHelper.query(...))
            .thenReturn(mockData);
        Object result = XxxHelper.method(param);
        assertNotNull(result);
        reset();
    }
}

opplugin — Validator 模式

public class XxxValidatorTest
    extends AbstractJunitNoDependenciesResManagerTest {

    private final List<String> errors = new ArrayList<>();

    private XxxValidator buildValidator() {
        return new XxxValidator() {
            @Override
            protected void addErrorMessage(
                ExtendedDataEntity e, String msg) {
                errors.add(msg);
            }
        };
    }

    @Test
    public void testValidate_ShouldPass() {
        XxxValidator v = buildValidator();
        v.setDataEntities(buildData());
        v.validate();
        assertEquals(0, errors.size());
    }
}

formplugin — FormPlugin 模式

public class XxxPluginTest
    extends BasePluginTest<XxxPlugin> {

    private MockedStatic<SomeHelper> someHelper;

    @Before public void before() {
        someHelper = mockStatic(SomeHelper.class);
    }
    @After public void after() {
        someHelper.close();
    }

    // switch 每个 case 独立方法
    @Test
    public void testPropertyChanged_CaseMaterialId() { ... }
    @Test
    public void testPropertyChanged_CaseQty() { ... }
}