【单元测试】如何使用 JUnit5 框架？

最新推荐文章于 2024-04-01 13:55:34 发布
最新推荐文章于 2024-04-01 13:55:34 发布
阅读量212 收藏 1
点赞数
分类专栏： 测试工程师 自动化测试 软件测试 文章标签： 单元测试 log4j 测试工程师 测试工具 性能测试 自动化测试 软件测试
版权声明：本文为博主原创文章，遵循 CC 4.0 BY-SA 版权协议，转载请附上原文出处链接和本声明。
本文链接：https://blog.csdn.net/2301_77709772/article/details/133679974
版权

JUnit5 单元测试框架使用教程

一、Junit5 是什么？

  Junit5是一个用于在Java平台上进行单元测试的框架。JUnit 5 框架主要由三部分组成：JUnit Platform、JUnit Jupiter 和 JUnit Vintage。

  • JUnit Platform：定义了测试引擎的 API，是 JVM 上用于启动测试框架的基础服务，支持通过 IDE、构建工具、命令行等方式运行单元测试。
  • JUnit Jupiter：包含 JUnit 5 新的编程模型和扩展模型，主要用于编写和扩展测试代码。
  • JUnit Vintage：兼容运行 JUnit 3 和 JUnit4 编写的测试用例。

二、Junit5 的注解

（一）导入依赖

  导入五个依赖：

   <!--  junit-jupiter-api 里有 @BeforeAll……等注解  -->
        <dependency>
            <groupId>org.junit.jupiter</groupId>
            <artifactId>junit-jupiter-api</artifactId>
            <version>5.10.0</version>
        </dependency>
            
        <!--   junit-jupiter-params 里有 @ValueSource……等注解    -->
        <dependency>
            <groupId>org.junit.jupiter</groupId>
            <artifactId>junit-jupiter-params</artifactId>
            <version>5.10.0</version>
        </dependency>
            
        <!--    用于运行 识别上述注解    -->
        <dependency>
            <groupId>org.junit.jupiter</groupId>
            <artifactId>junit-jupiter-engine</artifactId>
            <version>5.10.0</version>
            <scope>test</scope>
        </dependency>

        <!-- 测试套件  -->
        <dependency>
            <groupId>org.junit.platform</groupId>
            <artifactId>junit-platform-suite-api</artifactId>
            <version>1.10.0</version>
        </dependency>
            
        <!-- 运行测试套件的测试引擎-->
        <dependency>
            <groupId>org.junit.platform</groupId>
            <artifactId>junit-platform-suite-engine</artifactId>
            <version>1.10.0</version>
            <scope>test</scope>
        </dependency>

（二）常用的注解

如果你的IDEA在使用JUnit注解的时候发生如下情况：依赖已经导入且加载完成，但是IDEA没能识别出来，如图：

image.png

有的注解也在params包中。

image.png

（我真的不理解为啥）

有一种解决办法：

image.png

image.png

image.png

点击后，选择相应的版本，我这里是5.10.0，点了之后IDEA就能识别出来了。

现在我也找了很多测试的朋友，做了一个分享技术的交流群，共享了很多我们收集的技术文档和视频教程。
如果你不想再体验自学时找不到资源，没人解答问题，坚持几天便放弃的感受
可以加入我们一起交流。而且还有很多在自动化，性能，安全，测试开发等等方面有一定建树的技术大牛
分享他们的经验，还会分享很多直播讲座和技术沙龙
可以免费学习！划重点！开源的！！！
qq群号：110685036

1.@Test
public class JUnitTest {

    @Test
    void test0(){
        System.out.println("测试用例1");
    }

    @Test
    void test1(){
        System.out.println("测试用例2");
    }

    @Test
    void test2(){
        System.out.println("测试用例3");
    }
}

结果：

image.png

2.@BeforeAll、@AfterAll
  • @BeforeAll：表示被注解的方法应该在当前类的所有@Test，@RepeatedTest，@ParameterizedTest和@TestFactory方法之前执行;
  • @AfterAll：表示被注解的方法应该在当前类的所有@Test，@RepeatedTest，@ParameterizedTest和@TestFactory方法之后执行;

