模拟利器Mockito

16.3.1  模拟测试概述

目前支持Java语言的Mock测试工具有EasyMock、JMock、Mockito、MockCreator、Mockrunner、MockMaker等，Mockito是一个针对Java的Mocking框架。它与EasyMock和JMock很相似，是一套通过简单的方法对于指定的接口或类生成 Mock 对象的类库，避免了手工编写Mock对象。但Mockito是通过在执行后校验什么已经被调用，它消除了对期望行为（Expectations）的需要。使用Mockito，在准备阶段只需花费很少的时间，可以使用简洁的API编写出漂亮的测试，可以对具体的类创建Mock对象，并且有"监视"非Mock对象的能力。

Mockito使用起来简单，学习成本很低，而且具有非常简洁的API，测试代码的可读性很高，因此它十分受欢迎，用户群越来越多，很多开源软件也选择了Mockito。要想了解更多有关Mockito的信息，可以访问其官方网站http://www.mockito.org/。在开始使用Mockito之前，先简单了解一下Stub和Mock的区别。相比Easymock，JMock，编写出来的代码更加容易阅读。无须录制mock方法调用就返回默认值是一个很大优势。目前最新的版本是1.9.0。

Stub对象用来提供测试时所需要的测试数据，可以对各种交互设置相应的回应。例如我们可以设置方法调用的返回值等。Mockito中 when(…).thenReturn(…) 这样的语法便是设置方法调用的返回值。另外也可以设置方法在何时调用会抛出异常等。

Mock对象用来验证测试中所依赖对象间的交互是否能够达到预期。Mockito中用 verify(…).methodXxx(…) 语法来验证 methodXxx方法是否按照预期进行了调用。有关stub和mock的详细论述请见Martin Fowler的文章《Mocks Aren't Stub》，地址为http://martinfowler.com/articles/mocksArentStubs.html。在Mocking框架中所谓的Mock对象实际上是作为上述的Stub和Mock对象同时使用的。因为它既可以设置方法调用返回值，又可以验证方法的调用。

16.3.2  创建Mock对象

可以对类和接口进行Mock对象的创建，创建的时候可以为Mock对象命名，也可以忽略命名参数。为Mock对象命名的好处就是调试的时候会很方便。比如，我们Mock多个对象，在测试失败的信息中会把有问题的Mock对象打印出来，有了名字我们可以很容易定位和辨认出是哪个Mock对象出现的问题。另外它也有限制，对于final类、匿名类和Java的基本类型是无法进行Mock的。除了用Mock方法来创建模拟对象，如mock（Class<T> classToMock），也可以使用@mock注解定义Mock，下面我们通过实例来介绍一下如何创建一个Mock对象。代码清单16 8  MockitoSampleTest.java创建Mock对象

1. import org.junit.Test;
2. import org.mockito.Mock;
3. import com.baobaotao.domain.User;
4. import com.baobaotao.service.UserService;
5. import com.baobaotao.service.UserServiceImpl;
6. import static org.junit.Assert.*;
7. import static org.mockito.Mockito.*;
8. import org.mockito.MockitoAnnotations;
9. …
10. public class MockitoSampleTest{
11. //① 对接口进行模拟
12. UserService mockmockUserService = mock(UserService.class);
13. //② 对类进行模拟
14. UserServiceImpl mockmockServiceImpl = mock(UserServiceImpl.class);
15. //③ 基于注解模拟类
16. @Mock
17. User mockUser;
18. @Before
19. public void initMocks() {
20. //④ 初始化当前测试类所有@Mock注解模拟对象
21. MockitoAnnotations.initMocks(this);
22. }
23. …
24. }
25. …

在①处和②处，通过Mockito提供的mock()方法创建UserService 用户服务接口、用户服务实现类UserServiceImpl的模拟对象。在③处，通过@Mock注解创建用户User类模拟对象，并需要在测试类初始化方法中，通过MockitoAnnotations.initMocks()方法初始化当前测试类中所有打上@Mock注解的模拟对象。如果没有执行这一步初始化动作，测试时会报模拟对象为空对象异常。

16.3.3  设定Mock对象的期望行为及返回值

从上文中我们已经知道可以通过when(mock.someMethod()).thenReturn(value)来设定Mock对象的某个方法调用时的返回值，但它也同样有限制条件：对于static和final修饰的方法是无法进行设定的。下面我们通过实例来介绍一下如何调用方法及设定返回值。

代码清单16 9  MockitoSampleTest.java设定模拟对象的行为及返回值

