Junit常用断言方法超全详解 | 新手入门JUnit

在一般的测试流程种，执行完测试代码后，你可以通过 JUnit 的断言 来检查测试结果是否符合预期。常用的断言包括 assertEquals()、assertTrue()、assertNull() 等。下面将对JUnit常用的断言方法进行一一介绍。

JUnit 常用的断言方法

在 JUnit 5 中，所有断言方法都位于 org.junit.jupiter.api.Assertions 类中。常见的断言包括：

1. assertEquals(expected, actual)：断言两个值是否相等。
2. assertNotEquals(unexpected, actual)：断言两个值是否不相等。
3. assertTrue(condition)：断言条件为 true。
4. assertFalse(condition)：断言条件为 false。
5. assertNull(object)：断言对象是否为 null。
6. assertNotNull(object)：断言对象是否不为 null。
7. assertSame(expected, actual)：断言两个对象引用是否指向同一个对象。
8. assertNotSame(unexpected, actual)：断言两个对象引用是否不指向同一个对象。
9. assertThrows(expectedType, executable)：断言执行代码时抛出特定类型的异常。
10. assertTimeout(duration, executable)：断言在指定的时间内执行完成。

1. assertEquals(expected, actual)

assertEquals() 用于验证两个值是否相等，通常用于比较基本类型或重写了 equals() 方法的对象。

示例：

@Test
public void testAssertEquals() {
    int expected = 42;
    int actual = 42;
    assertEquals(expected, actual);  // 断言通过，两个值相等
}

可以带一个消息参数，方便调试：

assertEquals(expected, actual, "The values should be equal.");

2. assertNotEquals(unexpected, actual)

assertNotEquals() 用于验证两个值是否不相等。

示例：

@Test
public void testAssertNotEquals() {
    String actual = "Hello";
    String unexpected = "Goodbye";
    assertNotEquals(unexpected, actual);  // 断言通过，两个值不相等
}

3. assertTrue(condition)

assertTrue() 用于验证条件是否为 true。

示例：

@Test
public void testAssertTrue() {
    boolean condition = 5 > 3;
    assertTrue(condition);  // 断言通过，条件为 true
}

可以带自定义消息：

assertTrue(condition, "The condition should be true.");

4. assertFalse(condition)

assertFalse() 用于验证条件是否为 false。

示例：

@Test
public void testAssertFalse() {
    boolean condition = 5 < 3;
    assertFalse(condition);  // 断言通过，条件为 false
}

5. assertNull(object)

assertNull() 用于验证对象是否为 null。

示例：

@Test
public void testAssertNull() {
    String value = null;
    assertNull(value);  // 断言通过，value 为 null
}

6. assertNotNull(object)

assertNotNull() 用于验证对象是否不为 null。

示例：

@Test
public void testAssertNotNull() {
    String value = "JUnit";
    assertNotNull(value);  // 断言通过，value 不为 null
}

7. assertSame(expected, actual)

assertSame() 用于验证两个对象是否指向同一个引用（即，比较两个对象的内存地址是否相同）。

示例：

@Test
public void testAssertSame() {
    String str1 = "JUnit";
    String str2 = str1;  // 两个引用指向同一个对象
    assertSame(str1, str2);  // 断言通过
}

8. assertNotSame(unexpected, actual)

assertNotSame() 用于验证两个对象引用是否不相同。

示例：

@Test
public void testAssertNotSame() {
    String str1 = new String("JUnit");
    String str2 = new String("JUnit");
    assertNotSame(str1, str2);  // 断言通过，两个引用不相同
}

9. assertThrows(expectedType, executable)

assertThrows() 用于验证某段代码是否抛出了特定类型的异常。

示例：

@Test
public void testAssertThrows() {
    assertThrows(IllegalArgumentException.class, () -> {
        throw new IllegalArgumentException("Invalid argument");
    });
}

如果没有抛出异常或抛出了不同类型的异常，测试将失败。

10. assertTimeout(duration, executable)

assertTimeout() 用于验证某段代码是否在指定时间内完成。如果代码执行时间超过了指定的时间，测试将失败。

示例：

import java.time.Duration;

@Test
public void testAssertTimeout() {
    assertTimeout(Duration.ofSeconds(1), () -> {
        // 模拟耗时操作
        Thread.sleep(500);
    });
}

其他断言方法

1. assertArrayEquals(expectedArray, actualArray)

用于验证两个数组是否相等。

示例：

@Test
public void testAssertArrayEquals() {
    int[] expectedArray = {1, 2, 3};
    int[] actualArray = {1, 2, 3};
    assertArrayEquals(expectedArray, actualArray);  // 断言通过
}

2. assertIterableEquals(expected, actual)

用于验证两个 Iterable 对象是否相等。

示例：

@Test
public void testAssertIterableEquals() {
    List<String> expected = Arrays.asList("a", "b", "c");
    List<String> actual = Arrays.asList("a", "b", "c");
    assertIterableEquals(expected, actual);  // 断言通过
}

3. assertLinesMatch(expected, actual)

用于验证两个字符串列表的每一行是否匹配。常用于多行文本的比较。

示例：

@Test
public void testAssertLinesMatch() {
    List<String> expectedLines = Arrays.asList("line1", "line2");
    List<String> actualLines = Arrays.asList("line1", "line2");
    assertLinesMatch(expectedLines, actualLines);  // 断言通过
}

断言的灵活性

大多数 JUnit 断言方法都可以带上一个可选的第三个参数，表示失败时的自定义消息。自定义消息有助于在调试时快速找到问题。例如：

assertEquals(42, actualValue, "The actual value should be 42.");

当断言失败时，会输出 "The actual value should be 42." 这样的提示，帮助你快速定位问题。