SpringBoot(20)---斷言(Assert)

雨點的名字發表於2020-09-17

SpringBoot(20)---斷言(Assert)

我們在寫單元測試的時候,除了介面直接拋異常而導致該單元測試失敗外,還有種是業務上的錯誤也代表著該單元測試失敗。好比我們在測試介面的時候,

該介面返回是1代表成功,如果是0那就代表是失敗的,這個時候可以考慮使用斷言。

一、原理

我們知道,我們可以通過斷言來校驗測試用例的返回值和實際期望值進行比較,以此來判斷測試是否通過。那我們先來看下如果失敗的情況下它的流程是怎麼樣的。

對於斷言而言,如果是錯誤最終都會進入下面的方法

    static public void fail(String message) {
        if (message == null) {
            throw new AssertionError();
        }
        throw new AssertionError(message);
    }

很明顯,這裡有一個AssertionError物件,我們來看下這個物件。

public class AssertionError extends Error {
 //......
}

我們很明顯看到,它實繼承是Error,而不是Exception。這說明什麼,說明你無法通過try catch去捕獲這個異常,只要進入斷言fail中,一定會丟擲異常。


二、Assert 原始碼

這裡只展示Assert原始碼中常用的方法,一些不常用或者過期的方法這裡就不展示了。

public class Assert {
    /**
     * 結果 = 預期 則正確
     */
    static public void assertEquals(Object expected, Object actual)
    /**
     * 結果 != 預期 則正確
     */
    static public void assertNotEquals(Object unexpected, Object actual)
    /**
     * condition == true 則正確
     */
    static public void assertTrue(boolean condition)
    /**
     * condition == false 則正確
     */
    static public void assertFalse(boolean condition)
    /**
     * 永遠是錯誤
     */
    static public void fail()
    /**
     * 結果不為空 則正確
     */
    static public void assertNotNull(Object object)
    /**
     * 結果為空 則正確
     */
    static public void assertNull(Object object)
    /**
     * 兩個物件引用 相等 則正確(上面相當於equels 這裡類似於使用“==”比較兩個物件)
     */
    static public void assertSame(Object expected, Object actual)
    /**
     * 兩個物件引用 不相等 則正確
     */
    static public void assertNotSame(Object unexpected, Object actual)
    /**
     * 兩個陣列相等 則正確
     */
    public static void assertArrayEquals(Object[] expecteds, Object[] actuals)
    /**
     * 這個單獨介紹
     */
    public static <T> void assertThat(T actual, Matcher<? super T> matcher)  
}

注意 上面每一個方法,都會有一個多一個引數的方法,這個引數為:String message。意思就是錯誤的情況下,我們可以輸出我們自定義的message

示例

   //這個就表示 結果 != 預期 的情況下,丟擲的AssertionError 資訊是我們指定的message
   static public void assertEquals(String message,Object expected, Object actual)

上面還有一個方法需要單獨介紹,那就是assertThat方法。


三、assertThat方法

大家習慣把assertThat理解成新斷言,因為上面所以的功能方法,都可以通過assertThat這一個方法來實現。

1、基本語法

assertThat 的基本語法如下:

assertThat( [value], [matcher statement] );

value 是介面返回資訊中,我們想要測試的變數值

matcher statement: 是使用Hamcrest匹配符來表達的對前面變數所期望的值的宣告,如果value值與matcher statement所表達的期望值相符,則測試成功,否則測試失敗。

2、基本使用

字串匹配符

  String n = "xiao";
// containsString:字串變數中包含指定字串時,測試通過
assertThat(n, containsString("xiao"));
// startsWith:字串變數以指定字串開頭時,測試通過
assertThat(n, startsWith("xi"));
// endsWith:字串變數以指定字串結尾時,測試通過
assertThat(n, endsWith("ao"));
// euqalTo:字串變數等於指定字串時,測試通過
assertThat(n, equalTo("xiao"));
// equalToIgnoringCase:字串變數在忽略大小寫的情況下等於指定字串時,測試通過
assertThat(n, equalToIgnoringCase("xiao"));
// equalToIgnoringWhiteSpace:字串變數在忽略頭尾任意空格的情況下等於指定字串時,測試通過
assertThat(n, equalToIgnoringWhiteSpace(" xiao   "));

int匹配符

