Android单元测试-Mockito的使用

申明依赖

testCompile"junit:junit:$rootProject.ext.junitVersion" testCompile"org.mockito:mockitoall:$rootProject.ext.mockitoVersion"
测试代码写在test 文件夹下
如果是这样:
androidTestCompile"junit:junit:$rootProject.ext.junitVersion" androidTestCompile "org.mockito:mockito-core:$rootProject.ext.mockitoVersion"
测试代码写在androidTest文件夹下

mockitoVersion = '1.10.19'```
###创建Mockito

@Before
public void setUp() {
MockitoAnnotations.initMocks(this);
}```

验证行为
method:
  • Mockito.verify() :验证Mock对象的方法是否被调用。
  • Mockito.times() :调用Mock对象的方法次数。
  • Mockito.atMost(count) , Mockito.atLeast(count) , Mockito.never() :最多次数,最少次数,永远调用。
  • Mockito.anyInt() , Mockito.anyLong() , Mockito.anyDouble()等等 : 参数设置-任意的Int类型,任意的Long类型。。。等。
//Let's import Mockito statically so that the code looks clearer 
import static org.mockito.Mockito.*; 
//mock creation 
List mockedList = mock(List.class); 
//using mock object
 mockedList.add("one");
 mockedList.clear(); 
//verification 
verify(mockedList).add("one"); 
verify(mockedList).clear();```
解读:
          *1*.mock一个List的到测试对象 
          *2*.verify(Object)调用add方法
          *3*.可以验证是否调用add方法是否被调用
>下面的描述来自 [Mock以及Mockito的使用](http://chriszou.com/2016/04/29/android-unit-testing-mockito.html)
>
```Mockito.verify(mockUserManager).performLogin("xiaochuang", "xiaochuang password");```
验证mockUserManager的performLogin()得到了调用,同时参数是“xiaochuang”和"xiaochuang password"。其实更准确的说法是,这行代码验证的是,mockUserManager的performLogin()方法得到了**一次**调用。因为这行代码其实是:
```Mockito.verify(mockUserManager,Mockito.times(1)).performLogin("xiaochuang","xiaochuang password");```
的简写,或者说重载方法,注意其中的`Mockito.times(1)`。因此,如果你想验证一个对象的某个方法得到了多次调用,只需要将次数传给`Mockito.times()`就好了。```Mockito.verify(mockUserManager,Mockito.times(3)).performLogin(...); 
//验证mockUserManager的performLogin得到了三次调用。```
对于调用次数的验证,除了可以验证固定的多少次,还可以验证最多,最少从来没有等等,方法分别是:atMost(count), atLeast(count), never()等等,都是Mockito的静态方法,其实大部分时候我们会static import Mockito这个类的所有静态方法,这样就不用每次加上Mockito.前缀了。本文下面我也按照这个规则。(其实我早就想说这句话啦,只是一直没找到好的时机[喜极而泣])
很多时候你并不关心被调用方法的参数具体是什么,或者是你也不知道,你只关心这个方法得到调用了就行。这种情况下,Mockito提供了一系列的any方法,来表示任何的参数都行:
**Mockito.verify(mockUserManager).performLogin(Mockito.anyString(),Mockito.anyString());**
**anyString(**)表示任何一个字符串都可以。null?也可以的!类似anyString,还有**anyInt, anyLong, anyDouble**等等。**anyObject**表示任何对象,**any(clazz)**表示任何属于clazz的对象。在写这篇文章的时候,我刚刚发现,还有非常有意思也非常人性化的**anyCollection,anyCollectionOf(clazz), anyList(Map, set), anyListOf(clazz)等等**。

#### 指定mock对象的某些方法的行为

