JUnit

JUnit

前置準備

參考資料:(https://www.jetbrains.com/help/idea/create-tests.html)

下載套件:

junit.jar & hamcrest-core.jar(https://github.com/junit-team/junit4/wiki/Download-and-Install)

第一個測試案例

參考資料:(http://www.java2s.com/Tutorials/Java/JUnit/0040__JUnit_HelloWorld.htm)

共通事件

參考資料:(https://ithelp.ithome.com.tw/articles/10192896)

name	static	說明
BeforeClass	O	整個開始前執行一次	每個case前都會執行一次
After	X	每個case後都會執行一次
AfterClass	O	整個測試案例跑完會執行一次

3A原則

在使用@Test註解的方法，即測試案例內編寫：

Arrange：初始化目標物件(待測類別)、初始化相依物件、方法參數、預期結果(excepted)

Act：調用目標物件及欲測試的方法

Assert：驗證實際結果(actual)是否符合預期結果

@Test
public void getDirNameTest() {
    // 1. Arrange
    Main m = new Main();
    String src = "./music";
    String excepted = "music";

    // 2. Act
    String actual = m.getDirName(src);

    // 3. Assert
    assertThat(actual).isEqualTo(excepted);}

(3A的另外一種描述方式 建造-操作-檢查 BUILD-OPERATE-CHECK)

Assertj-core 可讀性更好的Assert套件 (jdk8)

參考資料:(https://ithelp.ithome.com.tw/articles/10193175)

Github:(https://github.com/joel-costigliola/assertj-core)

3.8.0 jar下載點:http://central.maven.org/maven2/org/assertj/assertj-core/3.8.0/

2.9.1 jar下載點:https://jar-download.com/artifacts/org.assertj/assertj-core/2.9.1/source-code

ERROR Code:

java: cannot access java.util.function.Predicate
  class file for java.util.function.Predicate not found

經查詢 Predicate 是JDK8新增的項目，根據GitHub內所言

Note that AssertJ 3.x requires at least Java 8 and AssertJ 2.x requires at least Java 7.

雖然教學文章內是使用 Assertj 3.8.0 ，但我目前只能嘗試JDK7，故接下來皆是改用 2.9.1 的版本。

硬斷言和軟斷言

參考文章:(https://ithelp.ithome.com.tw/articles/10193404)

軟斷言範例:

    @Test
    public void Case4(){
        int actual1 = 5;
        String actual2 = "10";

        SoftAssertions softAssertions = new SoftAssertions();

        softAssertions.assertThat(actual1).isLessThan(4);

        softAssertions.assertThat(actual2).isEqualTo("11");

        softAssertions.assertAll();
    }

要記得執行最後一行 .assertAll() 才會執行斷言。

注意事項

當我們寫測試的時候，我們必須遵守這樣的原則：

不應在測試方法中加入業務邏輯，不要造成維護上的困難 確保我們的測試易於讀寫

但使用軟斷言： 可能把業務邏輯加入到測試案例中，這會使得讀者的注意力會從測試本質，轉移到實現細節上，也就是說變得難以閱讀。 並且因為業務邏輯加入，當單一狀態的改變時，造成相關的測試也都需要進行變更，這造成維護上的困難。

所以一般情況下是不使用的好...

自訂斷言

參考資料:(https://ithelp.ithome.com.tw/articles/10193640)

Exception

參考資料:(https://stackoverflow.com/questions/31423643/try-catch-in-a-junit-test)

使用 JUnit 去捕捉，就類似用一個大的 try .. catch 包住這整個Test

@Test(excepted = FileNotFoundException.class)
public void someTest() throws Exception {
    //do something..
}

但是上述這個寫法的缺點，在於有可能並不是我們期望的那一行所噴的錯，有可能是其他行噴的，但我們無法察覺。

使用 AssertJ 編寫斷言

前置條件：此系統必須是 Java 8

AssertJ提供了org.assertj.core.api.Assertions.catchThrowable()方法來捕捉異常

@Test
public void example_Exception() {
    Throwable throwable = catchThrowable(()-> throwException());

    assertThat(throwable)
            .isExactlyInstanceOf(Exception.class)
            .hasMessageContaining("Magic");
}

private void throwException() throws Exception {
    throw new Exception("Magic");
}