int s = 1;
// allOf:所有條件必須都成立,測試才通過(大於1同時小於3)
assertThat(s, allOf(greaterThan(1), lessThan(3)));
// anyOf:只要有一個條件成立,測試就通過 (大於1或者小於2)
assertThat(s, anyOf(greaterThan(1), lessThan(2)));
// anything:無論什麼條件,測試都通過
assertThat(s, anything());
// is:變數的值等於指定值時,測試通過
assertThat(s, is(2));
// not:和is相反,變數的值不等於指定值時,測試通過
assertThat(s, not(1));

double匹配符

double d = 1D;
// closeTo:浮點型變數的值在3.0±0.5範圍內,測試通過
assertThat(d, closeTo(3.0, 0.5));
// greaterThan:變數的值大於指定值時,測試通過
assertThat(d, greaterThan(3.0));
// lessThan:變數的值小於指定值時,測試通過
assertThat(d, lessThan(3.5));
// greaterThanOrEuqalTo:變數的值大於等於指定值時,測試通過
assertThat(d, greaterThanOrEqualTo(3.3));
// lessThanOrEqualTo:變數的值小於等於指定值時,測試通過
assertThat(d, lessThanOrEqualTo(3.4));

集合匹配符

List<String> list = new ArrayList();
// hasItem:Iterable變數中含有指定元素時,測試通過
assertThat(list, hasItem("xiao"));
Map<String, String> m = new HashMap<>();
// hasEntry:Map變數中含有指定鍵值對時,測試通過
assertThat(m, hasEntry("xi", "xiao"));
// hasKey:Map變數中含有指定key時,測試通過
assertThat(m, hasKey("x"));
// hasValue:Map變數中含有指定value值時,測試通過
assertThat(m, hasValue("x"));

四、測試

這裡對於老斷言,和新斷言各測試5個。

1、老斷言

示例

public class TestServiceImplTest {
 
    @Test
    public void test1() {
        String str = "xiao";
        assertEquals(str, "xiaoniao");//不相等,所以錯誤
    }
    @Test
    public void test2() {
        assertFalse(Boolean.TRUE); //不是false,所以錯誤
    }
    @Test
    public void test3() {
       fail("直接是錯誤"); //直接是錯誤
    }
    @Test
    public void test4() {
        assertNull("xiao"); //不為空所以為錯誤
    }
    @Test
    public void test5() {
        assertNotNull("xiao");//不為空,所以為正確
    }
}

這裡應該只有第5個測試用例通過,前面4個都不通過的,我們在來看實際執行結果

SpringBoot(20)---斷言(Assert)

與實際相符,前面4個,測試用例不通過。而且可以看到第3個是我們自定義錯誤資訊,在控制檯也列印出來了。

2、新斷言

示例

import org.assertj.core.util.Lists;
import org.junit.Test;
import java.util.HashMap;
import java.util.List;
import java.util.Map;
import static org.hamcrest.CoreMatchers.anyOf;
import static org.hamcrest.Matchers.*;
import static org.hamcrest.core.Is.is;
import static org.junit.Assert.assertThat;

public class TestServiceImplTest {

    @Test
    public void test1() {
        String str = "xiao";
        assertThat("這兩字串不相等",str, is("xiaoniao"));//不相等,所以錯誤
    }
    @Test
    public void test2() {
        int s = 1;
        assertThat(s, anyOf(greaterThan(1), lessThan(2)));//滿足 大於1或者小於2 所以正確
    }
    @Test
    public void test3() {
        double d = 1D;
        assertThat(d, allOf(greaterThanOrEqualTo(1D),lessThan(2D)));//滿足大於等於1 並且 小於2 所以正確
    }
    @Test
    public void test4() {
        List<String> list = Lists.newArrayList("xiao","zhong","da");
        assertThat(list, hasItem("xiao"));  //包含xiao 所以正確
    }
    @Test
    public void test5() {
        Map<String, String> map = new HashMap<>();
        map.put("xiao", "xiao");
        assertThat(map, hasKey("xiao")); //該map包含該key,所以正確
    }
}

這裡應該只有第1個測試用例不通過,其它都是通過的,我們在來看實際執行結果

SpringBoot(20)---斷言(Assert)

符合預期。

好了,整篇文章到這裡就結束了,下面把該專案的具體程式碼放到github上。

GitHub地址 :07-test



別人罵我胖,我會生氣,因為我心裡承認了我胖。別人說我矮,我就會覺得好笑,因為我心裡知道我不可能矮。這就是我們為什麼會對別人的攻擊生氣。
攻我盾者,乃我內心之矛(31)

相關文章