【JAVA UT】4、Assert--验证结果是否符合期望

文|码术张

被测功能运行结果是预期的结果吗？
用Assert类提供的方法进行验证。
Assert类中，有很多种验证的方法。
按是否使用Matcher技术，可分为两类。

一、不使用Matcher技术的方法

Junit中，这类方法有近40多个。
按所比较对象是否为数组，分为两类：

1. 比较的对象是数组。
2. 比较的对象不是数组。

这两类中的每一类，可继续按比较对象的类型，划分为两类：

1. 基本数据类型
2. 其他类型

所以，一共有如下4组：

1. 比较的对象是数组，数组元素的类型是基本数据类型

assertArrayEquals(byte[] expecteds, byte[] actuals);
assertArrayEquals(char[] expecteds, char[] actuals);
assertArrayEquals(int[] expecteds, int[] actuals);
assertArrayEquals(long[] expecteds, long[] actuals);
assertArrayEquals(short[] expecteds, short[] actuals);

assertArrayEquals(java.lang.String message, byte[] expecteds, byte[] actuals);
assertArrayEquals(java.lang.String message, char[] expecteds, char[] actuals);
assertArrayEquals(java.lang.String message, int[] expecteds, int[] actuals);
assertArrayEquals(java.lang.String message, long[] expecteds, long[] actuals);
assertArrayEquals(java.lang.String message, short[] expecteds, short[] actuals);

2. 比较的对象是数组，元素的类型是其他数据类型

assertArrayEquals(java.lang.Object[] expecteds, java.lang.Object[] actuals);
assertArrayEquals(java.lang.String message, java.lang.Object[] expecteds, java.lang.Object[] actuals);

3. 比较的对象是单个元素，元素类型是基本数据类型

assertEquals(double expected, double actual, double delta);
assertEquals(long expected, long actual);
assertFalse(boolean condition);
assertTrue(boolean condition);

assertEquals(java.lang.String message, double expected, double actual, double delta);
assertEquals(java.lang.String message, long expected, long actual);
assertFalse(java.lang.String message, boolean condition);
assertTrue(java.lang.String message, boolean condition);

4. 比较的对象是单个元素，元素类型是其他数据类型

assertEquals(java.lang.Object expected, java.lang.Object actual);
assertNotNull(java.lang.Object object);
assertNotSame(java.lang.Object unexpected, java.lang.Object actual);
assertNull(java.lang.Object object);
assertSame(java.lang.Object expected, java.lang.Object actual);

assertEquals(java.lang.String message, java.lang.Object expected, java.lang.Object actual);
assertNotNull(java.lang.String message, java.lang.Object object);
assertNotSame(java.lang.String message, java.lang.Object unexpected, java.lang.Object actual);
assertNull(java.lang.String message, java.lang.Object object);
assertSame(java.lang.String message, java.lang.Object expected, java.lang.Object actual);

如何使用呢？
假设比较的数据为String类型，
目的是检查它们是否相等，
那么，就选择下面这个方法：
assertEquals(java.lang.Object expected, java.lang.Object actual);
例如：

public class AssertTests {
  @Test
  public void should_Equals() {
    String expectedResult = "him";

    String actualResult = "she";

    Assert.assertEquals(expectedResult, actualResult);
  }
}

运行结果如下：

result-without-message.PNG

若要从运行结果中获得额外信息，可以使用方法：
assertEquals(java.lang.String message, java.lang.Object expected, java.lang.Object actual);
参数message的信息，会在运行结果中打印出来。
将测试类修改如下：

public class AssertTests {
  @Test
  public void should_Equals() {
    String expectedResult = "him";
    String actualResult = "she";
    Assert.assertEquals("2018-05-04", expectedResult, actualResult);
  }
}

运行结果如下：

result-with-message.PNG

二、使用Matcher技术的方法

Assert类中，有一个方法使用了Matcher技术。它就是：

assertThat(actualValue, Matcher);

什么是Matcher？
Matcher是一个接口，它有方法matches。
这个方法会被assertThat以actualValue作为参数调用matches。
不同的matches方法，功能不同，例如比较两个对象是否相等，判断对象是否为空。

如何获得Matcher呢？
可以使用下面这些方法获得：
public static Matcher is(java.lang.Class type)
public static Matcher equalTo(T operand)
public static Matcher not(T value)
public static Matcher