使用@BeforeAll和@AfterAll注解的方法要加上static。

public class JUnitTest {
    @BeforeAll
    static void beforeAll(){
        //可以用于创建一些资源
        System.out.println("我是BeforeAll，我最开始执行。");
    }
    @AfterAll
    static void afterAll(){
        //可以用于释放资源
        System.out.println("我是AfterAll，我最后执行。");
    }
    @Test
    void test0(){
        System.out.println("测试用例1");
    }
    @Test
    void test1(){
        System.out.println("测试用例2");
    }
    @Test
    void test2(){
        System.out.println("测试用例3");
    }
}

image.png

3.@BeforeEach、@AfterEach
  • @BeforeEach：表示被注解的方法应在当前类的每个@Test，@RepeatedTest，@ParameterizedTest或@TestFactory方法之前执行;
  • @AfterEach：表示被注解的方法应在当前类的每个@Test，@RepeatedTest，@ParameterizedTest或@TestFactory方法之后执行;
public class JUnitTest {
    @BeforeAll
    static void beforeAll(){
        System.out.println("我是BeforeAll，我最开始执行。");
    }
    @AfterAll
    static void afterAll(){
        System.out.println("我是AfterAll，我最后执行。");
    }
    @BeforeEach
    void beforeEach(){
        System.out.println("我是BeforeEach，我在每个 @Test 前执行。");
    }
    @AfterEach
    void afterEach(){
        System.out.println("我是AfterEach，我在每个 @Test 后执行。");
    }
    @Test
    void test0(){
        System.out.println("测试用例1");
    }
    @Test
    void test1(){
        System.out.println("测试用例2");
    }
    @Test
    void test2(){
        System.out.println("测试用例3");
    }
}

结果：

image.png

4.@Disabled

  @Disabled用于禁用测试类或测试方法，添加该注解的方法不会被测试。

public class JUnitTest {
    @BeforeAll
    static void beforeAll(){
        System.out.println("我是BeforeAll，我最开始执行。");
    }
    @AfterAll
    static void afterAll(){
        System.out.println("我是AfterAll，我最后执行。");
    }
    @BeforeEach
    void beforeEach(){
        System.out.println("我是BeforeEach，我在每个 @Test 前执行。");
    }
    @AfterEach
    void afterEach(){
        System.out.println("我是AfterEach，我在每个 @Test 后执行。");
    }
    @Test
    @Disabled //忽略测试用例1
    void test0(){
        System.out.println("测试用例1");
    }
    @Test
    void test1(){
        System.out.println("测试用例2");
    }
    @Test
    void test2(){
        System.out.println("测试用例3");
    }
}

结果：

image.png

（三）参数化测试

1.@ParameterizedTest + @ValueSource

  @ParameterizedTest的作用就是可以用不同的参数多次运行测试。但是必须声调用提供参数的来源(source)。

  @ValueSource它可以让你指定一个原生类型（String，int，long或double）的数组，并且只能为每次调用提供一个参数。

public class JUnitTest {

    @BeforeAll
    static void beforeAll(){
        System.out.println("我是BeforeAll，我最开始执行。");
    }

    @AfterAll
    static void afterAll(){
        System.out.println("我是AfterAll，我最后执行。");
    }

    @BeforeEach
    void beforeEach(){
        System.out.println("我是BeforeEach，我在每个 Test 前执行。");
    }

    @AfterEach
    void afterEach(){
        System.out.println("我是AfterEach，我在每个 Test 后执行。");
    }

    @Test
    void test0(){
        System.out.println("测试用例1");
    }

    @Test
    void test1(){
        System.out.println("测试用例2");
    }

    @Test
    void test2(){
        System.out.println("测试用例3");
    }
    @ParameterizedTest
    @ValueSource(strings = {"小明","小红","小兰"})
    void paramTest(String name){
        System.out.println(name);
    }
}

结果：

image.png

2.@ParameterizedTest + @CsvSource

  @CsvSource允许将参数列表表示为以逗号分隔的值（例如，字符串文字）。

public class JUnitTest { 
    @ParameterizedTest
    @CsvSource({"小明, 1","小红,2","小兰,3"})
    void csvSource(String name,int id){
        System.out.println(name + ":" + id);
    }
}

