[译]Java将Powermock和Mockito搭配进行单元测试

本文为Powermock官方文档Mockito篇的中文翻译
原文：https://github.com/powermock/powermock/wiki/Mockito
翻译：却把清梅嗅

笔者的Android单元测试相关系列：

Android单元测试：Mockito使用详解
Android单元测试：使用本地数据测试Retrofit
Android单元测试：测试RxJava的同步及异步操作
Java 将Powermock和Mockito搭配进行单元测试
Android 自动化测试 Espresso篇：简介&基础使用
Android 自动化测试 Espresso篇：异步代码测试

简介

Powermock提供了基础的PowerMockito类，你仍然可以通过初始化 mock/object/class 并配置它们的校验、期望行为、或者其他，以达到通过Mockito配置和验证你的预期（例如times(), anyInt()）的目的。

所有的操作都需要再Class层级上配置 @RunWith(PowerMockRunner.class) 和 @PrepareForTest 注解

版本支持

image.png

用法

---

在下面的示例中，我们不对Mockito或PowerMockito API中的方法使用静态导入的方式，这便于我们观察实际代码是如何被测试的。 但是，我们强烈建议您静态导入方法的方式，以提高可读性。

请注意：Mockito团队在2.1.0的版本中增加了mock final 类型Class/Methods 的能力。 PowerMock 1.7.0版本之后支持此功能（请使用Mockito 2.8.9进行测试）。 使用PowerMock配置可以启用该功能。 如果您使用Mockito 2，建议使用Mockito来mock final 类型Class/Methods。

Mock 静态方法

下面的代码将展示如何Mock以及打桩（stub）：

1.添加 @PrepareForTest 注解在你的Class层级上。

@PrepareForTest(Static.class) // Static.class contains static methods

2.调用PowerMockito.mockStatic() 以mock静态类（使用PowerMockito.spy(class) 来mock制定的方法）.

PowerMockito.mockStatic(Static.class);

3.使用Mockito.when()配置你的期望：

Mockito.when(Static.firstStaticMethod(param)).thenReturn(value);

注意：如果需要模拟java系统/ bootstrap类加载器（在java.lang或java.net等中定义的类）加载的类，则需要调用[this]（Mock-System）方法。

如何验证行为

想要验证静态方法是否被执行完毕，通过以下两个步骤：

1.首先，调用 PowerMockito.verifyStatic(Static.class) 来开始验证行为；
2.然后调用 Static.class 的静态方法进行验证。

例如：

PowerMockito.verifyStatic(Static.class); // 1
Static.firstStaticMethod(param); // 2

重要：对于每一个方法的验证，你都需要去调用 verifyStatic(Static.class)方法。

如何使用参数匹配器

Mockito的匹配器依然被应用在了PowerMock 的mock行为中，下面的代码讲述如何为每个被mock的静态方法使用自定义的参数匹配器：

PowerMockito.verifyStatic(Static.class);
Static.thirdStaticMethod(Mockito.anyInt());

如何验证方法被调用的准确次数

你仍然可以使用Mockito.VerificationMode (e.g Mockito.times(x)) 通过PowerMockito.verifyStatic(Static.class, Mockito.times(2))的方式验证。

PowerMockito.verifyStatic(Static.class, Mockito.times(1));

如何为返回值为Void类型的静态方法抛出异常

如果不是Private修饰的方法，则：

PowerMockito.doThrow(new ArrayStoreException("Mock error")).when(StaticService.class);
StaticService.executeMethod();

注意，您可以对final修饰的 类和方法 执行相同的操作:

PowerMockito.doThrow(new ArrayStoreException("Mock error")).when(myFinalMock).myFinalMethod();

对于Private的方法，请使用PowerMockito.when()，比如:

when(tested, "methodToExpect", argument).thenReturn(myReturnValue);

一个完整的案例，讲述了如何mock、打桩以及验证静态方法

@RunWith(PowerMockRunner.class)
@PrepareForTest(Static.class)
public class YourTestCase {
    @Test
    public void testMethodThatCallsStaticMethod() {
        // mock all the static methods in a class called "Static"
        PowerMockito.mockStatic(Static.class);
        // use Mockito to set up your expectation
        Mockito.when(Static.firstStaticMethod(param)).thenReturn(value);
        Mockito.when(Static.secondStaticMethod()).thenReturn(123);

        // execute your test
        classCallStaticMethodObj.execute();

        // Different from Mockito, always use PowerMockito.verifyStatic(Class) first
        // to start verifying behavior
        PowerMockito.verifyStatic(Static.class, Mockito.times(2));
        // IMPORTANT:  Call the static method you want to verify
        Static.firstStaticMethod(param);


        // IMPORTANT: You need to call verifyStatic(Class) per method verification, 
        // so call verifyStatic(Class) again
        PowerMockito.verifyStatic(Static.class); // default times is once
        // Again call the static method which is being verified 
        Static.secondStaticMethod();

        // Again, remember to call verifyStatic(Class)
        PowerMockito.verifyStatic(Static.class, Mockito.never());
        // And again call the static method. 
        Static.thirdStaticMethod();
    }
}

