Mockito超全用例文档

一.mockito要注意的点

1. mock的对象直接调用其方法会返回null

2.执行真实的被测试方法

①thenCallRealMethod + 实现类：

解析：

mock接口不能和callRealMethod一起用，因为接口没有实现!（即使用spy重新封装也不行！）会报错哦~

但是，如果callRealMethod的方法里面用到了其他外部接口的方法，并且最后结果依赖于这些接口的返回值，则最后执行真实方法得到的接口会偏离真实结果，除非你其他方法也一起callRealMethod。

@Mock
private static LogisticsExpenseCostServiceImpl logisticsExpenseCostService;// 正确：mock被测试类实现类
//@Mock
//private static LogisticsExpenseCostServiceImpl logisticsExpenseCostService;// 错误：mock接口且想callRealMethod，

@org.junit.Test
public void test() throws ParseException {
    ... ...
when(logisticsExpenseCostService.findExpenseAndDetail(null, dataReadingEntity)).thenCallRealMethod();
List<ExpenseCostQueryItem> expenseAndDetail = logisticsExpenseCostService.findExpenseAndDetail(null, dataReadingEntity);
    ... ...
} 

②injectMock

解析：

@Mock: 创建一个Mock.

@InjectMocks: 创建一个实例，简单的说是这个Mock可以调用真实代码的方法，其余用@Mock（或@Spy）注解创建的mock将被注入到用该实例中。如果只实例化对象不加injectmock会，则被测试接口用到的其他依赖对象为空，无法注入报空指针。

但是，在doReturn().when(A)中，injectMcok的对象不能放入A的位置，因为A的位置只能是mock/spy对象，不过可以放在when(B).thenReturn()的B的位置，所以injectMock可以再用spy代理一起使用就可以用doReturn了

// 与mock不同，它需要new LogisticsExpenseCostServiceImpl()实例化
@InjectMocks
private static LogisticsExpenseCostService logisticsExpenseCostService = new LogisticsExpenseCostServiceImpl();
@org.junit.Test
public void test() throws ParseException {
    ...
    LogisticsExpenseCostService spy = spy(logisticsExpenseCostService);// spy代理
    doReturn(mockExpenseCostQueryItems).when(spy).constructExpenseCostList(null,dataReadingEntity);// 这里when(spy)，不能when(logisticsExpenseCostService)~
    doReturn(mockExpenseCostDetailMap).when(spy).constructExpenseCostDetailMap(null,dataReadingEntity);
    List<ExpenseCostQueryItem> expenseAndDetail = spy.findExpenseAndDetail(null, dataReadingEntity);
    System.out.println(JSON.serialize(expenseAndDetail));
    ...
} 

3.verify测试是否被调用

4.激活mock功能的几种方式

二.mock对象的方式

1.spy

spy可以模拟部分实际代码，部分mock代码

被spy后，调用被打桩的方法会返回thenReturn/doReturn的值，调用没被打桩方法则是真实调用返回的值

使用方式：spy(XXX)或者@Spy注解

注意：被spy的对象需要已实例化（= new XXX， @Autowire…）

2.深度mock

优化需要把调用链所有涉及对象都mock的麻烦

使用方式：@Mock(answer=Answre.RETURNS_DEEP_STUBS)

如果不加此注解，那lession03Service.get()得到的对象也是需要mock才能用，否则空指针

三.stup打桩

1.doReturn.when：不会走函数方法

为了屏蔽复杂的第三方接口需要mock大量对象，使用doReturn直接屏蔽，注意参数匹配器，要是传参不匹配还是会走的

2.when.thenReturn：调用真实的方法

如果你不想调用真实的方法而是想要mock的话，就不要使用这个方法。

3.其他

thenReturn：模拟调用后返回值.

thenReturn多个参数：代表第x次返回参数位置x的值

thenThrow：模拟调用后抛异常

doNothing.when：模拟调用后不做任何事情

doThrow：模拟调用后抛异常

thenAnswer：动态模拟返回参数值的十倍

四、Mockito argument Matchers 参数匹配器

1.anyXX

anyXXX的方法使用，可以减少很多打桩条件

2.isA和any

isA代表传入参数只要是A或A的实现子类都符合这个条件，可以返回桩

any只要符合function声明的参数，都可以通过

五.常见错误

1.使用any常见错误，部分传入真实对象，部分传入any

那怎么办呢？使用eq实现具体值传参

2.verify的时候，调用的和校验的传参看似一样，其实不同对象导致校验报错

可以把对象抽出来，再放参数

3.打桩顺序问题，-1放最后时，会覆盖前面两个打桩，因为anyString包括了eq(xxx)

如果这样写，后面两行只会覆盖部分的anyString，当为alex返回100，wang返回200，其他返回-1

4.anyXX是不包括null的

比如有个参数类型是List，这时你when.thenReturn时传入anyList，而你最后调用时传入null，这时候是不符合when的打桩的

如果想包含null，可以使用any()

5.mock复杂的数据实体时，如果是多层数据结构，最里层的数据结构需要手动转类型

Map<String, List<ExpenseCostDetailQueryItem>> mockExpenseCostDetailMap = SnakeCaseJsonUtils.readObject("classpath:testData/expenseCostDetailMapJsonData",Map.class);
// 比如这里mock的数据返回是Map里面有个List，List里面是Model，当我们没有手动转类型，我们会得到JSONObeject的对象

// 手动转类型
for (Map.Entry<String, List<ExpenseCostDetailQueryItem>> stringListEntry : mockExpenseCostDetailMap.entrySet()) {
    List<ExpenseCostDetailQueryItem> value = stringListEntry.getValue();
    stringListEntry.setValue(JSONObject.parseArray(JSON.serialize(value),ExpenseCostDetailQueryItem.class));
}

6.doReturn肯定会跳过mock的方法，如果没有那就是你参数不匹配~

这里的参数是any任意值和dataReadingEntity实体，当你实际调用的dataReadingEntity和匹配器里的不同，那就不会跳过~

doReturn(mockExpenseCostQueryItems).when(spy).constructExpenseCostList(any(),eq(dataReadingEntity));

六.好的mockito习惯

1.善用@after

对不同方法里对同一个全局对象进行打桩，会互相影响，这时候加@after去reset可以避免影响

2.优雅的断言–陈述性断言

3.断言提示

4.手动实现断言条件

https://www.bilibili.com/video/BV1jJ411A7Sv?p=10