如何使用JUnit Test注释声明异常消息?


313

我写了一些带有@Test注释的JUnit测试。如果我的测试方法引发了一个已检查的异常,并且我想与该异常一起声明该消息,是否可以使用JUnit @Test注释来做到这一点?AFAIK,JUnit 4.7不提供此功能,但是将来的版本会提供吗?我知道在.NET中,您可以断言消息和异常类。在Java世界中寻找类似的功能。

这就是我要的:

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

1
现在,我再想一想...确定消息是个好主意吗?您的问题使我稍微深入了junit源代码,似乎他们可以轻松添加此功能。他们做的其实不是,让我觉得它可能不会被认为是一个很好的做法。为什么在您的项目中声明消息很重要?
c_maker 2010年

9
假设一个包含15行代码的方法在2个不同的地方抛出相同的异常。我的测试用例不仅需要声明异常类,还需要声明其中的消息。在理想情况下,任何异常行为都应有其自己的异常。如果是这样,我的问题将永远不会出现,但是生产应用程序对于每种异常行为都没有其独特的自定义异常。
Cshah'3

附带说明@expectedExceptionMessage-PHPUnit中有注释。
bancer

Answers:


535

您可以将@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...
    System.out.println("=======Starting Exception process=======");
    throw new NullPointerException("Employee ID is null");
}

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


1
注意:对我来说,当将_ expectMessage指定为空字符串时,未执行该消息的比较
redDevil

1
对我有用。谢谢。throws RuntimeException在添加引发异常的代码之后,测试方法应该具有。不要抓住...
Bumbolt

5
我个人不希望使用此方法,因为为一小部分方法创建字段是不好的做法。不是对响应的批评,而是对JUnit设计的批评。OP的假设解决方案如果存在的话会更好。
Sridhar Sarnobat '16

2
@redDevil:expectedMessage检查错误消息是否“包含”此函数中指定的字符串(例如错误消息的子字符串)
tuan.dinh

3
带字符串参数的ExpectMessage会执行String.contains检查,对于异常消息的精确匹配,请使用hamcrest匹配器failure.expectMessage(CoreMatchers.equalTo(...))
Sivabalan

41

我喜欢@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!");
  }

32

你要用@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());
  }
}

6
我知道要编写一个catch块并在其中使用assert,但是为了获得更好的代码可读性,我想使用注释。
Cshah

同样,您也不会像以“正确”的方式进行操作时得到的那样好消息。
NeplatnyUdaj

15
JUnit现在提供@Test(expected=...)和的try / catch版本的问题ExpectedException是,我在很多场合都看到有人忘记将调用放在代码块fail()的末尾try。如果未通过代码审查捕获,则您的测试可能为假阳性并始终通过。
威廉·普赖斯

这就是为什么我不喜欢所有这些声明性内容的原因。这使得难以访问您想要的内容。
Sridhar Sarnobat

30

在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;

...

喜欢这个解决方案。应该移至
JUnit5。– WesternGun

Gaaaaaaaaa。截止到今天(2019年秋季),4.13仍处于beta版吗? mvnrepository.com/artifact/junit/junit
granadaCoder

v4.13不再处于beta状态(于2020年1月发布)
Simon

11

实际上,最好的用法是使用try / catch。为什么?因为您可以控制发生异常的位置。

考虑以下示例:

@Test (expected = RuntimeException.class)
public void someTest() {
   // test preparation
   // actual test
}

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

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


可悲的是,这也是我的答案。
Sridhar Sarnobat '16

2
通过使用较小的,特定于排列的测试用例,可以减轻对代码更改的担忧。有时这是不可避免的,我们必须依靠catch / try方法,但是如果这种情况经常发生,则有可能需要修改编写测试用例函数的方式。
luis.espinal

那是您的测试和/或代码的问题。您不希望遇到一般的RuntimeException,不要期待特定的异常,或者至少是特定的消息。
DennisK '16

RuntimeException以一个示例为例,将此异常替换为任何其他异常。
Krzysztof Cislo

8

雷暴有一个很好的答案。我也不是规则的忠实拥护者。除了创建以下实用程序类以帮助提高可读性和可用性外,我执行了类似的操作,这首先是批注的一大优点。

添加此实用程序类:

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"
}

2

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


2
使用Jesse Merriman响应,仅在调用ExpectedEx.expect()和ExpectedEx.expectMessage()的测试方法中检查异常。其他方法将使用定义expectedEx = ExpectedException.none(),即没有异常。
2016年

2

我从不喜欢用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");
}

1

我喜欢user64141的答案,但发现它可以更概括。这是我的看法:

public abstract class ExpectedThrowableAsserter implements Runnable {

    private final Class<? extends Throwable> throwableClass;
    private final String expectedExceptionMessage;

    protected ExpectedThrowableAsserter(Class<? extends Throwable> throwableClass, String expectedExceptionMessage) {
        this.throwableClass = throwableClass;
        this.expectedExceptionMessage = expectedExceptionMessage;
    }

    public final void run() {
        try {
            expectException();
        } catch (Throwable e) {
            assertTrue(String.format("Caught unexpected %s", e.getClass().getSimpleName()), throwableClass.isInstance(e));
            assertEquals(String.format("%s caught, but unexpected message", throwableClass.getSimpleName()), expectedExceptionMessage, e.getMessage());
            return;
        }
        fail(String.format("Expected %s, but no exception was thrown.", throwableClass.getSimpleName()));
    }

    protected abstract void expectException();

}

请注意,将“ fail”语句保留在try块内会导致捕获相关的断言异常。在catch语句中使用return可以防止这种情况。


0

导入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()
  )
);

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

有人可以帮我理解为什么这个答案是-1
aasha

问题是要问,Junit但您的答案是给我们的TestNG
尹华哲
By using our site, you acknowledge that you have read and understand our Cookie Policy and Privacy Policy.
Licensed under cc by-sa 3.0 with attribution required.