Question

我用@Test注释编写了一些JUnit测试。如果我的测试方法抛出一个已检查的异常，并且如果我想将该消息与异常一起断言，是否有办法使用JUnit @Test注释？ AFAIK，JUnit 4.7不提供此功能，但未来的版本是否提供此功能？我知道在.NET中你可以断言消息和异常类。寻找Java世界中的类似功能。

这就是我想要的：

@Test (expected = RuntimeException.class, message = "Employee ID is null")
public void shouldThrowRuntimeExceptionWhenEmployeeIDisNull() {}

Answer 1

您可以将@Rule注释与ExpectedException一起使用，如下所示：

@Rule
public ExpectedException expectedEx = ExpectedException.none();

@Test
public void shouldThrowRuntimeExceptionWhenEmployeeIDisNull() throws Exception {
    expectedEx.expect(RuntimeException.class);
    expectedEx.expectMessage("Employee ID is null");
    // do something that should throw the exception...
}

请注意，ExpectedException文档中的示例（当前）是错误的 - 没有公共构造函数，因此您必须使用ExpectedException.none()。

Answer 2

我喜欢@Rule答案。但是，如果由于某种原因您不想使用规则。还有第三种选择。

@Test (expected = RuntimeException.class)
public void myTestMethod()
{
   try
   {
      //Run exception throwing operation here
   }
   catch(RuntimeException re)
   {
      String message = "Employee ID is null";
      assertEquals(message, re.getMessage());
      throw re;
    }
    fail("Employee Id Null exception did not throw!");
  }

Answer 3

你必须使用@Test(expected=SomeException.class)吗？当我们必须断言异常的实际消息时，这就是我们所做的。

@Test
public void myTestMethod()
{
  try
  {
    final Integer employeeId = null;
    new Employee(employeeId);
    fail("Should have thrown SomeException but did not!");
  }
  catch( final SomeException e )
  {
    final String msg = "Employee ID is null";
    assertEquals(msg, e.getMessage());
  }
}

Answer 4

在JUnit 4.13（一旦发布）中，您可以执行以下操作：

import static org.junit.Assert.assertEquals;
import static org.junit.Assert.assertThrows;

...

@Test
void exceptionTesting() {
  IllegalArgumentException exception = assertThrows(
    IllegalArgumentException.class, 
    () -> { throw new IllegalArgumentException("a message"); }
  );

  assertEquals("a message", exception.getMessage());
}

这在JUnit 5中也适用，但具有不同的导入：

import static org.junit.jupiter.api.Assertions.assertEquals;
import static org.junit.jupiter.api.Assertions.assertThrows;

...

Answer 5

实际上，最好的用法是使用try / catch。为什么？因为您可以控制预期异常的位置。

考虑这个例子：

mWebView.getSettings().setJavaScriptEnabled(true);

如果有一天代码被修改并且测试准备会抛出RuntimeException怎么办？在那种情况下，实际测试甚至没有经过测试，即使它没有抛出任何异常，测试也会通过。

这就是为什么使用try / catch比依赖注释要好得多。

Answer 6

Raystorm有一个很好的答案。我也不是规则的忠实粉丝。我做了类似的事情，除了我创建以下实用程序类以帮助可读性和可用性，这是首先注释的一大优点。

添加此实用程序类：

import org.junit.Assert;

public abstract class ExpectedRuntimeExceptionAsserter {

    private String expectedExceptionMessage;

    public ExpectedRuntimeExceptionAsserter(String expectedExceptionMessage) {
        this.expectedExceptionMessage = expectedExceptionMessage;
    }

    public final void run(){
        try{
            expectException();
            Assert.fail(String.format("Expected a RuntimeException '%s'", expectedExceptionMessage));
        } catch (RuntimeException e){
            Assert.assertEquals("RuntimeException caught, but unexpected message", expectedExceptionMessage, e.getMessage());
        }
    }

    protected abstract void expectException();

}

然后，对于我的单元测试，我需要的就是这段代码：

@Test
public void verifyAnonymousUserCantAccessPrivilegedResourceTest(){
    new ExpectedRuntimeExceptionAsserter("anonymous user can't access privileged resource"){
        @Override
        protected void expectException() {
            throw new RuntimeException("anonymous user can't access privileged resource");
        }
    }.run(); //passes test; expected exception is caught, and this @Test returns normally as "Passed"
}

Answer 7

如果使用@Rule，则异常集将应用于Test类中的所有测试方法。

Answer 8

我喜欢user64141的答案，但发现它可能更通用。这是我的看法：

share_number

请注意，离开＆＃34;失败＆＃34; try块中的语句导致捕获相关的断言异常;在catch语句中使用return可以防止这种情况发生。

Answer 9

我从不喜欢用Junit声明异常的方式。如果我在批注中使用“期望的”，从我的角度来看，我们似乎违反了“给定，何时，那么”模式，因为“则”位于测试定义的顶部。

此外，如果我们使用“ @Rule”，则必须处理大量样板代码。因此，如果您可以为测试安装新的库，建议您看一下AssertJ（该库现在随SpringBoot一起提供了）

然后进行不违反“给定/何时/然后”原则的测试，并使用AssertJ进行验证：

1-例外是我们所期望的。 2-它也有预期的消息

看起来像这样：

 @Test
void should_throwIllegalUse_when_idNotGiven() {

    //when
    final Throwable raisedException = catchThrowable(() -> getUserDAO.byId(null));

    //then
    assertThat(raisedException).isInstanceOf(IllegalArgumentException.class)
            .hasMessageContaining("Id to fetch is mandatory");
}

Answer 10

导入catch-exception库，然后使用它。它比ExpectedException规则或try-catch更清晰。

他们的文档示例：

import static com.googlecode.catchexception.CatchException.*;
import static com.googlecode.catchexception.apis.CatchExceptionHamcrestMatchers.*;

// given: an empty list
List myList = new ArrayList();

// when: we try to get the first element of the list
catchException(myList).get(1);

// then: we expect an IndexOutOfBoundsException with message "Index: 1, Size: 0"
assertThat(caughtException(),
  allOf(
    instanceOf(IndexOutOfBoundsException.class),
    hasMessage("Index: 1, Size: 0"),
    hasNoCause()
  )
);

Answer 11

为此，我希望使用AssertJ。

        assertThatExceptionOfType(ExpectedException.class)
        .isThrownBy(() -> {
            // method call
        }).withMessage("My message");

Answer 12

@Test (expectedExceptions = ValidationException.class, expectedExceptionsMessageRegExp = "This is not allowed")
public void testInvalidValidation() throws Exception{
     //test code
}

如何使用JUnit Test注释断言我的异常消息？

12 个答案: