Mockito简明教程 on 重定向学院

（一）mock 与 Mockito 介绍

Sat, 25 Nov 2017 12:55:11 +0800

什么是mock ？

mock在翻译过来是模拟的意思。这里要介绍的mock是辅助单元测试的一个模块。它允许你用模拟对象来替换你的系统的部分，并对它们已使用的方式进行断言。

什么意思呢？说的直白些，我们要测试一个模块（类、方法或接口），但是这个模块还没有实现，或者它属于第三方模块，真的去调用会比较麻烦，这个时候就可以借助 mock 技术，给该模块设置预期结果。

可能你和我一样会有疑问，把要测试的模块都mock掉了，这不是自己骗自己嘛，那我们还测什么？

但是，在实际生产中的项目是非常复杂的，对其进行单元测试的时候，会遇到以下问题：

接口的依赖
外部接口调用
测试环境非常复杂

单元测试应该只针对当前单元进行测试, 所有的内部或外部的依赖应该是稳定的, 已经在别处进行测试过的.使用mock 就可以对外部依赖组件实现进行模拟并且替换掉，从而使得单元测试将焦点只放在当前的单元功能。

mock技术的目的和作用就是模拟一些在应用中不容易构造或者比较复杂的对象，从而把测试与测试边界以外的对象隔离开。

什么是 Mockito ?

官方网站：http://site.mockito.org/

Tasty mocking framework for unit tests in Java

优雅的mock框架用于Java的单元测试。

GitHub 地址：https://github.com/mockito/mockito

安装 Mockito

以 Maven 方式安装为例。

 <dependency>
 <groupId>org.mockito</groupId>
 <artifactId>mockito-all</artifactId>
 <version>2.0.2-beta</version>
 <scope>test</scope>
</dependency>

因为 Mockito是其于单元测试的框架，所以，接下来的练习最好在单元框架框架下运行，通过 Maven 配置 JUnit 单元测试框架。

<dependency>
 <groupId>junit</groupId>
 <artifactId>junit</artifactId>
 <version>4.12</version>
 <scope>test</scope>
</dependency>

原始封面

（二）验证某些行为

Sat, 25 Nov 2017 12:55:11 +0800

跟着我们的示例来mock 一个List,因为大家都知道它的接口（例如add(),get(), clear()）。不要mock一个真实的List类型,使用一个真实的实例来替代。

验证某些行为

例子：


import org.junit.Test;

import java.util.List;

 // 静态导入会使代码更简洁
import static org.mockito.Mockito.*;



public class MockitoDemo {

 @Test
 public void verify_behaviour() {
 // mock creation 创建mock对象
 List mockedList = mock(List.class);

 //using mock object 使用mock对象
 mockedList.add("one");
 mockedList.clear();

 //verification 验证
 verify(mockedList).add("one");
 verify(mockedList).clear();
 }

}

一旦mock对象被创建了，mock对象会记住所有的交互。然后你就可能选择性的验证你感兴趣的交互。

原始封面

（三）如何做一些测试桩 (Stub)

Sat, 25 Nov 2017 12:50:11 +0800

何做一些测试桩 (Stub)

例子：

import org.junit.Test;

import java.util.LinkedList;

import static org.mockito.Mockito.*;



public class MockitoDemo {



 @Test(expected = RuntimeException.class)
 public void when_thenReturn(){
 //You can mock concrete classes, not only interfaces
 // 你可以mock具体的类型,不仅只是接口
 LinkedList mockedList = mock(LinkedList.class);

 //stubbing
 // 测试桩
 when(mockedList.get(0)).thenReturn("first");
 when(mockedList.get(1)).thenThrow(new RuntimeException());

 //following prints "first"
 // 输出“first”
 System.out.println(mockedList.get(0));

 //following throws runtime exception
 // 抛出异常
 System.out.println(mockedList.get(1));

 //following prints "null" because get(999) was not stubbed
 // 因为get(999) 没有打桩，因此输出null
 System.out.println(mockedList.get(999));

 //Although it is possible to verify a stubbed invocation, usually it's just redundant
 //If your code cares what get(0) returns then something else breaks (often before even verify() gets executed).
 //If your code doesn't care what get(0) returns then it should not be stubbed. Not convinced? See here.
 // 验证get(0)被调用的次数
 verify(mockedList).get(0);
 }

}

默认情况下，所有的函数都有返回值。mock函数默认返回的是null，一个空的集合或者一个被对象类型包装的内置类型，例如0、false对应的对象类型为Integer、Boolean；

（四）参数匹配器 (matchers)

Sat, 25 Nov 2017 12:50:11 +0800

参数匹配器 (matchers)

Mockito以自然的java风格来验证参数值: 使用equals()函数。有时，当需要额外的灵活性时你可能需要使用参数匹配器，也就是argument matchers : 例子

import org.junit.Test;

import java.util.LinkedList;

import static org.mockito.Mockito.*;



public class MockitoDemo {

