单元测试工具包（Test）

YMP 框架的单元测试工具包，集成了 JUnit 5 和 JUnit 4 的测试开发支持，分别提供了对应的单测、套件扩展类及专属注解与使用方式，封装了核心工具类 YMPTestUtils 统一管理应用初始化逻辑，同时给出了两类 JUnit 版本下模拟控制器请求、存储器接口调用和组合单元测试的具体使用示例，整体支持依赖注入、测试生命周期管理、Bean 工厂注册等功能。

Maven包依赖

<dependency>
    <groupId>net.ymate.platform</groupId>
    <artifactId>ymate-platform-test</artifactId>
    <version>2.1.4</version>
</dependency>

功能说明

JUnit 5 支持

YMPJUnit5Extension

功能特点：

实现了 TestInstanceFactory 接口，支持通过 YMP 容器创建测试实例
实现了 ParameterResolver 接口，支持在测试方法中注入 IApplication 参数
实现了 AfterAllCallback 接口，支持测试完成后清理缓存和销毁应用
使用 WeakReference 管理应用缓存，避免内存泄漏
自动注册测试类到 YMP 的 Bean 工厂，支持依赖注入
完善的应用生命周期管理，测试执行完毕后自动销毁应用

使用方法：

通过 @ExtendWith(YMPJUnit5Extension.class) 注解启用
支持标准的 JUnit 5 生命周期注解（@BeforeAll、@AfterAll、@BeforeEach、@AfterEach）
支持 @Inject 注解进行依赖注入

测试参数解析：

@ExtendWith(YMPJUnit5Extension.class)
@EnableAutoScan
public class ExampleTest {

    @Test
    public void testWithApplication(IApplication application) {
        // 直接使用注入的 IApplication 实例
        Assertions.assertNotNull(application);
    }
}

说明：ParameterResolver 仅解析 IApplication（含其实现类/子类型，如 YMP）类型的参数，其它类型的测试方法参数会抛 ParameterResolutionException；普通 Bean 请使用 @Inject 字段注入。

依赖注入注意事项：

@Inject 的目标 Bean 必须是独立的类文件。扫描器会显式过滤类名含 $ 的内部类（XxxTest$DemoUserService），因此写成测试类内部类的 @Bean 不会被注册，注入结果为 null。
扫描范围：@EnableAutoScan 未指定 value 时，扫描根包取「主类所在包」并递归包含子包；测试场景由 YMPTestUtils 将系统属性 ymp.mainClass 设为测试类本身，所以默认扫描范围即为测试类所在包及其子包。Bean 放在其它包时，可用 @EnableAutoScan(value = {"com.example.service"}) 显式扩大范围。
若确实需要非同包类或特殊类作为 Bean，可通过 YMPTestUtils.InitConfig#setTestClasses 或直接调用 beanFactory.registerBean(...) 显式注册。
getBean(Class) 对未注册的类返回 null，断言时务必先用 Assertions.assertNotNull(...)，避免 null == null 造成的假通过。
测试类会以单例形式注册到 Bean 工厂（BeanMeta.create(clazz, true)），JUnit 默认 PER_METHOD 生命周期下各测试方法共用同一个测试实例，请勿在测试类中放置可变状态字段。

YMPJUnit5Suite

功能特点：

基于 JUnit 5 的 @Suite 注解，支持组合多个测试类
使用独立的 YMPJUnit5SuiteExtension 扩展，确保 YMP 应用仅初始化一次
支持批量注册多个测试类到 YMP 的 Bean 工厂
提供线程安全的初始化机制
完善的应用生命周期管理，整个测试套件执行完毕后自动销毁应用

使用方法：

通过 @YMPJUnit5Suite({TestClass1.class, TestClass2.class}) 注解指定测试类
支持标准的 YMP 配置注解（@EnableAutoScan、@EnableBeanProxy、@EnableDevMode 等）

JUnit 4 支持

YMPJUnit4ClassRunner

功能特点：

