1 概述

在Java生態(tài)中，Hamcrest是一個(gè)用在單元測(cè)試中的框架。該框架與JUnit集成。

Java中使用JUnit進(jìn)行單元測(cè)試。JUnit提供了若干斷言工具。 如assertEquals、assertTrue等。此外我們還可以通過擴(kuò)展能力來增強(qiáng)assert*的表達(dá)。這時(shí)我們使用

assertThat
public static void assertThat(T actual,Matcher<? super T> matcher)

通過指定不同的matcher，來判斷actual對(duì)象是否滿足驗(yàn)證條件。例如驗(yàn)證0不是1，下面的表達(dá)的更清晰易懂。

assertThat(“Zero is one”, 0, is(not(1))) // passes

我們可以自己去實(shí)現(xiàn)matcher。但Hamcrest這個(gè)框架已給我們實(shí)現(xiàn)了很多常用的matcher，從而簡(jiǎn)化我們的使用。

2 依賴

Junit 4.8.2 已經(jīng)內(nèi)部集成了hamcrest，所以不需要添加額外依賴。但提供的工具有限。此外可以引入all包，使用更多的工具。

<dependency><groupId>org.hamcrest</groupId><artifactId>hamcrest-all</artifactId><version>1.3</version> </dependency>

3 第一個(gè)樣例

public class StringMatcherTest {@Testpublic void given2Strings_whenEqual_thenCorrect() {String a = "foo";String b = "FOO";assertThat(a, equalToIgnoringCase(b));} }

從語義表達(dá)上，顯然使用hamcrest提供的matcher含義更清晰。接下來我們將看幾種matcher。

4 Object Matcher

如果要驗(yàn)證任意的Java對(duì)象我們可以使用Object Matcher。例如驗(yàn)證對(duì)象的toString方法是否等于某個(gè)值。此外也可以驗(yàn)證一個(gè)類是否是另一個(gè)類的子類

@Test public void givenBean_whenToStringReturnsRequiredString_thenCorrect(){Person person=new Person("Barrack", "Washington");String str=person.toString();assertThat(person,hasToString(str)); }@Test public void given2Classes_whenOneInheritsFromOther_thenCorrect(){assertThat(Cat.class,typeCompatibleWith(Animal.class));} }

5 Bean Matcher

我們可以通過bean matcher來檢查java bean的屬性

public class Person {String name;String address;public Person(String personName, String personAddress) {name = personName;address = personAddress;} }// 檢查是否有屬性name@Test public void givenBean_whenHasValue_thenCorrect() {Person person = new Person("Baeldung", 25);assertThat(person, hasProperty("name")); }// 檢查地址屬性address等于New York@Test public void givenBean_whenHasCorrectValue_thenCorrect() {Person person = new Person("Baeldung", "New York");assertThat(person, hasProperty("address", equalTo("New York"))); }// 檢查兩個(gè)Person對(duì)象是否有相同值@Test public void given2Beans_whenHavingSameValues_thenCorrect() {Person person1 = new Person("Baeldung", "New York");Person person2 = new Person("Baeldung", "New York");assertThat(person1, samePropertyValuesAs(person2)); }

6 Collection Matcher

collection Matcher可以用來驗(yàn)證集合

驗(yàn)證集合是否為空@Test public void givenCollection_whenEmpty_thenCorrect() {List<String> emptyList = new ArrayList<>();assertThat(emptyList, empty()); }驗(yàn)證集合大小 @Test public void givenAList_whenChecksSize_thenCorrect() {List<String> hamcrestMatchers = Arrays.asList("collections", "beans", "text", "number");assertThat(hamcrestMatchers, hasSize(4)); }檢查是否包含指定元素，而不關(guān)注順序@Test public void givenAListAndValues_whenChecksListForGivenValues_thenCorrect() {List<String> hamcrestMatchers = Arrays.asList("collections", "beans", "text", "number");assertThat(hamcrestMatchers,containsInAnyOrder("beans", "text", "collections", "number")); }驗(yàn)證包含元素且順序正確 @Test public void givenAListAndValues_whenChecksListForGivenValuesWithOrder_thenCorrect() {List<String> hamcrestMatchers = Arrays.asList("collections", "beans", "text", "number");assertThat(hamcrestMatchers,contains("collections", "beans", "text", "number")); }檢查一個(gè)數(shù)組是否含有指定元素 @Test public void givenArrayAndValue_whenValueFoundInArray_thenCorrect() {String[] hamcrestMatchers = { "collections", "beans", "text", "number" };assertThat(hamcrestMatchers, hasItemInArray("text")); }

7 Number Matcher

Number matcher用來指定進(jìn)行數(shù)值驗(yàn)證

驗(yàn)證1大于0 @Test public void givenAnInteger_whenGreaterThan0_thenCorrect() {assertThat(1, greaterThan(0)); }小于等于驗(yàn)證 @Test public void givenAnInteger_whenLessThanOrEqTo5_thenCorrect() {assertThat(-1, lessThanOrEqualTo(5)); }

8 Text Matcher

Text Matcher 字符串驗(yàn)證

是否是空字符串 @Test public void givenString_whenEmpty_thenCorrect() {String str = "";assertThat(str, isEmptyString()); }是否含有空包符 @Test public void given2Strings_whenEqualRegardlessWhiteSpace_thenCorrect() {String str1 = "text";String str2 = " text ";assertThat(str1, equalToIgnoringWhiteSpace(str2)); }

9 Core API

Hamcrest core API 提供了一些很優(yōu)雅的工具類，使得我們的單元測(cè)試可讀性更好。
此外還有一些核心matcher簡(jiǎn)化我們的使用。

使用is @Test public void given2Strings_whenIsEqualRegardlessWhiteSpace_thenCorrect() {String str1 = "text";String str2 = " text ";assertThat(str1, is(equalToIgnoringWhiteSpace(str2))); }使用not @Test public void given2Strings_whenIsNotEqualRegardlessWhiteSpace_thenCorrect() {String str1 = "text";String str2 = " texts ";assertThat(str1, not(equalToIgnoringWhiteSpace(str2))); }驗(yàn)證兩個(gè)類是否是一個(gè)實(shí)例 @Test public void given2Objects_whenSameInstance_thenCorrect() {Cat cat=new Cat();assertThat(cat, sameInstance(cat)); }

10 自定義Matcher

除了使用框架提供的matcher，我們還可以自定義matcher。我們自定義類繼承TypeSafeMatcher類并實(shí)現(xiàn)對(duì)應(yīng)的方法即可。

public class IsPositiveInteger extends TypeSafeMatcher<Integer> {public void describeTo(Description description) {description.appendText("a positive integer");}@Factorypublic static Matcher<Integer> isAPositiveInteger() {return new IsPositiveInteger();}@Overrideprotected boolean matchesSafely(Integer integer) {return integer > 0;}}

11 總結(jié)

閱讀完原文，重點(diǎn)是理解Hamcrest是什么，用來解決什么問題，整個(gè)過程就很好理解了。其次通過框架提供的幾個(gè)matcher介紹基本使用。最后學(xué)習(xí)自定義matcher的用法。

參考

[1].https://www.baeldung.com/java-junit-hamcrest-guide
[2].http://tutorials.jenkov.com/java-unit-testing/matchers.html
[3].http://hamcrest.org/JavaHamcrest/tutorial

總結(jié)

以上是生活随笔為你收集整理的Java Hamcrest学习的全部?jī)?nèi)容，希望文章能夠幫你解決所遇到的問題。

如果覺得生活随笔網(wǎng)站內(nèi)容還不錯(cuò)，歡迎將生活随笔推薦給好友。