MockITO学习总结

MockITO学习总结
1.模拟的关键点
设置测试数据，设定预期结果，验证结果


2.模拟的好处
[1].提前创建测试（测试驱动开发）
[2].团队可以并行工作：指的是测试团队可以和开发团队并行工作，在开发团队没有完成代码开发的时候，测试团队可以模拟测试的代码。
[3].你可以创建一个验证或者演示程序,为决定项目接下来是否要进行提供有力的基础，提供了实际的设计决策。
[4].为无法访问的资源编写测试 （比如一个HTTP资源请求）
[5].隔离系统


3.MockITO
Mockito 是一个基于MIT协议的开源java测试框架。
Mockito区别于其他模拟框架的地方主要是允许开发者在没有建立,“预期”时验证被测系统的行为。
之前的测试模式:expect-run-verify（期望验证模式）高耦合度
MockITO的测试模式: Mockito试图通过移除 “期望规范”去除的模式，因此在耦合度上有所降低。
MockITO简化了测试代码，使他更易读和修改了。


4.Mockito的使用
[1]添加mockito的maven依赖

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

[2]如果要使用mockito必然要通过junit的配合使用->添加junit依赖包

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

[3]然后为了使代码更简洁，最好在测试类中导入静态资源

import static org.mockito.Mockito.*;  
import static org.junit.Assert.*; 

[4]一些简单的例子
Assert:主要是用于验证结果是否相等
Verify:主要是用于验证是否被调用

1.验证行为 

@Test  
public void verify_behaviour(){  
    //模拟创建一个List对象  
    List mock = mock(List.class);  
    //使用mock的对象  
    mock.add(1);  
    mock.clear();  
    //验证add(1)和clear()行为是否发生  
    verify(mock).add(1);  
    verify(mock).clear();  
} 

2.模拟我们所期望的结果
2.1实例【1】
@Test  
public void when_thenReturn(){  
    //mock一个Iterator类  
    Iterator iterator = mock(Iterator.class);  
    //预设当iterator调用next()时第一次返回hello，第二次返回world，之后的N次都返回world  
    when(iterator.next()).thenReturn("hello1").thenReturn("world");
    //使用mock的对象  
    String result = iterator.next() + " " + iterator.next() + " " + iterator.next();  
    //验证结果  
    assertEquals("hello world world",result);  
}  


2.2实列【2】

@Test(expected = IOException.class)  
public void when_thenThrow() throws IOException {  
	//mock一个 outputStream对象
    OutputStream outputStream = mock(OutputStream.class);  
    OutputStreamWriter writer = new OutputStreamWriter(outputStream);  
    //预设当流关闭时抛出异常  
    doThrow(new IOException()).when(outputStream).close();  
    outputStream.close();  
} 

3.参数匹配

@Test  
public void with_arguments(){  
    Comparable comparable = mock(Comparable.class);  
    //预设根据不同的参数返回不同的结果  
    when(comparable.compareTo("Test")).thenReturn(1);  
    when(comparable.compareTo("Omg")).thenReturn(2);  
    assertEquals(1, comparable.compareTo("Test"));  
    assertEquals(2, comparable.compareTo("Omg"));  
    //对于没有预设的情况会返回默认值  
    assertEquals(0, comparable.compareTo("Not stub"));  
} 

除了匹配制定参数外，还可以匹配自己想要的任意参数

@Test  
public void with_unspecified_arguments(){  
    List list = mock(List.class);  
    //匹配任意参数  
    when(list.get(anyInt())).thenReturn(1);  
    when(list.contains(argThat(new IsValid()))).thenReturn(true);  
    assertEquals(1, list.get(1));  
    assertEquals(1, list.get(999));  
    assertTrue(list.contains(1));  
    assertTrue(!list.contains(3));  
}  
  
private class IsValid extends ArgumentMatcher<List>{  
    @Override  
    public boolean matches(Object o) {  
        return o == 1 || o == 2;  
    }  
}

4、验证确切的调用次数

@Test  
public void verifying_number_of_invocations(){  
    List list = mock(List.class);  
    list.add(1);  
    list.add(2);  
    list.add(2);  
    list.add(3);  
    list.add(3);  
    list.add(3);  
    //验证是否被调用一次，等效于下面的times(1)  
    verify(list).add(1);  
    verify(list,times(1)).add(1);  
    //验证是否被调用2次  
    verify(list,times(2)).add(2);  
    //验证是否被调用3次  
    verify(list,times(3)).add(3);  
    //验证是否从未被调用过  
    verify(list,never()).add(4);  
    //验证至少调用一次  
    verify(list,atLeastOnce()).add(1);  
    //验证至少调用2次  
    verify(list,atLeast(2)).add(2);  
    //验证至多调用3次  
    verify(list,atMost(3)).add(3);  
}

5、模拟方法体抛出异常

@Test(expected = RuntimeException.class)  
public void doThrow_when(){  
    List list = mock(List.class);  
    doThrow(new RuntimeException()).when(list).add(1);  
    list.add(1);  
}

6、验证执行顺序

@Test  
public void verification_in_order(){  
    List list = mock(List.class);  
    List list2 = mock(List.class);  
    list.add(1);  
    list2.add("hello");  
    list.add(2);  
    list2.add("world");  
    //将需要排序的mock对象放入InOrder  
    InOrder inOrder = inOrder(list,list2);  
    //下面的代码不能颠倒顺序，验证执行顺序  
    inOrder.verify(list).add(1);  
    inOrder.verify(list2).add("hello");  
    inOrder.verify(list).add(2);  
    inOrder.verify(list2).add("world");  
} 

