1. 概述
在本教程中,我们将简要解释为什么直接测试私有方法通常不是一个好主意。然后,我们将演示如何在必要时在Java中测试私有方法。
2. 为什么我们不应该测试私有方法
通常,我们编写的单元测试应该只检查我们的公共方法契约。私有方法是我们公共方法的调用者不知道的实现细节。此外,改变我们的实现细节不应导致我们更改测试。
一般来说,敦促测试私有方法会突出以下问题之一:
- 我们的私有方法中有死代码
- 我们的私有方法太复杂,应该属于另一个类
- 我们的方法一开始并不意味着是私有的
因此,当我们觉得需要测试一个私有方法时,我们真正应该做的是解决底层设计问题。
3. 示例:从私有方法中删除死代码
让我们展示一个简单的例子。
我们将编写一个私有方法,它返回Integer的双倍值。对于null值,我们希望返回null:
private static Integer doubleInteger(Integer input) {
if (input == null) {
return null;
}
return 2 * input;
}
现在,让我们编写我们的公共方法,这将是类外的唯一入口点。
此方法接收一个Integer作为输入,它验证此整数不为空;否则,它会抛出一个IllegalArgumentException。之后,它调用私有方法返回双倍的Integer值:
public static Integer validateAndDouble(Integer input) {
if (input == null) {
throw new IllegalArgumentException("input should not be null");
}
return doubleInteger(input);
}
让我们遵循我们的良好做法并测试我们的公共方法契约。
首先,让我们编写一个测试,以确保在输入为null时抛出IllegalArgumentException:
@Test
void givenNull_WhenValidateAndDouble_ThenThrows() {
assertThrows(IllegalArgumentException.class, () -> validateAndDouble(null));
}
现在让我们检查一个非空整数是否正确加倍:
@Test
void givenANonNullInteger_WhenValidateAndDouble_ThenDoublesIt() {
assertEquals(4, validateAndDouble(2));
}
让我们来看看JaCoCo插件报告的覆盖率:
如我们所见,我们的单元测试未涵盖私有方法中的null检查。那我们应该测试它吗?
答案是不。重要的是要明白,我们的私有方法并不存在于真空中。只有在我们的公共方法中验证数据后才会调用它。因此,我们的私有方法中的null检查永远不会到达;它是死代码,应该被删除。
4. 如何在Java中测试私有方法
假设我们没有气馁,让我们解释一下如何具体测试我们的私有方法。
为了测试它,如果我们的私有方法具有另一种可见性,那将会很有帮助。好消息是我们将能够用反射来模拟它。
我们的封装类称为Utils。这个想法是访问名为doubleInteger的私有方法,它接收一个Integer作为参数。然后我们将修改它的可见性,使其可从Utils类外部访问。让我们看看如何做到这一点:
private Method getDoubleIntegerMethod() throws NoSuchMethodException {
Method method = Utils.class.getDeclaredMethod("doubleInteger", Integer.class);
method.setAccessible(true);
return method;
}
现在我们可以使用这个方法了。让我们编写一个测试来确保给定一个null对象,我们的私有方法返回null。我们需要将该方法应用于将为null的参数:
@Test
void givenNull_WhenDoubleInteger_ThenNull() throws InvocationTargetException, IllegalAccessException, NoSuchMethodException {
assertEquals(null, getDoubleIntegerMethod().invoke(null, new Integer[]{null}));
}
让我们进一步解释一下invoke方法的用法。第一个参数是我们应用该方法的对象,由于doubleInteger是静态的,我们传入了一个null。第二个参数是一个参数数组,在这种情况下,我们只有一个参数,它是null。
最后,让我们演示一下如何测试非空输入的情况:
@Test
void givenANonNullInteger_WhenDoubleInteger_ThenDoubleIt() throws NoSuchMethodException, InvocationTargetException, IllegalAccessException {
assertEquals(74, getDoubleIntegerMethod().invoke(null, 37));
}
5. 总结
在本文中,我们了解了为什么测试私有方法通常不是一个好主意。然后我们演示了如何使用反射来测试Java中的私有方法。
与往常一样,本教程的完整源代码可在GitHub上获得。