实现了 JUnit 4 的 Runner 接口，为单个测试类提供 YMP 集成
使用 YMPTestUtils 统一管理应用初始化，减少代码重复
自动初始化 YMP 应用并注册测试类到 Bean 工厂
支持依赖注入和测试生命周期管理
完善的应用生命周期管理，测试执行完毕后自动销毁应用

使用方法：

通过 @RunWith(YMPJUnit4ClassRunner.class) 注解启用
支持标准的 JUnit 4 生命周期注解（@BeforeClass、@AfterClass、@Before、@After）

YMPJUnit4Suite

功能特点：

基于 JUnit 4 的 Suite 运行器，支持组合多个测试类
使用独立的 YMPJUnit4RunnerBuilder 类管理测试运行，提高代码可读性
确保 YMP 应用在测试套件执行前正确初始化
支持批量注册测试类到 YMP 的 Bean 工厂
完善的应用生命周期管理，整个测试套件执行完毕后自动销毁应用

使用方法：

通过 @RunWith(YMPJUnit4Suite.class) 和 @SuiteClasses({TestClass1.class, TestClass2.class}) 注解指定测试类

核心工具类

YMPTestUtils

功能特点：

统一管理 YMP 应用初始化逻辑，减少代码重复
提供 InitConfig 配置类，支持自定义应用初始化参数
支持为单个测试类或测试套件初始化 YMP 应用
优化异常处理机制，提供更详细的错误信息

使用方法：

// 为单个测试类初始化应用
IApplication application = YMPTestUtils.initializeYMP(testClass);

// 为测试套件初始化应用
IApplication application = YMPTestUtils.initializeYMP(suiteClass, testClasses);

// 自定义初始化配置
IApplication application = YMPTestUtils.initializeYMP(new YMPTestUtils.InitConfig()
        .setMainClassName("com.example.TestMain")
        .setTestClasses(Arrays.asList(TestClass1.class, TestClass2.class))
        .setSystemProperties(Collections.singletonMap("ymate.test.env", "dev")));

示例代码

JUnit 5 使用示例

示例一：模拟控制器方法请求

@ExtendWith(YMPJUnit5Extension.class)
@EnableAutoScan
@EnableBeanProxy
@EnableDevMode
public class LoginControllerTest {

    @Inject
    private WebMVC webmvc;

    @BeforeAll
    public static void setUpClass() {
    }

    @AfterAll
    public static void tearDownClass() {
    }

    @BeforeEach
    public void setUp() {
    }

    @AfterEach
    public void tearDown() {
    }

    @Test
    public void testLogin() throws Exception {
        MockHttpServletResponse response = MockWebRequestHelper.create(webmvc)
            .post("/login")
            .parameter("uname", "admin")
            .parameter("passwd", DigestUtils.md5Hex("admin"))
            .parameter("format", "json")
            .doFilter();
        Assertions.assertEquals(HttpServletResponse.SC_OK, response.getStatus());
        JsonWrapper jsonWrapper = JsonWrapper.fromJson(response.getContentAsString());
        Assertions.assertNotNull(jsonWrapper);
        System.out.println(jsonWrapper.getAsJsonObject().toString(true, true));
    }
}

示例二：存储器接口方法调用

@ExtendWith(YMPJUnit5Extension.class)
@EnableAutoScan
@EnableBeanProxy
@EnableDevMode
public class SystemConfigRepositoryTest {

    @Inject
    private JDBC database;

    @Inject
    private ISystemConfigRepository repository;

    @BeforeAll
    public static void setUpClass() {
    }

    @AfterAll
    public static void tearDownClass() {
    }

    @BeforeEach
    public void setUp() {
    }

    @AfterEach
    public void tearDown() {
    }

    @Test
    public void testQuerySystemConfigs() throws Exception {
        SystemConfigBean systemConfigBean = SystemConfigBean.builder()
            .siteId("ymate.net")
            .build();
        IResultSet<SystemConfigVO> systemConfigs = repository.querySystemConfigs(database, systemConfigBean, Page.create());
        Assertions.assertNotNull(systemConfigs);
    }
}

示例三：组合单元测试

