SonarQube问题“为这个测试用例添加至少一个断言”用于带断言的单元测试?

时间:2016-08-04 09:55:31

标签: java unit-testing junit sonarqube

我遇到SonarQube问题,引发了我的几个单元测试问题,引发了以下问题:

  

在此测试用例中添加至少一个断言。

每个测试用例都类似于这种格式(其中许多断言被委托给具有公共断言的方法,以避免重复):

@Test
public void companyNameOneTooLong() throws Exception {
    AddressFormBean formBean = getValidBean();
    formBean.setCompanyNameOne("123456789012345678901234567890123456");

    assertViolation(validator.validate(formBean), "companyNameOne", "length must be between 0 and 35");
}

private void assertViolation(Set<ConstraintViolation<AddressFormBean>> violations, String fieldname, String message) {
    assertThat(violations, hasSize(1));
    assertEquals(fieldname, violations.iterator().next().getPropertyPath().iterator().next().getName());
    assertEquals(message, violations.iterator().next().getMessage());
}

现在,显然我可以将三个断言从私有方法中拉出来并将它们放入测试方法中 - 但是我在多个时间执行相同的检查(在不同的字段上)。

所以,我认为我会尝试通过(重新)抛出AssertionError来模仿断言方法的行为:

private void assertViolation(Set<ConstraintViolation<AddressFormBean>> violations, String fieldname, String message) throws AssertionError {
    try {
        assertThat(violations, hasSize(1));
        assertEquals(fieldname, violations.iterator().next().getPropertyPath().iterator().next().getName());
        assertEquals(message, violations.iterator().next().getMessage());
    } catch (AssertionError e) {
        throw e;
    }
 }

不幸的是,这种方法也不起作用。

JUnit断言方法有什么特别之处/什么是SonarQube专门检查是否已为每个测试做出断言?

或者 - 是否有其他方法可以实现相同的最终结果(避免反复重复共享断言代码)?

3 个答案:

答案 0 :(得分:6)

来自 SonarQube Java Analyzer 的规则S2699(测试应该包含断言)不会执行跨程序分析,只会探索被识别为测试方法的方法体(通常用@Test)。

因此,如果在执行测试方法时将调用的唯一断言是通过专用方法完成的(以避免重复),则该规则将引发问题。这是规则的已知限制,只有当我们能够有效地执行跨程序分析时,我们才会处理它。

关于SonarQube针对此类案例提出的问题,您可以安全地将其标记为Won't Fix

关于检测到的断言,规则将断言视为以下(单元测试)框架中常用的assert / fail / verify / expect方法:

  • JUnit的
  • Fest(1.x&amp; 2.x)
  • AssertJ
  • Hamcrest
  • 的Mockito
  • 弹簧
  • EasyMock的

答案 1 :(得分:1)

如果您不希望测试中引发任何异常,则可以采用以下解决方法:

@Test(expected = Test.None.class /* no exception expected */)

或者,您可以取消针对测试方法/测试类的警告:

@SuppressWarning("squid:S2699")

答案 2 :(得分:1)

有时不需要任何代码或断言,例如加载spring boot上下文的测试成功。在这种情况下,为了防止在您不希望从测试中抛出任何异常时出现声纳问题,您可以使用这部分代码:

@Test
void contextLoads() {
    Assertions.assertDoesNotThrow(this::doNotThrowException);
}

private void doNotThrowException(){
    //This method will never throw exception
}