LinkedList mockedList = mock(LinkedList.class);
when(mockedList.get(0)).thenReturn("first");
when(mockedList.get(1)).thenThrow(new RuntimeException());```
解读:

  • 默认情况下,所有方法都会返回值,一个 mock 将返回要么 null,一个原始/基本类型的包装值或适当的空集。例如,对于一个 int/Integer 就是 0,而对于 boolean/Boolean 就是 false。
  • 默认值 可以被覆盖。
  • 一旦 指定值,该方法将始终返回指定值,无论它有多少次被调用。
    如 when(mockedList.get(0)).thenReturn("first"); 调用mockedList.get(0)的时候,因为指定了返回值 thenReturn("first"); 所以返回的值就是指定值 first

怎么样指定一个方法执行特定的动作

下文均摘自 Mock以及Mockito的使用

  • doNothing() doAnswer() doThrow()

这个功能一般是用在目标的方法是void类型的时候。现在假设我们的LoginPresenter的login()方法是这样的:

public void loginCallbackVersion(String username, String password) { 
    if (username == null || username.length() == 0) return; 
    //假设我们对密码强度有一定要求,使用一个专门的validator来验证密码的有效性 
    if (mPasswordValidator.verifyPassword(password)) return; 
    //login的结果将通过callback传递回来。
     mUserManager.performLogin(username, password, new  NetworkCallback() { 
          @Override public void onSuccess(Object data) { 
              //update view with data
           }
           @Override public void onFailure(int code, String msg) {
             //show error msg
           }
     });
}

在这里,我们想进一步测试传给mUserManager.performLogin的NetworkCallback里面的代码,验证view得到了更新等等。在测试环境下,我们并不想依赖mUserManager.performLogin的真实逻辑,而是让mUserManager直接调用传入的NetworkCallback的onSuccess或onFailure方法。这种指定mock对象执行特定的动作的写法如下:
Mockito.doAnswer(desiredAnswer).when(mockObject).targetMethod(args);
传给doAnswer()的是一个Answer对象,我们想要执行什么样的动作,就在这里面实现。结合上面的例子解释:

Mockito.doAnswer(new Answer() {
     @Override
     public Object answer(InvocationOnMock invocation) throws Throwable { 
    //这里可以获得传给performLogin的参数 
    Object[] arguments = invocation.getArguments(); //callback是第三个参数
    NetworkCallback callback = (NetworkCallback) arguments[2]; 
    callback.onFailure(500, "Server error"); 
    return 500; 
    }
}).when(mockUserManager).performLogin(anyString(), anyString(),any(NetworkCallback.class));```
这里,当调用mockUserManager的performLogin方法时,会执行answer里面的代码,我们上面的例子是直接调用传入的callback的onFailure方法,同时传给onFailure方法500和"Server error"。
当然,使用Mockito.doAnswer()需要创建一个Answer对象,这有点麻烦,代码看起来也繁琐,如果想简单的指定目标方法“什么都不做”,那么可以使用Mockito.doNothing()。如果想指定目标方法“抛出一个异常”,那么可以使用Mockito.doThrow(desiredException)。如果你想让目标方法调用真实的逻辑,可以使用Mockito.doCallRealMethod()。(什么??? 默认不是会这样吗??? No! )

####Spy
Mock对象只能调用stubbed方法,调用不了它真实的方法。但Mockito可以监视一个真实的对象,这时对它进行方法调用时它将调用真实的方法,同时也可以stubbing这个对象的方法让它返回我们的期望值。另外不论是否是真实的方法调用都可以进行verify验证。和创建mock对象一样,对于final类、匿名类和Java的基本类型是无法进行spy的。 
**监视对象** 
监视一个对象需要调用spy(T object)方法,如:List spy = spy(new LinkedList());那么spy变量就在监视LinkedList实例。
 **被监视对象的Stubbing** 
stubbing被监视对象的方法时要慎用when(Object),如:  

List spy = spy(new LinkedList());
//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);

当调用when(spy.get(0)).thenReturn("foo")时,会调用真实对象的get(0),由于list是空的所以会抛出IndexOutOfBoundsException异常,用doReturn可以避免这种情况的发生,因为它不会去调用get(0)方法。 
下面是官方文档给出的例子: 

@Test
public void spyTest2() {

List list = new LinkedList();  
List spy = spy(list);  

//optionally, you can stub out some methods:  
when(spy.size()).thenReturn(100);  

//using the spy calls real methods  
spy.add("one");  
spy.add("two");  

//prints "one" - the first element of a list  
System.out.println(spy.get(0));  

//size() method was stubbed - 100 is printed  
System.out.println(spy.size());  

//optionally, you can verify  
verify(spy).add("one");  
verify(spy).add("two");   

} ```

推荐阅读更多精彩内容