JUnit 中异常消息验证：深入解析及实践指南

2024-03-12 09:56:54

在 JUnit 测试中验证异常消息：深入剖析和最佳实践

作为软件开发人员，编写可靠的测试对于确保代码的健壮性至关重要。断言异常消息是否与实际抛出的消息匹配是自动化测试的关键部分。本文将深入探讨在 JUnit 测试中验证异常消息的不同方法，并提供最佳实践指南。

JUnit 5：扩展异常消息验证

从 JUnit 5 开始，引入了 @ExtendWith 注解，它允许使用第三方扩展来增强测试功能。org.junit.jupiter.api.extension.ParameterResolutionException 是一个受欢迎的扩展，它提供了一种便捷的方法来断言异常消息。

使用 @ExtendWith 注解，您可以将 ParameterResolutionException 引入您的测试，如下所示：

import org.junit.jupiter.api.DisplayName;
import org.junit.jupiter.api.ExtendWith;
import org.junit.jupiter.api.Test;
import org.junit.jupiter.api.extension.ParameterResolutionException;
import org.junit.jupiter.params.ParameterizedTest;
import org.junit.jupiter.params.provider.ValueSource;

@ExtendWith(ParameterResolutionException.class)
public class ExceptionMessageAssertionTest {

    @Test
    @DisplayName("Should throw RuntimeException with specific message")
    void shouldThrowRuntimeExceptionWithMessage() {
        RuntimeException exception = assertThrows(RuntimeException.class, () -> {
            throw new RuntimeException("Employee ID is null");
        });

        assertEquals("Employee ID is null", exception.getMessage());
    }
}

此示例演示了如何使用 @ExtendWith 注解断言异常消息。 assertThrows 方法用于捕获抛出的异常，然后使用 assertEquals 方法断言消息与预期值相匹配。

AssertJ：简化异常消息验证

AssertJ 是一个流行的 Java 断言库，它提供了一组丰富的方法来简化异常消息验证。使用 AssertJ，您可以轻松断言异常消息是否包含特定文本、以特定文本开头或结尾，等等。

要使用 AssertJ 断言异常消息，您需要：

在您的项目中添加 AssertJ 依赖项。
导入 AssertJ 断言方法。

以下是使用 AssertJ 断言异常消息的示例：

import org.junit.Test;
import org.junit.runner.RunWith;
import org.junit.runners.JUnit4;

import static org.assertj.core.api.Assertions.assertThatThrownBy;

@RunWith(JUnit4.class)
public class ExceptionMessageAssertionTest {

    @Test
    public void shouldThrowRuntimeExceptionWithMessage() {
        assertThatThrownBy(() -> {
            throw new RuntimeException("Employee ID is null");
        })
            .isInstanceOf(RuntimeException.class)
            .hasMessageContaining("Employee ID is null");
    }
}