7、确保模拟对象上无互动发生 verifyZeroInteractions(Object1,Object2)

@Test  
public void verify_interaction(){  
    List list = mock(List.class);  
    List list2 = mock(List.class);  
    List list3 = mock(List.class);  
    list.add(1);  
    verify(list).add(1);  
    verify(list,never()).add(2);  
    //验证零互动行为  
    verifyZeroInteractions(list2,list3);  
} 

8、找出未被验证到的动作 verifyNoMoreInteractions(Object)

@Test(expected = NoInteractionsWanted.class)  
public void find_redundant_interaction(){  
    List list = mock(List.class);  
    list.add(1);  
    list.add(2);  
    verify(list,times(2)).add(anyInt());  
    //检查是否有未被验证的互动行为，因为add(1)和add(2)都会被上面的anyInt()验证到，所以下面的代码会通过  
    verifyNoMoreInteractions(list);  
  
    List list2 = mock(List.class);  
    list2.add(1);  
    list2.add(2);  
    verify(list2).add(1);  
    //检查是否有未被验证的互动行为，因为add(2)没有被验证，所以下面的代码会失败抛出异常  
    verifyNoMoreInteractions(list2);  
}

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

@Mock  
private List mockList;  


我们再用注解的mock对象
@Test  
public void shorthand(){  
    mockList.add(1);  
    verify(mockList).add(1);  
} 

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

*********************第一种解决办法********************

public class MockitoExample2 {  
    @Mock  
    private List mockList;  
  
    public MockitoExample2(){  
        MockitoAnnotations.initMocks(this);  
    }  
  
    @Test  
    public void shorthand(){  
        mockList.add(1);  
        verify(mockList).add(1);  
    }  
} 

*********************第二种解决办法********************
或者使用built-in runner：MockitoJUnitRunner

@RunWith(MockitoJUnitRunner.class)  
public class MockitoExample2 {  
    @Mock  
    private List mockList;  
  
    @Test  
    public void shorthand(){  
        mockList.add(1);  
        verify(mockList).add(1);  
    }  
} 

10.连续调用

@Test(expected = RuntimeException.class)  
public void consecutive_calls(){  
    //模拟连续调用返回期望值，如果分开，则只有最后一个有效  
    when(mockList.get(0)).thenReturn(0);  
    when(mockList.get(0)).thenReturn(1);  
    when(mockList.get(0)).thenReturn(2);  
    when(mockList.get(1)).thenReturn(0).thenReturn(1).thenThrow(new RuntimeException());  
    assertEquals(2,mockList.get(0));  
    assertEquals(2,mockList.get(0));  
    assertEquals(0,mockList.get(1));  
    assertEquals(1,mockList.get(1));  
    //第三次或更多调用都会抛出异常  
    mockList.get(1);  
} 

11、使用回调生成期望值
thenReturn 是返回结果是我们写死的。如果要让被测试的方法不写死，返回实际结果并让我们可以获取到的——怎么做呢？
有时我们需要自定义方法执行的返回结果，Answer 接口就是满足这样的需求而存在的。
例如模拟常见的 request.getAttribute(key)，由于这本来是个接口，所以连内部实现都要自己写了。此次通过 Answer 接口获取参数内容。

final Map<String, Object> hash = new HashMap<String, Object>();  
Answer<String> aswser = new Answer<String>() {    
    public String answer(InvocationOnMock invocation) {    
        Object[] args = invocation.getArguments();    
        return hash.get(args[0].toString()).toString();    
    }   
};  
  
when(request.getAttribute("isRawOutput")).thenReturn(true);   
when(request.getAttribute("errMsg")).thenAnswer(aswser);   
when(request.getAttribute("msg")).thenAnswer(aswser);  

12.使用spy来监控真实的对象，需要注意的是此时我们需要谨慎的使用when-then语句，而改用do-when语句
使用了spy就可以使用真实的API

   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");

13、修改对未预设的调用返回默认期望值

@Test  
public void unstubbed_invocations(){  
    //mock对象使用Answer来对未预设的调用返回默认期望值  
    List mock = mock(List.class,new Answer() {  
        @Override  
        public Object answer(InvocationOnMock invocation) throws Throwable {  
            return 999;  
        }  
    });  
    //下面的get(1)没有预设，通常情况下会返回NULL，但是使用了Answer改变了默认期望值  
    assertEquals(999, mock.get(1));  
    //下面的size()没有预设，通常情况下会返回0，但是使用了Answer改变了默认期望值  
    assertEquals(999,mock.size());  
}

14.真实的部分mock

@Test  
public void real_partial_mock(){  
    //通过spy来调用真实的api  
    List list = spy(new ArrayList());  
    assertEquals(0,list.size());  
    A a  = mock(A.class);  
    //通过thenCallRealMethod来调用真实的api  
    when(a.doSomething(anyInt())).thenCallRealMethod();  
    assertEquals(999,a.doSomething(999));  
}  
  
  
class A{  
    public int doSomething(int i){  
        return i;  
    }  
}

15.重置mock

@Test  
public void reset_mock(){  
    List list = mock(List.class);  
    when(list.size()).thenReturn(10);  
    list.add(1);  
    assertEquals(10,list.size());  
    //重置mock，清除所有的互动和预设  
    reset(list);  
    assertEquals(0,list.size());  
}