《Java单元测试实战》——案例集锦:Java单元测试典型案例集锦(2) https://developer.aliyun.com/article/1232057?groupCode=java
三、 如何测试虚基类和子类
在这次单元测试比赛中,很多选手都编写了虚基类,但是没有看到任何一个选手针对虚基类进行了单独的测试。
1. 案例代码
这里,以Diamond属性配置加载为例说明。
1) 虚基类定义
首先,定义一个通用的虚基类,定义了需要子类实现的虚方法,实现了通用的配置解析方法。
/** * 虚属性回调类 * * @param <T> 配置类型 */ @Slf4j public abstract class AbstractPropertiesCallback<T> implements DiamondDataCallback { /** 注入依赖对象 */ /** 环境 */ @Autowired private Environment environment; /** 转化服务 */ @Autowired private ConversionService conversionService; /** * 接收到数据 * * @param data 配置数据 */ @Override public void received(String data) { // 获取配置参数 String configName = getConfigName(); Assert.notNull(configName, "配置名称不能为空"); T configInstance = getConfigInstance(); Assert.notNull(configInstance, "配置实例不能为空"); // 解析配置数据 try { log.info("绑定属性配置文件开始: configName={}", configName); Properties properties = new Properties(); byte[] bytes = Optional.ofNullable(data.getBytes()).orElseGet(() -> new byte[0]); InputStream inputStream = new ByteArrayInputStream(bytes); BufferedReader bufferedReader = new BufferedReader(new InputStreamReader(inputStream)); properties.load(bufferedReader); Bindable<T> bindable = Bindable.ofInstance(configInstance); Binder binder = new Binder(ConfigurationPropertySources.from( new PropertiesPropertySource(configName, properties)), new PropertySourcesPlaceholdersResolver(environment), conversionService); BindResult<T> result = binder.bind(configName, bindable); if (!result.isBound()) { log.error("绑定属性配置文件失败: configName={}", configName); return; } log.info("绑定属性配置文件成功: configName={}, configInstance={}", configName, JSON.toJSONString(configInstance)); } catch (IOException | RuntimeException e) { log.error("绑定属性配置文件异常: configName={}", configName, e); } } /** * 获取配置名称 * * @return 配置名称 */ @NonNull protected abstract String getConfigName(); /** * 获取配置实例 * * @return 配置实例 */ @NonNull protected abstract T getConfigInstance(); }
2) 子类实现
其次,定义了具体配置的子类,简单地实现了基类定义的虚方法。
2. 方法1:联合测试法(不推荐)
最简单的测试方法,就是通过子类对虚基类进行联合测试,这样同时把子类和虚基类都测试了。
/** * 例子配置回调测试类 */ @RunWith(MockitoJUnitRunner.class) public class ExampleConfigCallbackTest { /** 定义静态常量 */ /** 资源路径 */ private static final String RESOURCE_PATH = "testExampleConfigCallback/"; /** 模拟依赖对象 */ /** 配置环境 */ @Mock private ConfigurableEnvironment environment; /** 转化服务 */ @Mock private ConversionService conversionService; /** 定义测试对象 */ /** BOSS取消费配置回调 */ @InjectMocks private ExampleConfigCallback exampleConfigCallback; /** * 测试: 接收-正常 */ @Test public void testReceivedWithNormal() { // 模拟依赖对象 ExampleConfig exampleConfig = new ExampleConfig(); Whitebox.setInternalState(exampleConfigCallback, "exampleConfig", exampleConfig); // 调用测试方法 String text = ResourceHelper.getResourceAsString(getClass(), RESOURCE_PATH + "exampleConfig.properties"); exampleConfigCallback.received(text); // 验证依赖对象 text = ResourceHelper.getResourceAsString(getClass(), RESOURCE_PATH + "exampleConfig.json"); Assert.assertEquals("取消费用配置不一致", text, JSON.toJSONString(exampleConfig, SerializerFeature.MapSortField)); } }
3. 方法2:独立测试法(推荐)
其实,更好的方法是对虚基类和子类独立单元测试。
1) 基类测试
虚基类的单元测试,专注于虚基类的通用配置解析。
/** * 虚属性回调测试类 */ @RunWith(MockitoJUnitRunner.class) public class AbstractPropertiesCallbackTest { /** 静态常量相关 */ /** 资源目录 */ private static final String RESOURCE_PATH = "testAbstractPropertiesCallback/"; /** 模拟依赖对象 */ /** 环境 */ @Mock private ConfigurableEnvironment environment; /** 转化服务 */ @Mock private ConversionService conversionService; /** 定义测试对象 */ /** 虚属性回调 */ @InjectMocks private AbstractPropertiesCallback<ExampleConfig> propertiesCallback = CastUtils.cast(Mockito.spy(AbstractPropertiesCallback.class)); /** * 测试: 接收到-正常 */ @Test public void testReceivedWithNormal() { // 模拟依赖方法 // 模拟依赖方法: propertiesCallback.getConfigName String configName = "example"; Mockito.doReturn(configName).when(propertiesCallback).getConfigName(); // 模拟依赖方法: propertiesCallback.getConfigInstance ExampleConfig configInstance = new ExampleConfig(); Mockito.doReturn(configInstance).when(propertiesCallback).getConfigInstance(); // 调用测试方法 String text1 = ResourceHelper.getResourceAsString(getClass(), RESOURCE_PATH + "exampleConfig.properties"); propertiesCallback.received(text1); String text2 = ResourceHelper.getResourceAsString(getClass(), RESOURCE_PATH + "exampleConfig.json"); Assert.assertEquals("任务配置不一致", text2, JSON.toJSONString(configInstance)); // 验证依赖方法 // 验证依赖方法: propertiesCallback.received Mockito.verify(propertiesCallback).received(text1); // 验证依赖方法: propertiesCallback.getConfigName Mockito.verify(propertiesCallback).getConfigName(); // 验证依赖方法: propertiesCallback.getConfigInstance Mockito.verify(propertiesCallback).getConfigInstance(); } }
2) 子类测试
子类的单元测试,专注于对虚基类定义虚方法的实现,避免了每个子类都要针对虚基类的通用配置解析进行测试。
《Java单元测试实战》——案例集锦:Java单元测试典型案例集锦(4) https://developer.aliyun.com/article/1232055?groupCode=java