22.09.07 SpringMVC - 단위 테스트 (Hamcrest)

Hamcrest Assertion

: JUnit의 기본 Assertion 메서드 대체가능

: JUnit 기반의 단위 테스트에서 사용할 수 있는 Assertion 프레임워크

: assertThat()과 매쳐(Matcher)를 사용

: 필요한 매쳐가 있으면 커스텀 가능

---

사용목적

• 가독성 향상 : 연결하면 그냥 영문장이 됨
• 테스트 실패 메세지의 이해가 쉬움
• 다양한 Matcher를 제공

---

사용방법

assertThat(실제값, Matcher를 이용한 기대값)

Matcher : 공식문서

AllOf, AnyOf, ArrayAsIterableMatcher, BaseMatcher, BigDecimalCloseTo, CharSequenceLength, CombinableMatcher, CustomMatcher, CustomTypeSafeMatcher, DescribedAs, DiagnosingMatcher, Every, FeatureMatcher, HasEqualValues, HasItemInArray, HasProperty, HasPropertyWithValue, HasToString, HasXPath, Is, IsAnything, IsArray, IsArrayContainingInAnyOrder, IsArrayContainingInOrder, IsArrayWithSize, IsBlankString, IsCloseTo, IsCollectionContaining, IsCollectionWithSize, IsCompatibleType, IsEmptyCollection, IsEmptyIterable, IsEmptyString, IsEqual, IsEqualCompressingWhiteSpace, IsEqualIgnoringCase, IsEventFrom, IsIn, IsInstanceOf, IsIterableContaining, IsIterableContainingInAnyOrder, IsIterableContainingInOrder, IsIterableContainingInRelativeOrder, IsIterableWithSize, IsMapContaining, IsMapWithSize, IsNaN, IsNot, IsNull, IsSame, MatchesPattern, SamePropertyValuesAs, StringContains, StringContainsInOrder, StringEndsWith, StringRegularExpression, StringStartsWith, SubstringMatcher, TypeSafeDiagnosingMatcher, TypeSafeMatcher

 

 

방법 예시 1)

// from JUnit 
assertEquals(expected, actual);

// to Hamcrest
assertThat(actual, is(equalTo(expected)));

방법 예시 2)

// from JUnit 
assertNotNull(currencyName, "should be not null");

// to Hamcrest
assertThat(currencyName, is(notNullValue()));
// assertThat(currencyName, is(nullValue()));

방법 예시 3) 

// from JUnit 
assertThrows(NullPointerException.class, () -> getCryptoCurrency("XRP"));

// to Hamcrest
Throwable actualException = assertThrows(NullPointerException.class,
        () -> getCryptoCurrency("XRP"));

assertThat(actualException.getCause(), is(equalTo(null)));