JUnit5 预期的异常 – assertThrows()示例

JUnit5 预期的异常 – assertThrows()示例

原文: https://howtodoinjava.com/junit5/expected-exception-example/

在 JUnit5 中,要测试异常情况,则应使用org.junit.jupiter.api.Assertions.assertThrows()方法。 JUnit5 异常测试还有其他方法,但我建议避免使用它们。

1. JUnit5 assertThrows()的语法

它断言所提供的executable的执行将引发expectedType的异常并返回该异常。

public static <T extends Throwable> T assertThrows(Class<T> expectedType, Executable executable)

如果没有引发异常,或者引发了其他类型的异常,则此方法将失败。

请注意,允许使用相同类型的异常。 例如,如果您期望NumberFormatException并且抛出IllegalArgumentException,那么该测试也会通过,因为NumberFormatException扩展了IllegalArgumentException类。

2. JUnit5 预期异常示例

一个非常简单的示例可以是:

@Test
void testExpectedException() {

  Assertions.assertThrows(NumberFormatException.class, () -> {
    Integer.parseInt("One");
  });

}

如果参数不是有效数字,则此处的可执行代码为Integer.parseInt("One")引发NumberFormatException。 在上述代码中,"One"不是有效数字,因此代码将引发assertThrows()方法所期望的异常 - 因此测试通过。

3. 预期异常类的超类型

如前所述,您也可以期望异常类的超类型。 例如,上面的测试也可以用IllegalArgumentException编写。

@Test
void testExpectedExceptionWithSuperType() {

  Assertions.assertThrows(IllegalArgumentException.class, () -> {
    Integer.parseInt("One");
  });

}

该测试用例也将通过。

4. 其他预期异常类

如果可执行代码抛出任何其他异常类型,则测试将失败;否则,测试将失败。 甚至如果测试没有引发任何异常,那么测试也会失败。

例如,在下面的示例中,"1"是有效数字,因此不会引发异常。

@Test
void testExpectedExceptionFail() {

  Assertions.assertThrows(IllegalArgumentException.class, () -> {
    Integer.parseInt("1");
  });

}

5. 完整的例子

这是 JUnit5 断言异常消息的完整代码。

package com.howtodoinjava.junit5.examples.module;

import org.junit.jupiter.api.Assertions;
import org.junit.jupiter.api.Test;

public class AppTest {

  @Test
  void testExpectedException() {

    Assertions.assertThrows(NumberFormatException.class, () -> {
      Integer.parseInt("One");
    });
  }

  @Test
  void testExpectedExceptionWithSuperType() {

    Assertions.assertThrows(IllegalArgumentException.class, () -> {
      Integer.parseInt("One");
    });
  }

  @Test
  void testExpectedExceptionFail() {

    Assertions.assertThrows(IllegalArgumentException.class, () -> {
      Integer.parseInt("1");
    });
  }

}

现在,使用测试套件执行此类。 您可以在 maven 示例中查看完整的项目配置。

package com.howtodoinjava.junit5.examples;

import org.junit.platform.runner.JUnitPlatform;
import org.junit.platform.suite.api.SelectPackages;
import org.junit.runner.RunWith;

@RunWith(JUnitPlatform.class)
@SelectPackages("com.howtodoinjava.junit5.examples")
public class JUnit5Example 
{
}

Eclipse 测试结果如下图所示:

JUnit5 Expected Exception Tests

JUnit5 预期异常测试

这就是 JUnit5 异常测试的全部。 将我的问题放在评论部分。

学习愉快!

源码下载