官方资源
官方网站
版本介绍
还在使用 Mockito 1.x?看看 Mockito 2 有哪些新功能!Mockito 3 没有引入任何破坏性的 API 变动,但现在需要 Java 8 而不是 Mockito 2 的 Java 6。 Mockito 4 删除了过时的 API。Mockito 5 将默认 mockmaker 改为 mockito-inline,现在需要 Java 11。一次只支持一个主要版本,而且不会向旧版本回传更改内容。
项目源码
https://github.com/mockito/mockito
开发指南
添加maven依赖
这将在Maven项目中添加Mockito核心库的依赖关系,并限定其范围为测试(<scope>test</scope>
)。这样,您就可以在单元测试中使用Mockito框架来模拟对象和验证行为了。请注意,您需要根据您的实际需求调整版本号。
<!-- 添加 Mockito 依赖 -->
<dependency>
<groupId>org.mockito</groupId>
<artifactId>mockito-core</artifactId>
<version>3.12.4</version>
<scope>test</scope>
</dependency>
获得 Mockito 的推荐方法是使用自己喜欢的构建系统声明对 "mockito-core "库的依赖。使用 Gradle 可以做到这一点:
添加Gradle依赖
repositories { mavenCentral() }
dependencies { testImplementation "org.mockito:mockito-core:3.+" }}
Maven 用户可以声明对 mockito-core 的依赖。Mockito 会将每次更改作为 -SNAPSHOT 版本发布到公共 Sonatype 资源库。进行手动依赖关系管理的用户可直接从 Maven Central 下载 jar。使用手动依赖关系管理的传统版本可使用 1. "mockito-all" 发行版。该发行版在 Mockito 2. 中已停用。
mockito需要junit配合使用
需要将JUnit和Mockito结合在一起使用来进行Java单元测试。在添加Mockito依赖之前,请确保您的项目中已经包含了JUnit的依赖。
<dependencies>
<!-- 添加 JUnit 依赖 -->
<dependency>
<groupId>junit</groupId>
<artifactId>junit</artifactId>
<version>4.13.2</version>
<scope>test</scope>
</dependency>
<!-- 添加 Mockito 依赖 -->
<dependency>
<groupId>org.mockito</groupId>
<artifactId>mockito-core</artifactId>
<version>3.12.4</version>
<scope>test</scope>
</dependency>
</dependencies>
在上面的配置中,我们添加了JUnit和Mockito的依赖关系,并将其范围都设置为测试(<scope>test</scope>
)。这样,就可以使用JUnit来运行测试,并使用Mockito进行对象模拟和行为验证。请确保根据您的实际需求调整JUnit和Mockito的版本号。
导入静态资源
为了使测试类中的代码更简洁和易读,您可以通过静态导入来引入Mockito和JUnit的一些静态资源。这样可以减少在测试类中使用这些资源时的冗余代码
import static org.mockito.Mockito.*;
import static org.junit.Assert.*;
mockito的方法
验证互动
下面是对应相关的案例代码:
@Test
public void verify_behaviour(){
//模拟创建一个List对象
List mock = mock(List.class);
// 或者使用 Mockito 4.10.0+ 时更简单
List mock = mock();
// 使用 mock 对象 - 它不会抛出任何 "意外交互 "异常
mock.add(1);
mock.clear();
//验证add(1)和clear()行为是否发生
// 选择性的、明确的、可读性高的验证
verify(mock).add(1);
verify(mock).clear();
}
详细分析:使用mock()模拟对象
举一个简单的案例去模型mock数据效果,mock可以模拟各种各样的对象,替代真正的对象做出希望的响应。
//模拟LinkList的一个对象
LinkedList mockdedList = mock(LinkedList.class);
//此时条用get方法,会返回null,因为还没有对方法调用的返回值做模拟。
System.out.printlin(mockedList.get(99));
模拟方法调用的返回值
mock对象被调用时的返回值
当我们需要模拟获取第一个元素并返回字符串“first”时,可以使用Mockito进行桩模拟(stub)。桩模拟是指为特定的方法调用配置返回固定值的行为。在官方文档中,这种行为被称为stub(存根)。通过使用桩模拟,我们可以模拟本地对象以屏蔽对远程主机上对象的调用。
when(mockedList.get(0).thenReturn("first"));
// 此时打印输出first
System.out.println(mockedList.get(0));
详细分析:模拟,方法调用抛出异常
// 模拟获取第二个元素时,抛出RuntimeException
when(mockedList.get(1)).thenThrow(new RuntimeException);
// 此时抛出RuntimeException异常
System.out.println(mockedList.get(1));
// 没有返回值类型的方法也可以模拟异常抛出:
doThrow(new RuntimeException()).when(mockedList).clear();
详细分析:模拟调用方法时的参数匹配
anyInt()
是Mockito中的一个匹配器,它用于匹配任何传入的int
参数。这意味着无论传入的参数是什么值,都将返回"element"。
when(mockedList.get(anyInt())).thenReturn("element");
// 此时打印是element
System.out.println(mockedList.get(99));
可以这样描述anyInt()的作用:它用于接受任意的int
参数,并将其值忽略,返回固定的字符串"element"。
详细分析:模拟方法调用次数
// 调用add一次
mockedList.add("once");
// 验证add方法是否被调用了一次,两种写法效果一样
verify(mockedList)add("once");
verify(mockedList,times(1)).add("once");
可以使用Mockito中的atLeast(int i)
和atMost(int i)
来验证方法被调用的最小和最大次数限制。
atLeast(int i)
用于验证方法至少被调用了i
次atMost(int i)
用于验证方法最多被调用了i
次。
可以精确地控制方法被调用的次数,并进行相应的验证。通过使用这些方法,可以更准确地断言方法的调用次数是否符合预期。
详细分析:验证被测试类是否正确工作,使用verify()
在默认情况下,对于所有未被桩模拟过的有返回值的方法,Mockito会返回相应的默认值。对于基本数据类型,如int
,默认值是0;对于布尔类型,默认值是false
;对于其他对象类型,默认值是null
。
mock对象会覆盖整个被mock的对象,因此没有stub的方法只能返回默认值。重复stub两次,则以第二次为准,如下将返回”second“。
when(mockedList.get(0)).thenReturn("first");
when(mockedList.get(0)).thenReturn("second");
下面这种形式表示第一次调用返回”first“,第二次调用返回”second“,可以写n多个
when(mockedList.get(0)).thenReturn("first").thenReturn("second");
如果实际调用次数超过了stub过的次数,则会一直返回最后一次stub的值,如上例,第三次调用get(0),则返回 ”second“验证方法被调用特定的次数。
验证add方法被调用了两次
verify(mockedList,times(2)).add("2");
验证add方法致至少被调用一次
verify(mockedList.atLeastOnce()).add("2");
验证add方法至少被调用两次
verify(mockedList,atLeast(2)).add("2");
验证add方法最大被调用5次
verify(mockedList,atMost(5)).add("2");
验证add方法从未被调用
找到冗余的调用,使用never();
verify(mockedList,never()).add("2");
模拟所期望的结果
为了模拟获取和检索数据的行为,我们可以使用Mockito来进行对象模拟。通过模拟数据获取和检索的过程,我们可以更轻松地编写和执行单元测试。
// 你可以模拟具体的类,而不仅仅是接口
LinkedList mockedList = mock(LinkedList.class);
// 或者使用 Mockito 4.10.0+ 更简单
// LinkedList mockedList = mock();
// 在实际执行前出现存根
when(mockedList.get(0)).thenReturn("first");
// 下面将打印 "first
System.out.println(mockedList.get(0));
// 下面打印 "null",因为 get(999) 没有被存根化
System.out.println(mockedList.get(999));
模拟所期望的结果
@Test
public void when_thenReturn(){
//mock一个Iterator类
Iterator iterator = mock(Iterator.class);
//预设当iterator调用next()时第一次返回hello,第n次都返回world
when(iterator.next()).thenReturn("hello").thenReturn("world");
//使用mock的对象
String result = iterator.next() + " " + iterator.next() + " " + iterator.next();
//验证结果
assertEquals("hello world world",result);
}
模拟方法体抛出异常
案例一
在@Test(expected = IOException.class)
注解中指定了期望的异常类型为IOException
,用于断言在测试代码中是否抛出了该异常,通过指定expected
注解和模拟对象的预设行为,我们可以断言在调用close()
方法时是否会抛出IOException
异常。
@Test(expected = IOException.class)
public void when_thenThrow() throws IOException {
OutputStream outputStream = mock(OutputStream.class);
OutputStreamWriter writer = new OutputStreamWriter(outputStream);
//预设当流关闭时抛出异常
doThrow(new IOException()).when(outputStream).close();
outputStream.close();
}
使用doThrow()
方法配置了当outputStream
的close()
方法被调用时抛出IOException
异常的预设行为。,调用outputStream
的close()
方法,触发异常抛出。
案例二
在@Test(expected = RuntimeException.class)
注解中指定了期望的异常类型为RuntimeException
,用于断言在测试代码中是否抛出了该异常。
@Test(expected = RuntimeException.class)
public void doThrow_when(){
List list = mock(List.class);
doThrow(new RuntimeException()).when(list).add(1);
list.add(1);
}
使用doThrow()
方法配置了当list
的add(1)
方法被调用时抛出RuntimeException
异常的预设行为,调用list
的add(1)
方法,触发异常抛出。通过指定expected
注解和模拟对象的预设行为,我们可以断言在调用add(1)
方法时是否会抛出RuntimeException
异常。
验证执行顺序
下面代码用于验证在特定顺序下方法的执行状况,使用inOrder.verify()方法按顺序验证了方法的调用。
@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");
}
验证顺序
先验证list的add(1)方法被调用,然后验证list2的add("hello")方法被调用,接着验证list的add(2)方法被调用,最后验证list2的add("world")方法被调用。
通过使用InOrder对象,我们可以验证方法的执行顺序是否符合预期。如果按照预期顺序执行,则测试将成功通过。如果顺序不符合预期,测试将失败。
未完待续
敬请期待:【Java技术深入解析】「核心技术提升」最流行的Java模拟框架Mockito入门指南(进阶学习案例)。