前言

由於JUnit的Assert是公認的爛API，所以不推薦使用，目前推薦使用的是AssertJ。
AssertJ網站: http://joel-costigliola.github.io/assertj/
github上examples 地址 https://github.com/joel-costigliola/assertj-examples
assertj-examples-octo-assertj-core-1.5.0是官方examples

整理一些常用的例子如下

對字串斷言

@Test  
public void testString() {  
    String str = null;  
    // 斷言null或為空字串  
    assertThat(str).isNullOrEmpty();  
    // 斷言空字串  
    assertThat("").isEmpty();  
    // 斷言字串相等 斷言忽略大小寫判斷字串相等  
    assertThat("Frodo").isEqualTo("Frodo").isEqualToIgnoringCase("frodo");  
    // 斷言開始字串 結束字元穿 字串長度  
    assertThat("Frodo").startsWith("Fro").endsWith("do").hasSize(5);  
    // 斷言包含字串 不包含字串  
    assertThat("Frodo").contains("rod").doesNotContain("fro");  
    // 斷言字串只出現過一次  
    assertThat("Frodo").containsOnlyOnce("do");  
    // 判斷正則匹配  
    assertThat("Frodo").matches("..o.o").doesNotMatch(".*d");  
}  

對數字斷言

@Test  
public void testNumber() {  
    Integer num = null;  
    // 斷言空  
    assertThat(num).isNull();  
    // 斷言相等  
    assertThat(42).isEqualTo(42);  
    // 斷言大於 大於等於  
    assertThat(42).isGreaterThan(38).isGreaterThanOrEqualTo(38);  
    // 斷言小於 小於等於  
    assertThat(42).isLessThan(58).isLessThanOrEqualTo(58);  
    // 斷言0  
    assertThat(0).isZero();  
    // 斷言正數 非負數  
    assertThat(1).isPositive().isNotNegative();  
    // 斷言負數 非正數  
    assertThat(-1).isNegative().isNotPositive();  
}  

對日期斷言

@Test  
    public void testDate() {  
        // 斷言與指定日期相同 不相同 在指定日期之後 在指定日期之錢  
        assertThat(Dates.parse("2014-02-01")).isEqualTo("2014-02-01").isNotEqualTo("2014-01-01")  
                .isAfter("2014-01-01").isBefore(parse("2014-03-01"));  
        // 斷言 2014 在指定年份之前 在指定年份之後  
        assertThat(DateTime.now().toDate()).isBeforeYear(2020).isAfterYear(2013);  
        // 斷言時間再指定範圍內 不在指定範圍內  
        assertThat(parse("2014-02-01")).isBetween("2014-01-01", "2014-03-01").isNotBetween(  
                parse("2014-02-02"), parse("2014-02-28"));  

        // 斷言兩時間相差100毫秒  
        Date d1 = new Date();  
        Date d2 = new Date(d1.getTime() + 100);  
        assertThat(d1).isCloseTo(d2, 100);  

        // sets dates differing more and more from date1  
        Date date1 = Dates.parseDatetimeWithMs("2003-01-01T01:00:00.000");  
        Date date2 = parseDatetimeWithMs("2003-01-01T01:00:00.555");  
        Date date3 = parseDatetimeWithMs("2003-01-01T01:00:55.555");  
        Date date4 = parseDatetimeWithMs("2003-01-01T01:55:55.555");  
        Date date5 = parseDatetimeWithMs("2003-01-01T05:55:55.555");  

        // 斷言 日期忽略毫秒，與給定的日期相等  
        assertThat(date1).isEqualToIgnoringMillis(date2);  
        // 斷言 日期與給定的日期具有相同的年月日時分秒  
        assertThat(date1).isInSameSecondAs(date2);  
        // 斷言 日期忽略秒，與給定的日期時間相等  
        assertThat(date1).isEqualToIgnoringSeconds(date3);  
        // 斷言 日期與給定的日期具有相同的年月日時分  
        assertThat(date1).isInSameMinuteAs(date3);  
        // 斷言 日期忽略分，與給定的日期時間相等  
        assertThat(date1).isEqualToIgnoringMinutes(date4);  
        // 斷言 日期與給定的日期具有相同的年月日時  
        assertThat(date1).isInSameHourAs(date4);  
        // 斷言 日期忽略小時，與給定的日期時間相等  
        assertThat(date1).isEqualToIgnoringHours(date5);  
        // 斷言 日期與給定的日期具有相同的年月日  
        assertThat(date1).isInSameDayAs(date5);  
    }  

對List斷言

@Test  
public void testList() {  
    // 斷言 列表是空的  
    assertThat(newArrayList()).isEmpty();  
    // 斷言 列表的開始 結束元素  
    assertThat(newArrayList(1, 2, 3)).startsWith(1).endsWith(3);  
    // 斷言 列表包含元素 並且是排序的  
    assertThat(newArrayList(1, 2, 3)).contains(1, atIndex(0)).contains(2, atIndex(1)).contains(3)  
            .isSorted();  
    // 斷言 被包含與給定列表  
    assertThat(newArrayList(3, 1, 2)).isSubsetOf(newArrayList(1, 2, 3, 4));  
    // 斷言 存在唯一元素  
    assertThat(Lists.newArrayList("a", "b", "c")).containsOnlyOnce("a");  
}  

對Map斷言

@Test  
public void testMap() {  
    Map<String, Object> foo = Maps.newHashMap();  
    foo.put("A", 1);  
    foo.put("B", 2);  
    foo.put("C", 3);  

    // 斷言 map 不為空 size  
    assertThat(foo).isNotEmpty().hasSize(3);  
    // 斷言 map 包含元素  
    assertThat(foo).contains(entry("A", 1), entry("B", 2));  
    // 斷言 map 包含key  
    assertThat(foo).containsKeys("A", "B", "C");  
    // 斷言 map 包含value  
    assertThat(foo).containsValue(3);  
}  

對Class斷言

@Test  
public void testClass() {  
    // 斷言 是註解  
    assertThat(Magical.class).isAnnotation();  
    // 斷言 不是註解  
    assertThat(Ring.class).isNotAnnotation();  
    // 斷言 存在註解  
    assertThat(Ring.class).hasAnnotation(Magical.class);  
    // 斷言 不是藉口  
    assertThat(Ring.class).isNotInterface();  
    // 斷言 是否為指定Class例項  
    assertThat("string").isInstanceOf(String.class);  
    // 斷言 類是給定類的父類  
    assertThat(Person.class).isAssignableFrom(Employee.class);  
}  

@Magical  
public enum Ring {  
    oneRing, vilya, nenya, narya, dwarfRing, manRing;  
}  
@Target(ElementType.TYPE)  
@Retention(RetentionPolicy.RUNTIME)  
public @interface Magical {}  
public class Person {}  
public class Employee extends Person {}  

使用fail方法

@Test  
public void testFail() {  
    try {  
        fail("在不檢查任何條件的情況下使斷言失敗。顯示一則訊息");  
    } catch (AssertionError ae) {  
        logger.info("可以通過catch捕獲該Error");  
    }  
    try {  
        failBecauseExceptionWasNotThrown(ServiceException.class);  
    } catch (AssertionError ae) {  
        logger.info("可以通過catch捕獲該Error");  
    }  
}  

除此之外，還提供包括Exception、Iterable、JodaTime、Guava等等很多的斷言支援。

轉載自：JUnit 單元測試斷言推薦 AssertJ