@YMPJUnit5Suite({
    LoginControllerTest.class,
    SystemConfigRepositoryTest.class
})
@EnableAutoScan
@EnableBeanProxy
@EnableDevMode
public class ControllersTest {

    @BeforeAll
    public static void setUpClass() {
    }

    @AfterAll
    public static void tearDownClass() {
    }

    @BeforeEach
    public void setUp() {
    }

    @AfterEach
    public void tearDown() {
    }
}

JUnit 4 使用示例

示例一：模拟控制器方法请求

@RunWith(YMPJUnit4ClassRunner.class)
@EnableAutoScan
@EnableBeanProxy
@EnableDevMode
public class LoginControllerTest {

    @Inject
    private WebMVC webmvc;

    @BeforeClass
    public static void setUpClass() {
    }

    @AfterClass
    public static void tearDownClass() {
    }

    @Before
    public void setUp() {
    }

    @After
    public void tearDown() {
    }

    @Test
    public void testLogin() throws Exception {
        MockHttpServletResponse response = MockWebRequestHelper.create(webmvc)
            .post("/login")
            .parameter("uname", "admin")
            .parameter("passwd", DigestUtils.md5Hex("admin"))
            .parameter("format", "json")
            .doFilter();
        Assert.assertEquals(HttpServletResponse.SC_OK, response.getStatus());
        JsonWrapper jsonWrapper = JsonWrapper.fromJson(response.getContentAsString());
        Assert.assertNotNull(jsonWrapper);
        System.out.println(jsonWrapper.getAsJsonObject().toString(true, true));
    }
}

示例二：存储器接口方法调用

@RunWith(YMPJUnit4ClassRunner.class)
@EnableAutoScan
@EnableBeanProxy
@EnableDevMode
public class SystemConfigRepositoryTest {

    @Inject
    private JDBC database;

    @Inject
    private ISystemConfigRepository repository;

    @BeforeClass
    public static void setUpClass() {
    }

    @AfterClass
    public static void tearDownClass() {
    }

    @Before
    public void setUp() {
    }

    @After
    public void tearDown() {
    }

    @Test
    public void testQuerySystemConfigs() throws Exception {
        SystemConfigBean systemConfigBean = SystemConfigBean.builder()
            .siteId("ymate.net")
            .build();
        IResultSet<SystemConfigVO> systemConfigs = repository.querySystemConfigs(database, systemConfigBean, Page.create());
        Assert.assertNotNull(systemConfigs);
    }
}

示例三：组合单元测试

@RunWith(YMPJUnit4Suite.class)
@SuiteClasses({
    LoginControllerTest.class,
    SystemConfigRepositoryTest.class
})
@EnableAutoScan
@EnableBeanProxy
@EnableDevMode
public class ControllersTest {

    @BeforeClass
    public static void setUpClass() {
    }

    @AfterClass
    public static void tearDownClass() {
    }

    @Before
    public void setUp() {
    }

    @After
    public void tearDown() {
    }
}

Maven包依赖​

功能说明​

JUnit 5 支持​

YMPJUnit5Extension​

YMPJUnit5Suite​

JUnit 4 支持​

YMPJUnit4ClassRunner​

YMPJUnit4Suite​

核心工具类​

YMPTestUtils​

示例代码​

JUnit 5 使用示例​

示例一：模拟控制器方法请求​

示例二：存储器接口方法调用​

示例三：组合单元测试​

JUnit 4 使用示例​

示例一：模拟控制器方法请求​

示例二：存储器接口方法调用​

示例三：组合单元测试​

Maven包依赖

功能说明

JUnit 5 支持

YMPJUnit5Extension

YMPJUnit5Suite

JUnit 4 支持

YMPJUnit4ClassRunner

YMPJUnit4Suite

核心工具类

YMPTestUtils

示例代码

JUnit 5 使用示例

示例一：模拟控制器方法请求

示例二：存储器接口方法调用

示例三：组合单元测试

JUnit 4 使用示例

示例一：模拟控制器方法请求

示例二：存储器接口方法调用

示例三：组合单元测试