结果：

image.png

@CsvSource使用'作为转义字符。

示例输入结果字符列表
@CsvSource({ "foo, bar" })"foo", "bar"
@CsvSource({ "foo, 'baz, qux'" })"foo", "baz, qux"
@CsvSource({ "foo, ''" })"foo", ""
@CsvSource({ "foo, " })"foo", null
3.@ParameterizedTest + @CsvFileSource

  @CsvFileSource让你使用classpath中的CSV文件。CSV文件中的每一行都会导致参数化测试的一次调用。

在resources目录下创建csv文件：

test.csv:

小明, 1
小红, 2
"小明, 小红", 3
public class JUnitTest {
    @ParameterizedTest
    @CsvFileSource(resources = "/test.csv")
    void csvFile(String name,int id){
        System.out.println(name + ": " + id);
    }
}

结果：

image.png

与@CsvSource中使用的语法相反，@CsvFileSource使用双引号"作为转义字符。通过上面的代码就可以看出来。一个空的转义值""会产生一个空字符串， 一个完全为空的值被解释为null引用。

4.@ParameterizedTest + @MethodSource

  @MethodSource允许引用一个或多个测试类的工厂方法。

public class JUnitTest {
    @ParameterizedTest
    @MethodSource("stringProvider") //指定方法
    void methodSource(int age,String name){
        System.out.println(age + ": " + name);
    }
    static Stream<Arguments> stringProvider() {
        return Stream.of(
                Arguments.arguments(12,"李四"),
                Arguments.arguments(18,"王五"),
                Arguments.arguments(20,"小红")
        );
    }
}

  @MethodSource注解表示这个方法的参数来源于一个名为stringProvider的静态方法。stringProvider方法返回一个Stream<Arguments>类型的对象，其中每个Arguments对象包含了一组用于测试的参数。

image.png

（四）测试方法的执行顺序

1.@TestMethodOrder + @Order

  在 JUnit5 中，测试方法执行的顺序是不确定的或者是根据方法首字母来排序的。

public class JUnitTest2 {
    @Test
    void C(){
        System.out.println("A");
    }
    @Test
    void B(){
        System.out.println("B");
    }
    @Test
    void A(){
        System.out.println("C");
    }
}

结果：

image.png

  让执行顺序为 C、B、A：

@TestMethodOrder(MethodOrderer.OrderAnnotation.class)
public class JUnitTest2 {
    int a = 0;
    @Test
    @Order(1)
    void C(){
        a++;
        System.out.println(a);
        System.out.println("C");
    }
    @Test
    @Order(2)
    void B(){
        a++;
        System.out.println(a);
        System.out.println("B");
    }
    @Test
    @Order(3)
    void A(){
        a++;
        System.out.println(a);
        System.out.println("A");
    }
}

  首先在类上添加@TestMethodOrder(MethodOrderer.OrderAnnotation.class)，然后再为每个方法上添加@Order()注解，值越小越优先被执行。

（五）测试实例的生命周期

1.@TestInstance

  我添加一个成员变量，每次执行测试方法的时候都++一次。

@TestMethodOrder(MethodOrderer.OrderAnnotation.class)
@TestInstance(TestInstance.Lifecycle.PER_METHOD)
public class JUnitTest2 {
    int a = 0;

    @Test
    @Order(1)
    void A(){
        a++;
        System.out.println("A方法：" + a);
        System.out.println("A");
    }

    @Test
    @Order(2)
    void B(){
        a++;
        System.out.println("B方法：" + a);
        System.out.println("B");
    }

    @Test
    @Order(3)
    void C(){
        a++;
        System.out.println("C方法：" + a);
        System.out.println("C");
    }
}

结果：

image.png

  为了允许隔离执行单个的测试方法，JUnit在执行每个测试方法之前会创建每个测试类的新实例。如果想改变策略，就要用@TestInstance，在类上添加@TestInstance(TestInstance.Lifecycle.PER_CLASS)。

@TestMethodOrder(MethodOrderer.OrderAnnotation.class)
@TestInstance(TestInstance.Lifecycle.PER_CLASS)
public class JUnitTest2 {
    int a = 0;