 @Test
 public void with_arguments(){

 LinkedList mockedList = mock(LinkedList.class);

 //stubbing using built-in anyInt() argument matcher
 // 使用内置的anyInt()参数匹配器
 when(mockedList.get(anyInt())).thenReturn("element");

 //following prints "element"
 // 输出element
 System.out.println(mockedList.get(1));

 //you can also verify using an argument matcher
 // 你也可以验证参数匹配器
 verify(mockedList).get(anyInt());
 }
}

参数匹配器使验证和测试桩变得更灵活。点击这里查看更多内置的匹配器以及自定义参数匹配器或者hamcrest 匹配器的示例。

（五）验证函数调用次数和顺序

Sat, 25 Nov 2017 12:45:11 +0800

验证函数调用次数

例子：

import java.util.LinkedList;
import static org.mockito.Mockito.*;


public class MockitoDemo {

 @Test
 public void verifying_number_of_invocations(){
 LinkedList mockedList = mock(LinkedList.class);
 //using mock
 mockedList.add("once");

 mockedList.add("twice");
 mockedList.add("twice");

 mockedList.add("three times");
 mockedList.add("three times");
 mockedList.add("three times");

 //following two verifications work exactly the same - times(1) is used by default
 // 下面的两个验证函数效果一样,因为verify默认验证的就是times(1)
 verify(mockedList).add("once");
 verify(mockedList, times(1)).add("once");

 //exact number of invocations verification
 // 验证具体的执行次数
 verify(mockedList, times(2)).add("twice");
 verify(mockedList, times(3)).add("three times");

 //verification using never(). never() is an alias to times(0)
 // 使用never()进行验证,never相当于times(0)
 verify(mockedList, never()).add("never happened");

 //verification using atLeast()/atMost()
 // 使用atLeast()/atMost()
 verify(mockedList, atLeastOnce()).add("three times");
 verify(mockedList, atLeast(2)).add("five times");
 verify(mockedList, atMost(5)).add("three times");
 }
}

verify函数默认验证的是执行了times(1)，也就是某个测试函数是否执行了1次.因此，times(1)通常被省略了。

（六） mockito 常用方法

Sat, 25 Nov 2017 12:40:11 +0800

doReturn()、doThrow()、doAnswer()、doNothing()、doCallRealMethod()系列方法的运用

通过when(Object)为无返回值的函数打桩有不同的方法,因为编译器不喜欢void函数在括号内…

使用doThrow(Throwable) 替换stubVoid(Object)来为void函数打桩是为了与doAnswer()等函数族保持一致性。

当你想为void函数打桩时使用含有一个exception 参数的doAnswer() :

import org.junit.Test;
import java.util.LinkedList;
import static org.mockito.Mockito.*;


public class MockitoDemo {

 @Test(expected = RuntimeException.class)
 public void when_doThrow() throws RuntimeException {

 LinkedList mockedList = mock(LinkedList.class);
 doThrow(new RuntimeException()).when(mockedList).clear();

 //following throws RuntimeException:
 // 下面的代码会抛出异常
 mockedList.clear();
 }
}

当你调用doThrow(), doAnswer(), doNothing(), doReturn() 和 doCallRealMethod() 这些函数时可以在适当的位置调用when()函数，例如下面这些功能时这是必须的:

测试void函数
在受监控的对象上测试函数
不知一次的测试为同一个函数，在测试过程中改变mock对象的行为。

但是在调用when()函数时你可以选择是否调用这些上述这些函数。

原始封面

（七）使用注解来快速模拟

Sat, 25 Nov 2017 12:35:11 +0800

在前面的测试中我们在每个测试方法里都mock了一个List对象，为了避免重复的mock，是测试类更具有可读性，我们可以使用下面的注解方式来快速模拟对象：

import org.junit.Test;
import org.mockito.Mock;
import static org.mockito.Mockito.*;

import java.util.List;

public class MockitoDemo2 {

 @Mock
 private List mockList;

 @Test
 public void shorthand(){
 mockList.add(1);
 verify(mockList).add(1);
 }
}

运行这个测试类你会发现报NullPointerException错，mock的对象为NULL，为此我们必须在基类中添加初始化mock的代码:

import org.junit.Test;
import org.mockito.Mock;
import org.mockito.MockitoAnnotations;

import static org.mockito.Mockito.*;

import java.util.List;

public class MockitoDemo2 {

 @Mock
 private List mockList;

 public MockitoDemo2(){
 MockitoAnnotations.initMocks(this);
 }

 @Test
 public void shorthand(){
 mockList.add(1);
 verify(mockList).add(1);
 }
}

或者使用built-in runner：MockitoJUnitRunner:

Mockito简明教程 on 重定向学院

（一）mock 与 Mockito 介绍

什么是mock ？

什么是 Mockito ?

安装 Mockito

（二）验证某些行为

验证某些行为

（三）如何做一些测试桩 (Stub)

何做一些测试桩 (Stub)

（四）参数匹配器 (matchers)

参数匹配器 (matchers)

（五） 验证函数调用次数和顺序

验证函数调用次数

（六） mockito 常用方法

doReturn()、doThrow()、doAnswer()、doNothing()、doCallRealMethod()系列方法的运用

（七） 使用注解来快速模拟

（五）验证函数调用次数和顺序

（七）使用注解来快速模拟