【Java技术深入解析】「核心技术提升」最流行的Java模拟框架Mockito入门指南(Java单元测试)

简介: 还在使用 Mockito 1.x?看看 Mockito 2 有哪些新功能!Mockito 3 没有引入任何破坏性的 API 变动,但现在需要 Java 8 而不是 Mockito 2 的 Java 6。 Mockito 4 删除了过时的 API。Mockito 5 将默认 mockmaker 改为 mockito-inline,现在需要 Java 11。一次只支持一个主要版本,而且不会向旧版本回传更改内容。

官方资源

官方网站

http://mockito.org

image.png

版本介绍

还在使用 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

image.png

开发指南

添加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()方法配置了当outputStreamclose()方法被调用时抛出IOException异常的预设行为。,调用outputStreamclose()方法,触发异常抛出。

案例二

@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()方法配置了当listadd(1)方法被调用时抛出RuntimeException异常的预设行为,调用listadd(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入门指南(进阶学习案例)。

相关文章
|
5天前
|
测试技术 开发者 Python
Python单元测试入门:3个核心断言方法,帮你快速定位代码bug
本文介绍Python单元测试基础,详解`unittest`框架中的三大核心断言方法:`assertEqual`验证值相等,`assertTrue`和`assertFalse`判断条件真假。通过实例演示其用法,帮助开发者自动化检测代码逻辑,提升测试效率与可靠性。
52 1
|
10天前
|
Java API 数据库
2025 年最新 Java 实操学习路线,从入门到高级应用详细指南
2025年Java最新实操学习路线,涵盖从环境搭建到微服务、容器化部署的全流程实战内容,助你掌握Java 21核心特性、Spring Boot 3.2开发、云原生与微服务架构,提升企业级项目开发能力,适合从入门到高级应用的学习需求。
203 0
|
19天前
|
前端开发 Java 数据库连接
帮助新手快速上手的 JAVA 学习路线最详细版涵盖从入门到进阶的 JAVA 学习路线
本Java学习路线涵盖从基础语法、面向对象、异常处理到高级框架、微服务、JVM调优等内容,适合新手入门到进阶,助力掌握企业级开发技能,快速成为合格Java开发者。
254 3
|
20天前
|
监控 Java API
2025 年全新出炉的 Java 学习路线:从入门起步到实操精通的详细指南
2025年Java学习路线与实操指南,涵盖Java 21核心特性、虚拟线程、Spring Boot 3、微服务、Spring Security、容器化部署等前沿技术,助你从入门到企业级开发进阶。
169 0
|
1月前
|
NoSQL Java 关系型数据库
Java 从入门到进阶完整学习路线图规划与实战开发最佳实践指南
本文为Java开发者提供从入门到进阶的完整学习路线图,涵盖基础语法、面向对象、数据结构与算法、并发编程、JVM调优、主流框架(如Spring Boot)、数据库操作(MySQL、Redis)、微服务架构及云原生开发等内容,并结合实战案例与最佳实践,助力高效掌握Java核心技术。
211 1
|
10天前
|
数据采集 存储 弹性计算
高并发Java爬虫的瓶颈分析与动态线程优化方案
高并发Java爬虫的瓶颈分析与动态线程优化方案
Java 数据库 Spring
46 0
|
22天前
|
算法 Java
Java多线程编程:实现线程间数据共享机制
以上就是Java中几种主要处理多线程序列化资源以及协调各自独立运行但需相互配合以完成任务threads 的技术手段与策略。正确应用上述技术将大大增强你程序稳定性与效率同时也降低bug出现率因此深刻理解每项技术背后理论至关重要.
56 16
|
1月前
|
缓存 并行计算 安全
关于Java多线程详解
本文深入讲解Java多线程编程,涵盖基础概念、线程创建与管理、同步机制、并发工具类、线程池、线程安全集合、实战案例及常见问题解决方案,助你掌握高性能并发编程技巧,应对多线程开发中的挑战。
|
1月前
|
数据采集 存储 前端开发
Java爬虫性能优化:多线程抓取JSP动态数据实践
Java爬虫性能优化:多线程抓取JSP动态数据实践

推荐镜像

更多
  • DNS