    @Test
    @Order(1)
    void A(){
        a++;
        System.out.println("A方法：" + a);
        System.out.println("A");
    }

    @Test
    @Order(2)
    void B(){
        a++;
        System.out.println("B方法：" + a);
        System.out.println("B");
    }

    @Test
    @Order(3)
    void C(){
        a++;
        System.out.println("C方法：" + a);
        System.out.println("C");
    }
}

结果：

image.png

Lifecycle.PER_CLASS表示只创建一个实例。不添加注解的时候，默认是Lifecycle.PER_METHOD。

  当使用这种模式时，每个测试类将创建一个新的测试实例。因此，如果测试方法依赖于存储在实例变量中的状态，则可能需要在@BeforeEach或@AfterEach方法中重置该状态（重置变量的值）。

（六）断言 Assertions

断言方法描述
assertEquals(expected, actual)检查两个值是否相等，如果不相等则抛出AssertionError
assertNotEquals(expected, actual)检查两个值是否不相等，如果相等则抛出AssertionError
assertTrue(condition)检查一个条件是否为真，如果为假则抛出AssertionError
assertFalse(condition)检查一个条件是否为假，如果为真则抛出AssertionError
assertNull(object)检查一个对象是否为null，如果不为null则抛出AssertionError
assertNotNull(object)检查一个对象是否不为null，如果为null则抛出AssertionError
assertSame(expected, actual)检查两个对象是否是同一个实例，如果不是则抛出AssertionError
assertNotSame(expected, actual)检查两个对象是否不是同一个实例，如果是则抛出AssertionError
assertArrayEquals(expected, actual)检查两个数组是否相等，如果不相等则抛出AssertionError
assertTimeout(duration, executable)检查一个可执行的代码块是否在指定的时间内完成，如果超时则抛出AssertionError
public class JUnitTest3 {
    @Test
    void assertEqualsDemo(){
        int num = 10;
        Assertions.assertEquals(1,num,"不符合预期");
    }
    @Test
    void assertTrueDemo(){
        int num = 10;
        Assertions.assertTrue(num > 10,"不符合预期");
    }
    @Test
    void assertTimeoutDemo(){
        int num = 10;
        Assertions.assertTimeout(Duration.ofSeconds(3), new Executable() {
            @Override
            public void execute() throws Throwable {
                //代码块
                Thread.sleep(4000);
            }
        });
    }
}
结果：

image.png

（七）测试套件

  测试套件是一组相关的测试，可以一起运行，以便更方便地组织和管理测试。使用套件要引入两个依赖：junit-platform-suite-api、junit-platform-suite-engine，具体的在文章开头。

  套件其实很好理解，就是使几个类同时进行测试。

1.@SelectClasses
@Suite
@SelectClasses(value = {JUnitTest.class,JUnitTest2.class})
public class RunSuite {

}

@Suite的作用是将一个类标记为JUnit平台上的测试套件。

@SelectClasses指定在JUnit平台上运行测试套件时要选择的类。

运行结果：

image.png

2.@SelectPackages

  可以选择类，那么也可以包。

@Suite
@SelectPackages(value = {"package1"})
//可以选择多个包：@SelectPackages(value = {"package1","package2","package3"……})
public class RunSuite {

}

image.png

结果：

image.png

为什么只执行了JUnitTest这一个类？我的JUnitTest2呢？我们来看看它：

image.png

IDEA提示我们它的命名不符合规则，那这个规则是什么意思呢？

