【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入门指南(进阶学习案例)。

相关文章
|
27天前
|
存储 安全 Java
【Java并发】【原子类】适合初学体质的原子类入门
什么是CAS? 说到原子类,首先就要说到CAS: CAS(Compare and Swap) 是一种无锁的原子操作,用于实现多线程环境下的安全数据更新。 CAS(Compare and Swap) 的
55 15
【Java并发】【原子类】适合初学体质的原子类入门
|
24天前
|
缓存 安全 Java
【Java并发】【ConcurrentHashMap】适合初学体质的ConcurrentHashMap入门
ConcurrentHashMap是Java中线程安全的哈希表实现,支持高并发读写操作。相比Hashtable,它通过分段锁(JDK1.7)或CAS+synchronized(JDK1.8)实现更细粒度锁控制,提升性能与安全性。本文详细介绍其构造方法、添加/获取/删除元素等常用操作,并对比JDK1.7和1.8的区别,帮助开发者深入理解与使用ConcurrentHashMap。欢迎关注,了解更多!
64 4
【Java并发】【ConcurrentHashMap】适合初学体质的ConcurrentHashMap入门
|
27天前
|
Java
【源码】【Java并发】【LinkedBlockingQueue】适合中学体质的LinkedBlockingQueue入门
前言 有了前文对简单实用的学习 【Java并发】【LinkedBlockingQueue】适合初学体质的LinkedBlockingQueue入门 聪明的你,一定会想知道更多。哈哈哈哈哈,下面主播就...
50 6
【源码】【Java并发】【LinkedBlockingQueue】适合中学体质的LinkedBlockingQueue入门
|
27天前
|
安全 Java
【Java并发】【LinkedBlockingQueue】适合初学体质的LinkedBlockingQueue入门
前言 你是否在线程池工具类里看到过它的身影? 你是否会好奇LinkedBlockingQueue是啥呢? 没有关系,小手手点上关注,跟上主播的节奏。 什么是LinkedBlockingQueue? ...
46 1
【Java并发】【LinkedBlockingQueue】适合初学体质的LinkedBlockingQueue入门
|
9月前
|
Java 测试技术 开发者
在软件开发中,测试至关重要,尤以单元测试和集成测试为然
在软件开发中,测试至关重要,尤以单元测试和集成测试为然。单元测试聚焦于Java中的类或方法等最小单元,确保其独立功能正确无误,及早发现问题。集成测试则着眼于模块间的交互,验证整体协作效能。为实现高效测试,需编写可测性强的代码,并选用JUnit等合适框架。同时,合理规划测试场景与利用Spring等工具也必不可少。遵循最佳实践,可提升测试质量,保障Java应用稳健前行。
88 1
|
6月前
|
测试技术 开发者 UED
探索软件测试的深度:从单元测试到自动化测试
【10月更文挑战第30天】在软件开发的世界中,测试是确保产品质量和用户满意度的关键步骤。本文将深入探讨软件测试的不同层次,从基本的单元测试到复杂的自动化测试,揭示它们如何共同构建一个坚实的质量保证体系。我们将通过实际代码示例,展示如何在开发过程中实施有效的测试策略,以确保软件的稳定性和可靠性。无论你是新手还是经验丰富的开发者,这篇文章都将为你提供宝贵的见解和实用技巧。
|
9月前
|
JSON Dubbo 测试技术
单元测试问题之增加JCode5插件生成的测试代码的可信度如何解决
单元测试问题之增加JCode5插件生成的测试代码的可信度如何解决
91 2
单元测试问题之增加JCode5插件生成的测试代码的可信度如何解决
|
8月前
|
IDE 测试技术 持续交付
Python自动化测试与单元测试框架:提升代码质量与效率
【9月更文挑战第3天】随着软件行业的迅速发展,代码质量和开发效率变得至关重要。本文探讨了Python在自动化及单元测试中的应用,介绍了Selenium、Appium、pytest等自动化测试框架,以及Python标准库中的unittest单元测试框架。通过详细阐述各框架的特点与使用方法,本文旨在帮助开发者掌握编写高效测试用例的技巧,提升代码质量与开发效率。同时,文章还提出了制定测试计划、持续集成与测试等实践建议,助力项目成功。
152 5
|
9月前
|
JSON 测试技术 数据格式
单元测试问题之使用JCode5插件生成测试类如何解决
单元测试问题之使用JCode5插件生成测试类如何解决
308 3
|
9月前
|
测试技术
单元测试问题之使用TestMe时利用JUnit 5的参数化测试特性如何解决
单元测试问题之使用TestMe时利用JUnit 5的参数化测试特性如何解决
153 2

推荐镜像

更多