CDI-Unit框架全面指南：简化CDI应用单元测试

什么是CDI-Unit

CDI-Unit是一个专门为Java CDI（Contexts and Dependency Injection）应用设计的单元测试框架。它通过简化CDI容器的启动和配置过程，让开发者能够专注于业务逻辑的测试，而不必搭建完整的应用环境。

快速入门

基础配置

要使用CDI-Unit进行测试，只需在测试类上添加@RunWith(CdiRunner.class)注解：

@RunWith(CdiRunner.class)
class MyServiceTest {
    @Inject
    MyService service; // 测试运行前会自动注入
    
    @Test
    void testServiceOperation() {
        // 测试逻辑
    }
}

依赖配置

在项目中添加以下依赖：

<!-- CDI-Unit核心库 -->
<dependency>
    <groupId>io.github.cdi-unit</groupId>
    <artifactId>cdi-unit</artifactId>
    <version>5.0.0</version>
    <scope>test</scope>
</dependency>

<!-- Weld SE实现 -->
<dependency>
    <groupId>org.jboss.weld.se</groupId>
    <artifactId>weld-se-core</artifactId>
    <version>3.1.8.Final</version>
    <scope>test</scope>
</dependency>

核心功能详解

1. 控制CDI环境

当CDI无法自动发现某些类时，可以使用以下注解显式添加：

@AdditionalClasses({ServiceA.class, ServiceB.class}) // 添加特定类
@AdditionalPackages("com.example.services") // 添加整个包
class MyTest {
    // ...
}

2. 使用模拟对象(Mock)

CDI-Unit与Mockito和EasyMock深度集成：

@RunWith(CdiRunner.class)
class OrderServiceTest {
    @Produces @Mock
    PaymentGateway gateway; // 创建模拟对象
    
    @Inject
    OrderService service;
    
    @Test
    void testProcessOrder() {
        // 配置模拟行为
        Mockito.when(gateway.process(any())
               .thenReturn(SUCCESS);
        
        service.processOrder(new Order());
        
        // 验证交互
        Mockito.verify(gateway).process(any());
    }
}

3. 使用替代方案(Alternatives)

测试时可以使用替代实现：

@Alternative
class TestPaymentGateway implements PaymentGateway {
    // 测试专用实现
}

@RunWith(CdiRunner.class)
@ActivatedAlternatives(TestPaymentGateway.class)
class PaymentTest {
    // 将注入TestPaymentGateway而非实际实现
}

4. 作用域支持

CDI-Unit支持请求、会话等作用域：

@RequestScoped
class UserSession {
    // 请求作用域bean
}

@RunWith(CdiRunner.class)
class SessionTest {
    @Inject
    ContextController contextController;
    
    @Test
    @InRequestScope
    void testRequestScopedBean() {
        // 在请求作用域内执行测试
    }
}

高级特性

1. EJB支持

通过@SupportEjb注解启用EJB功能：

@RunWith(CdiRunner.class)
@SupportEjb
class EjbTest {
    @EJB(beanName = "myService")
    MyService service;
}

2. 资源注入支持

使用@SupportResource启用资源注入：

@RunWith(CdiRunner.class)
@SupportResource
class ResourceTest {
    @Resource
    DataSource ds;
}

3. DeltaSpike集成

支持DeltaSpike各个模块：

@SupportDeltaspikeJpa
@SupportDeltaspikeData
@RunWith(CdiRunner.class)
class JpaTest {
    @Inject
    UserRepository repository;
}

4. JAX-RS支持

通过@SupportJaxRs注解启用：

@RunWith(CdiRunner.class)
@SupportJaxRs
class RestTest {
    @Inject
    MyRestResource resource;
}

最佳实践

1. 隔离测试：每个测试类应专注于单一功能点
2. 合理使用Mock：只Mock外部依赖，不Mock被测代码内部组件
3. 作用域管理：明确测试方法的作用域需求
4. 版本兼容性：确保CDI-Unit、Weld和Java版本匹配

常见问题解决

问题1：测试时遇到未满足的依赖

• 解决方案：使用@AdditionalClasses添加缺失的类

问题2：作用域bean无法注入

• 解决方案：添加对应的作用域注解如@InRequestScope

问题3：替代实现未生效

• 检查是否使用了@ActivatedAlternatives或@ProducesAlternative

CDI-Unit通过简化CDI测试环境配置，显著提高了测试效率和代码质量。合理运用其各种特性，可以构建出既全面又高效的测试套件。