局部Mock

您可以通过使用PowerMockito.spy来局部mock一个方法，请注意（以下内容取自Mockito文档并同样适用于PowerMockito）：

有时，你并不能使用默认的 when(..)方法为spies打桩，例如：

List list = new LinkedList();
List spy = spy(list);
//Impossible: real method is called so spy.get(0) throws IndexOutOfBoundsException (the list is yet empty)
when(spy.get(0)).thenReturn("foo");

//You have to use doReturn() for stubbing
doReturn("foo").when(spy).get(0);

如何验证行为

你只需要使用 Mockito.vertify() 进行默认的校验：

Mockito.verify(mockObj, times(2)).methodToMock();

如何校验private的行为

使用 PowerMockito.verifyPrivate(), 比如：

verifyPrivate(tested).invoke("privateMethodName", argument1);

这种方式同样适用于private 的静态方法。

如何对对象的创建进行mock

使用 PowerMockito.whenNew(), 比如：

whenNew(MyClass.class).withNoArguments().thenThrow(new IOException("error message"));

请注意，您必须准备类creating用于测试的新MyClass实例，而不是MyClass本身。 (翻译无能，请参考下面的举例...)

比如说，如果执行new MyClass()的类被称为X，那么你必须执行@PrepareForTest(X.class)以使whenNew工作：

@RunWith(PowerMockRunner.class)
@PrepareForTest(X.class)
public class XTest {
        @Test
        public void test() {
                whenNew(MyClass.class).withNoArguments().thenThrow(new IOException("error message"));

                X x = new X();
                x.y(); // y is the method doing "new MyClass()"
               
                ..
        }
}

如何验证新对象的实例化

使用 PowerMockito.verifyNew :

verifyNew(MyClass.class).withNoArguments();

如何使用参数匹配器

Mockito的匹配器依然被应用在了PowerMock中：

Mockito.verify(mockObj).methodToMock(Mockito.anyInt());  

译者注: 以参数匹配器为例，官方文档似乎重复讲了两次，实际上，这两处分别针对静态方法和普通的方法进行了分开的阐述，对于静态方法，我们只能通过PowerMock的API进行校验，但是对于普通的成员方法，使用Mockito提供的API即可。

一个完整讲述了Spy的案例：

@RunWith(PowerMockRunner.class)
// We prepare PartialMockClass for test because it's final or we need to mock private or static methods
@PrepareForTest(PartialMockClass.class)
public class YourTestCase {
    @Test
    public void spyingWithPowerMock() {        
        PartialMockClass classUnderTest = PowerMockito.spy(new PartialMockClass());

        // use Mockito to set up your expectation
        Mockito.when(classUnderTest.methodToMock()).thenReturn(value);

        // execute your test
        classUnderTest.execute();

        // Use Mockito.verify() to verify result
        Mockito.verify(mockObj, times(2)).methodToMock();
    }
}

一个完整讲述了对Private方法的局部Mock的案例（PowerMock 1.3.6+版本后提供的支持）：

@RunWith(PowerMockRunner.class)
// We prepare PartialMockClass for test because it's final or we need to mock private or static methods
@PrepareForTest(PartialMockClass.class)
public class YourTestCase {
    @Test
    public void privatePartialMockingWithPowerMock() {        
        PartialMockClass classUnderTest = PowerMockito.spy(new PartialMockClass());

        // use PowerMockito to set up your expectation
        PowerMockito.doReturn(value).when(classUnderTest, "methodToMock", "parameter1");

        // execute your test
        classUnderTest.execute();

        // Use PowerMockito.verify() to verify result
        PowerMockito.verifyPrivate(classUnderTest, times(2)).invoke("methodToMock", "parameter1");
    }
}

更多信息

想了解更多，请查看GitHub中的source。

另请阅读Jayway团队博客中的PowerMockito相关[博客](http://blog.jayway.com/2009/10/28/untestable-code-with-mockito-and-powermock/）。

关于译者

却把清梅嗅
Github:https://github.com/qingmei2
CSDN:https://blog.csdn.net/mq2553299
：https://www.jianshu.com/u/df76f81fe3ff