1. import org.junit.Test;
2. import org.mockito.Mock;
3. import com.baobaotao.domain.User;
4. import com.baobaotao.service.UserService;
5. import com.baobaotao.service.UserServiceImpl;
6. …
7. public class MockitoSampleTest {
8. …
9. //① 模拟接口UserService测试
10. @Test
11. public void testMockInterface() {
12. //①-1 对方法设定返回值
13. when(mockUserService.findUserByUserName("tom")).thenReturn(
14. new User("tom", "1234"));
15. //①-2 对方法设定返回值
16. doReturn(true).when(mockServiceImpl).hasMatchUser("tom", "1234");
17. //①-3 对void方法进行方法预期设定
18. User u = new User("John", "1234");
19. doNothing().when(mockUserService).registerUser(u);
20. //①-4 执行方法调用
21. User user = mockUserService.findUserByUserName("tom");
22. boolean isMatch = mockUserService.hasMatchUser("tom","1234");
23. mockUserService.registerUser(u);
24. assertNotNull(user);
25. assertEquals(user.getUserName(), "tom");
26. assertEquals(isMatch, true);
27. }
28. //② 模拟实现类UserServiceImpl测试
29. @Test
30. public void testMockClass() {
31. // 对方法设定返回值
32. when(mockServiceImpl.findUserByUserName("tom"))
33. .thenReturn(new User("tom", "1234"));
34. doReturn(true).when(mockServiceImpl).hasMatchUser("tom", "1234");
35. User user = mockServiceImpl.findUserByUserName("tom");
36. boolean isMatch = mockServiceImpl.hasMatchUser("tom","1234");
37. assertNotNull(user);
38. assertEquals(user.getUserName(), "tom");
39. assertEquals(isMatch, true);
40. }
41. //③ 模拟User类测试
42. @Test
43. public void testMockUser() {
44. when(mockUser.getUserId()).thenReturn(1);
45. when(mockUser.getUserName()).thenReturn("tom");
46. assertEquals(mockUser.getUserId(),1);
47. assertEquals(mockUser.getUserName(), "tom");
48. }

…在①处，模拟测试接口UserService的findUserByUserName()方法、hasMatchUser()方法及registerUser()方法。在①-1处通过when().thenReturn()语法，模拟方法调用及设置方法的返回值，实例通过模拟调用UserService 用户服务接口的查找用户findUserByUserName()方法，查询用户名为"tom"详细的信息，并设置返回User对象：new User("tom", "1234")。在①-2处通过doReturn (). when ()语法，模拟判断用户hasMatchUser()方法的调用，判断用户名为"tom"及密码为"1234"的用户存在，并设置返回值为：true。在①-3处对void方法进行方法预期设定，如实例中调用注册用户registerUser()方法。设定调用方法及返回值之后，就可以执行接口方法调用验证。在②处和③处，模拟测试用户服务实现类UserServiceImpl，测试的方法与模拟接口一致。

16.3.4  验证交互行为

Mock对象一旦建立便会自动记录自己的交互行为，所以我们可以有选择地对其交互行为进行验证。在Mockito中验证mock对象交互行为的方法是verify(mock). xxx()。于是用此方法验证了findUserByUserName()方法的调用，因为只调用了一次，所以在verify中我们指定了times参数或atLeastOnce()参数。最后验证返回值是否和预期一样。

代码清单16 10 MockitoSampleTest.java验证交互行为

1. import org.junit.Test;
2. import org.mockito.Mock;
3. import com.baobaotao.domain.User;
4. import com.baobaotao.service.UserService;
5. import com.baobaotao.service.UserServiceImpl;
6. …
7. public class MockitoSampleTest {
8. …
9. //① 模拟接口UserService测试
10. @Test
11. public void testMockInterface() {
12. …
13. when(mockUserService.findUserByUserName("tom"))
14. .thenReturn(new User("tom", "1234"));
15. User user = mockServiceImpl.findUserByUserName("tom");
16. //①-4 验证返回值
17. assertNotNull(user);
18. assertEquals(user.getUserName(), "tom");
19. assertEquals(isMatch, true);
20. //①-5 验证交互行为
21. verify(mockUserService).findUserByUserName("tom");
22. //①-6 验证方法至少调用一次
23. verify(mockUserService, atLeastOnce()).findUserByUserName("tom");
24. verify(mockUserService, atLeast(1)).findUserByUserName("tom");
25. //①-7 验证方法至多调用一次
26. verify(mockUserService, atMost(1)).findUserByUserName("tom");
27. }
28. …

Mockio为我们提供了丰富调用方法次数的验证机制，如被调用了特定次数verify(xxx, times(x))、至少x次verify(xxx, atLeast (x))、最多x次verify(xxx, atMost (x))、从未被调用verify(xxx, never())。在①-6处，验证findUserByUserName()方法至少被调用一次。在①-7处，验证findUserByUserName()方法至多被调用一次。