1、前言
Hamcrest 是一款用于校驗的 Java 的單元測試框架，可以組合創建靈活的表達的匹配器進行斷言。
官網：http://hamcrest.org/JavaHamcrest/
2、API
1、startsWith：匹配字符串以 XX 開頭
assertThat("myStringOfNote", startsWith("my"))
2、containsString：匹配是否包含指定字符串
assertThat("myStringOfNote", containsString("ring"))
3、equalTo：基于傳入對象的 equals 方法匹配方式，如果是數組比較每個元素是否相等。
assertThat("foo", equalTo("foo"));
assertThat(new String[] {"foo", "bar"}, equalTo(new String[] {"foo", "bar"}));
4、allOf：匹配所有指定的匹配項，可指定多個匹配條件
assertThat("myValue", allOf(startsWith("my"), containsString("Val")));
5、anyOf：匹配其中任意一個匹配項，可指定多個匹配條件
assertThat("myValue", anyOf(startsWith("foo"), containsString("Val")))
6、both：兩個選項都匹配
assertThat("fab", both(containsString("a")).and(containsString("b")))
7、either：匹配其中任意一個匹配項
assertThat("fan", either(containsString("a")).or(containsString("b")))
8、describedAs：自定義描述匹配
describedAs(
參數1：自定義描述，可以使用占位符%0,%1,%2...
參數2：匹配器
參數3：自定義描述中需要替換的變量按先后順序匹配);
assertThat(120,describedAs("自定義期望值：%0", equalTo(110), 110));
輸出：Expected: 自定義期望值：<110>
9、everyItem：匹配現實 Iterable 接口類中的每個元素是否符合要求
assertThat(Arrays.asList("bar", "baz"), everyItem(startsWith("ba")))
10、is：裝飾另一個匹配器，保留其行為。
assertThat(cheese, is(equalTo(smelly)))
替代
assertThat(cheese, equalTo(smelly))
11、instanceOf：匹配對象是屬于哪個類
assertThat(new Canoe(), instanceOf(Canoe.class));
12、isA：instanceOf 的快捷方式
assertThat(cheese, isA(Cheddar.class))
替代
assertThat(cheese, is(instanceOf(Cheddar.class)))
13、hasItem：匹配現實 Iterable 接口類中的【至少有一個元素】是否符合要求
assertThat(Arrays.asList("foo", "bar"), hasItem(startsWith("ba")));
assertThat(Arrays.asList("foo", "bar"), hasItem("bar"));
//endsWith("z") and endsWith("o") 必須同時滿足
assertThat(Arrays.asList("foo", "bar", "baz"), hasItems(endsWith("z"), endsWith("o")));
//baz1 and foo 必須同時滿足
assertThat(Arrays.asList("foo", "bar", "baz"), hasItems("baz1", "foo"));
14、not：創建一個結果相反的匹配器
assertThat(cheese, is(not(equalTo(smelly))))
assertThat(cheese, is(not(smelly)))
15、notNullValue：匹配是否非空
assertThat(cheese, is(notNullValue()))
16、nullValue：匹配是否為空
assertThat(cheese, is(nullValue())
17、containsStringIgnoringCase：匹配是否包含指定字符串，忽略大小寫
assertThat("myStringOfNote", containsStringIgnoringCase("Ring"))
18、startsWithIgnoringCase：匹配字符串以 XX 開頭，忽略大小寫
assertThat("myStringOfNote", startsWithIgnoringCase("My"))
19、endsWith：匹配字符串以 XX 結尾
assertThat("myStringOfNote", endsWith("Note"))
20、endsWithIgnoringCase：匹配字符串以 XX 結尾，忽略大小寫
assertThat("myStringOfNote", endsWithIgnoringCase("note"))
21、matchesRegex：匹配字符串是否滿足指定正則表達式
assertThat("abc", matchesRegex(Pattern.compile("?[a-z]$"));
assertThat("abc", matchesRegex("?[a-z]+$"));
作者：luojie
鏈接：http://testingpai.com/article/1599472747188
來源：測試派軟件測試論壇
協議：CC BY-SA 4.0 https://creativecommons.org/licenses/by-sa/4.0/
