junit5 入门系列教程-12-junit5 依赖注入构造器、方法

时间:2025-03-27 09:19:48

目录

  • 目录
  • 依赖注入
    • TestInfoParameterResolver
    • RepetitionInfoParameterResolver
    • TestReporterParameterResolver
    • @ExtendWith
      • RandomParametersExtension
      • 其他
  • 系列导航

依赖注入

在所有以前的JUnit版本中,都不允许测试构造函数或方法具有参数(至少不允许使用标准的Runner实现)。
作为JUnit Jupiter的主要变化之一,测试构造函数和方法现在都允许有参数。这允许更大的灵活性,并支持构造函数和方法的依赖注入。

ParameterResolver用于测试扩展的API,可以在运行时动态解析参数。
如果测试构造函数或@Test、@TestFactory、@BeforeEach、@AfterEach、@BeforeAll或@AfterAll方法接受一个参数,则必须由注册的参数解析器在运行时解析该参数。

目前有三个内置的解析器是自动注册的。

TestInfoParameterResolver

如果一个方法参数是TestInfo类型,那么TestInfoParameterResolver将提供一个与当前测试对应的TestInfo实例作为参数的值。
然后,TestInfo可以用来检索关于当前测试的信息,比如测试的显示名称、测试类、测试方法或相关的标记。
DisplayName 可以是技术名称,例如测试类或测试方法的名称,也可以是通过 @DisplayName 配置的自定义名称。

TestInfo作为来自JUnit 4的TestName规则的drop-in替换。

下面演示如何将TestInfo注入到测试构造函数@BeforeEach方法和@Test方法中。

import ;
import ;
import ;
import ;
import ;

import static ;
import static ;

@DisplayName("TestInfo Demo")
public class TestInfoDemo {

    TestInfoDemo(TestInfo testInfo) {
        assertEquals("TestInfo Demo", ());
    }

    @BeforeEach
    void init(TestInfo testInfo) {
        String displayName = ();
        assertTrue(("TEST 1") || ("test2()"));
    }

    @Test
    @DisplayName("TEST 1")
    @Tag("my-tag")
    void test1(TestInfo testInfo) {
        assertEquals("TEST 1", ());
        assertTrue(().contains("my-tag"));
    }

    @Test
    void test2() {
    }
}

RepetitionInfoParameterResolver

如果@RepeatedTest、@BeforeEach或@AfterEach方法中的方法参数类型为repeat tioninfo,那么repeat infoparameresolver将提供一个repeat tioninfo实例。
重复信息可以用来检索当前重复的信息以及对应的@RepeatedTest的重复次数。
但是,请注意,RepetitionInfoParameterResolver 不在 @RepeatedTest 的上下文中注册。

TestReporterParameterResolver

如果方法参数为TestReporter类型,则TestReporterParameterResolver将提供TestReporter的实例。
可以使用TestReporter发布关于当前测试运行的其他数据。
数据可以通过()来使用,因此可以由ide查看或包含在报表中。

在JUnit Jupiter中,您应该使用TestReporter,在那里您可以将信息打印到JUnit 4中的stdout或stderr。
使用@RunWith()甚至会将所有报告的条目输出到stdout。

import ;

import ;
import ;

class TestReporterDemo {

    @Test
    void reportSingleValue(TestReporter testReporter) {
        ("a key", "a value");
    }

    @Test
    void reportSeveralValues(TestReporter testReporter) {
        HashMap<String, String> values = new HashMap<>();
        ("user name", "dk38");
        ("award year", "1974");

        (values);
    }
}

@ExtendWith

通过@ExtendWith注册适当的扩展,必须显式地启用其他参数解析器。

RandomParametersExtension

参见 RandomParametersExtension

import ;
import ;

import static ;
import static ;

@ExtendWith()
class MyRandomParametersTest {

    @Test
    void injectsInteger(@Random int i, @Random int j) {
        assertNotEquals(i, j);
    }

    @Test
    void injectsDouble(@Random double d) {
        assertEquals(0.0, d, 1.0);
    }

}

其他

MockitoExtension

SpringExtention

系列导航

系列导航