3.测试类命名规则
  • [A-Z[A-Za-z\d]*Test(s|Case)?：表示以大写字母开头，后面跟任意个字母或数字，最后以Test, Tests, TestCase结尾的字符串，例如MyTest, MyTests, MyTestCase等。
  • Test[A-Z[A-Za-z\d]*：表示以Test开头，后面跟一个大写字母，再后面跟任意个字母或数字的字符串，例如TestMyClass, TestMyMethod等。
  • IT(.*)：表示以IT开头，后面跟任意个任意字符的字符串，例如ITMyClass, ITMyMethod等。
  • (.*)IT(Case)?：表示以任意个任意字符开头，后面跟IT或者ITCase的字符串，例如MyClassIT, MyMethodITCase等。

其实就是我们的类命名不规范导致框架识别不出来。改类名后：

image.png

image.png

最后感谢每一个认真阅读我文章的人，看着粉丝一路的上涨和关注，礼尚往来总是要有的，虽然不是什么很值钱的东西，如果你用得到的话可以直接拿走！

软件测试面试文档

我们学习必然是为了找到高薪的工作，下面这些面试题是来自阿里、腾讯、字节等一线互联网大厂最新的面试资料，并且有字节大佬给出了权威的解答，刷完这一套面试资料相信大家都能找到满意的工作。
 

在这里插入图片描述

自动化测试老司 机
关注
  • 0
    点赞
  • 踩
  • 1
    收藏
    觉得还不错? 一键收藏
  • 0
    评论
专栏目录
junit5的使用
weixin_44138291的博客
09-23 384
基本标注操作 @DisplayName 用于标注测试类和测试方法的名字 @Test 用于标注这个方法是测试方法 @BeforeAll 在所有测试方法开始之前，执行一次（静态方法） @AfterAll 在所有测试方法结束之后，执行一次（静态方法） @BeforeEach 在每一个测试方法，执行开始之前，都会执行（非静态方法） @AfterEach 在每一个测试方法，执行结束之后，都会执行（非静态方法） 例如： @DisplayName("junit测试用例") public class Juni
使用JUnit5进行单元测试
02-25
JUnit作为Java单元测试的鼻祖与事实上的标准，在非常多的项目中被使用。即便新兴的单元测试框架，如TestNG等，不断出现，JUnit的重要性仍然是不言而喻的。目前广泛使用的是JUnit4版本，而JUnit即将迎来它的最新版本...
Junit5依赖整合包
11-23
将里面所有依赖添加完后就可以使用了Junit5了
Junit5的使用
Gavin
02-10 1576
Junit5 描述: JUnit 5 是 JUnit4的下一代产品。与以前版本的 JUnit 不同，JUnit 5 由来自三个不同子项目的几个不同模块组成。 JUnit 5 = JUnit Platform + JUnit Jupiter + JUnit Vintage 目标是为 JVM 上的开发人员端测试创建最新的基础。这包括专注于Java 8及更高版本，以及支持许多不同风格的测试。 springboot 2.2.0开始引入Junit5作为单元测试的默认库 在spring test中已经导入了关于.
JUnit5教程-注解
最新发布
竹林幽深
04-01 56
发表于 2017-10-10 | 分类于。
JUnit5基础教程
开源优测
04-16 713
JUnit5是Java的单元测试框架,用于测试Java程序代码。作为一名软件测试工程师,掌握JUnit是非常重要的。我们将从头开始,一步步学习JUnit5的用法。一、准备工作1. 在Maven项目中添加JUnit5依赖: <dependency> <groupId>org.junit.jupiter</groupId> <artifactI...
java单元测试JUnit框架原理与用法实例教程
08-28
主要介绍了java单元测试JUnit框架原理与用法,结合实例形式较为详细的分析了java单元测试JUnit框架的概念、原理、使用方法及相关注意事项,需要的朋友可以参考下
用JUnit框架实现Java单元测试
02-04
单元测试是整个测试流程中最基础的部分，它们要求程序员尽可能早地发现问题，并给予控制，这是其一。另外，如果集成测试出现问题，它们可以帮助诊断。这样就为在软件开发流程中建立高效的事件反应机制打下了坚实基础...
JBuilder2005单元测试之JUnit框架
01-20
简单的框架 JUnit是由Erich Gamma和Kent Beck开发的开源测试框架，JBuilder集成了这个框架并对此做了扩展。JUnit之所以流行并为广大的开发人员所推崇，一是因为它实战性强，功能强大，二是因为它实在简单。一个产品...
Junuit5的使用说明
HM_1011000000的博客
05-18 443
JUnit 5采用模块化架构，由JUnit Platform、JUnit Jupiter和JUnit Vintage三个子项目组成。JUnit Platform提供了测试运行和扩展的基础设施，JUnit Jupiter是JUnit 5新引入的编写测试的API，而JUnit Vintage提供了对JUnit 3和JUnit 4的兼容性支持。除了使用内置的参数源注解，您还可以自定义参数解析器来提供参数。通过实现ArgumentsProvider接口，您可以创建自己的参数解析器，并将其应用于参数化测试。
junit5.rar包含JUnit Platform + JUnit Jupiter + JUnit Vintage依赖jar包
08-23
JUnit 5 = JUnit Platform + JUnit Jupiter + JUnit Vintage,包含依赖包：junit-jupiter-5.5.1.jar，junit-jupiter-engine-5.5.1.jar，junit-jupiter-params-5.5.1.jar，junit-platform-launcher-1.5.1.jar，junit-platform-testkit-1.5.1.jar，junit-vintage-engine-5.5.1.jar，system-rules-1.18.0.jar JUnit Platform是在JVM上启动测试框架的基础。 JUnit Jupiter是JUnit5扩展的新的编程模型和扩展模型，用来编写测试用例。Jupiter子项目为在平台上运行Jupiter的测试提供了一个TestEngine （测试引擎）。 JUnit Vintage提供了一个在平台上运行JUnit 3和JUnit 4的TestEngine 。
《单元测试》Junit5入门教程——非常详细，入门即精通
雨水的早晨的博客
10-14 5542
junit5入门教程，junit5依赖，常用注解，套件测试
Junit5依赖
m0_49516427的博客
07-31 3547
Junit5依赖 （尽量保持依赖的版本号一致） <dependencies> <dependency> <groupId>org.junit.jupiter</groupId> <artifactId>junit-jupiter-engine</artifactId> <version>5.6.2</version>
junit5相关依赖的写法
happymff的博客
08-15 4378
<dependency> <groupId>org.junit.platform</groupId> <artifactId>junit-platform-commons</artifactId> <version>1.0.0-RC2</version> </dependency> <depend
JUnit5 Maven 依赖项
热门推荐
qq_44336097的博客
04-23 1万+
了解使用 Maven 配置其 JUnit5 的不同模块，以及如何使用它们创建和执行测试。 请注意，JUnit5 在运行时需要 Java8。 1. JUnit5 Maven 依赖项 要通过 maven 运行 JUnit5 测试，您将至少需要两个依赖项。 JUnit Jupiter 引擎依赖项 JUnit Jupiter 需要具有两个依赖项，即junit-jupiter-api和junit-jupiter-engine。junit-jupiter-api具有 junit 注解（例如@Test）以编写测试和扩展名
Junit 5 单元测试框架
xaiobit_hl的博客
04-01 1001
Junit 5 单元测试框架
【Junit5】就这篇，带你从入门到进阶
CYK_byte的博客
02-14 1648
我们对自己的项目实施Web自动化测试使用的是selenium脚本实现的，而junit就是一个强大的单元测试工具，让测试更加完整全面，接下来我们就来学习一下junit的强大功能吧~
开发的测试必备- Junit5和mock&&postman和jmeter
qq_45126590的博客
05-18 994
使用Assert类的静态方法，assertEquals()，包含两个参数，左边是预期值，右边是实际值。当预期值与实际值不同时便会报错。/**//注意这个不能忘记！！要不然后面无法调用 private Calculator calculator;} }} }点击运行，实际值与预期值相符，测试通过。如果不相符，则会出现下列字样。
什么是JUnit单元测试？
12-11
JUnit是一个用于Java语言的单元测试框架，它可以帮助开发人员简化单元测试的工作量。单元测试是指对项目最小的功能模块进行测试，在C语言中可能是一个函数，在Java中可能就是一个类或一个方法了。JUnit提供了一些...

“相关推荐”对你有帮助么？

  • 非常没帮助
  • 没帮助
  • 一般
  • 有帮助
  • 非常有帮助
提交
评论
添加红包

请填写红包祝福语或标题

个

红包个数最小为10个

元

红包金额最低5元

当前余额3.43元 前往充值 >
需支付：10.00元
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付元
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明：

1.余额是钱包充值的虚拟货币，按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载，可以购买VIP、付费专栏及课程。

余额充值