matchers依賴

介紹

上一次 ，我討論了Hamcrest Matcher是什么，如何使用以及如何制作。 在本文中，我將解釋創(chuàng)建Hamcrest Matchers的更多高級步驟。 首先，我將分享如何使您的匹配器更易于類型安全，然后介紹無狀態(tài)匹配器的一些技術(shù)，最后是如何減少測試類的大量靜態(tài)導(dǎo)入。 我還將給出一些有關(guān)命名靜態(tài)工廠方法的快速提示。

類型安全匹配器

您可能已經(jīng)在上次開發(fā)的matchs（）方法中注意到了，我在注釋中指出，我曾使用“ yoda條件”來避免null檢查和類型檢查。 首先，自己對yoda條件進(jìn)行一些研究不會有什么壞處（我可能有一天會發(fā)表一篇有關(guān)它的文章，但不能保證），但是這里要注意的最大事情是某種類型檢查和需要空檢查。 這是因為matchs（）方法接受一個對象，而不是泛型參數(shù)中指定的類型。

如Hamcrest的文檔中所述：

此方法與Object匹配，而不是與通用類型T匹配。這是因為Matcher的調(diào)用者在運行時不知道類型是什么（由于Java通用類型已擦除類型）。

因此，我們需要確定傳入的對象的類型。此外，我們還應(yīng)確保沒有傳入任何空值（除非我們的特定Matcher可以這樣做，但這非常罕見），或者在至少要確保傳入的null不會導(dǎo)致NullPointerException。

但是有一種更簡單的方法：TypeSafeMatcher。 如果擴(kuò)展該類而不是BaseMatcher類，它將為您執(zhí)行類型檢查和null檢查，然后將對象傳遞給僅采用泛型指定類型的匹配方法。

定義TypeSafeMatcher非常類似于我們上次定義Matcher的方式，但有一些區(qū)別：除了覆蓋matchs（）之外，您還可以替代使用通用類型而不是Object的matchesSafely（）。 而不是覆蓋describeMismatch（），而是覆蓋describeMismatchSafely（）。 可能沒有一個新的describeTo（）可能令人驚訝，但是看到它除了Description之外沒有其他內(nèi)容，因此不需要類型安全的版本。

否則，創(chuàng)建TypeSafeMatcher幾乎是相同的。

不過，我不得不提我上周忘記的事情。 定義自己的Matcher的人不需要重寫describeMismatch（）或describeMismatchSafely（）方法。 BaseMatcher和TypeSafeMatcher都具有那些方法的默認(rèn)實現(xiàn)，這些方法的簡單實現(xiàn)是僅輸出“ was item.toString（） ”（如果TypeSafeMatcher獲得錯誤類型的項，則“ was of itemClassName （ item.toString（）” ）”。

這些默認(rèn)實現(xiàn)通常足夠好，但是如果要使用的類型沒有toString（）的有用實現(xiàn)，則使用您自己的不匹配消息來描述該項目的問題顯然更有用。 即使類具有不錯的toString（）實現(xiàn)，我也總是這樣做，因為它可以更快地解決問題。

有關(guān)其他可擴(kuò)展匹配器類的說明

Hamcrest核心庫中還有其他幾個Matcher類，供用戶從中擴(kuò)展。 這些有幾種口味。

首先，是CustomMatcher和CustomTypeSafeMatcher。 這些設(shè)計用于通過匿名類一次性創(chuàng)建Matchers。 他們可能是有用的，但我更愿意總是在情況下，正確執(zhí)行我曾經(jīng)確實需要它一次。

接下來，有DiagnosingMatcher和TypeSafeDiagnosingMatcher，它們使您可以在match（）方法中創(chuàng)建不匹配描述。 這似乎是用一塊石頭殺死兩只鳥的好方法，但是我有幾塊牛肉：1）它違反了SRP 2）如果存在不匹配，它再次調(diào)用matchs（）方法只是為了填充在不匹配說明中。 因此，第一個調(diào)用忽略獲取描述，第二個調(diào)用忽略匹配。

您可以擴(kuò)展的最后一個特殊的Matcher是FeatureMatcher。 這可能非常有用，但要理解起來很復(fù)雜（我不確定自己是否正確理解–直到我嘗試自己動手做一個或閱讀如何做一個為止）。 如果我弄清楚并獲得了很好的理解，我將在這里為您寫另一篇文章。

無狀態(tài)匹配器

任何不需要將任何內(nèi)容傳遞給其構(gòu)造函數(shù)的Matcher（因此，它是靜態(tài)工廠方法）都是無狀態(tài)Matcher。 它們與其他Matcher相比有一個很小的優(yōu)勢，因為您只需要在任何時候存在一個實例，就可以在需要使用該Matcher的任何時間重用它。

這是一個非常簡單的補充。 您需要做的就是創(chuàng)建該類的靜態(tài)實例，并使您的靜態(tài)工廠返回該實例，而不是調(diào)用構(gòu)造函數(shù)。 庫實際附帶的IsEmptyString Matcher可以做到這一點（上一次我們的示例沒有這樣做，但是為了簡單起見）。

減少靜態(tài)進(jìn)口數(shù)量

用Hamcrest Matchers編寫了相當(dāng)多的測試后，您可能會注意到文件頂部有很多靜態(tài)導(dǎo)入。 一段時間后，這可能會成為很大的麻煩事，所以讓我們看一下可以減輕此問題的方法。

實際上，這幾乎與上一個解決方案一樣簡單。 您可以通過創(chuàng)建實質(zhì)上為您執(zhí)行此操作的新類來減少靜態(tài)導(dǎo)入。 這個新類具有煩人的靜態(tài)導(dǎo)入，但隨后定義了自己的靜態(tài)工廠方法來委托給原始對象。 這是將一些核心Matchers組合到一個地方的示例：

import org.hamcrest.core.IsEqual; import org.hamcrest.core.IsNull; import org.hamcrest.core.IsSame; import org.hamcrest.Matcher;public class CoreMatchers {public static Matcher equalTo(T object) {return IsEqual.equalTo(object);}public static Matcher notNullValue() {return IsNull.notNullValue();}public static Matcher notNullValue(Class type) {return IsNull.notNullValue(type);}public static Matcher nullValue() {return IsNull.nullValue();}public static Matcher nullValue(Class type) {return IsNull.nullValue(type);}public static Matcher sameInstance(T target) {return IsSame.sameInstance(target);}public static Matcher theInstance(T target) {return IsSame.theInstance(target);} }

然后，要使用任何或所有Matcher，只需靜態(tài)導(dǎo)入CoreMatchers。*還有一種生成這些組合Matcher類的方法，如官方Hamcrest教程所示 。 我不會繼續(xù)討論它，因為它不在本文討論范圍之內(nèi)，而且我也不喜歡它。

結(jié)束提示：命名

如果您閱讀了官方的Hamcrest教程和/或查看了內(nèi)置的Matchers，您可能會注意到靜態(tài)工廠方法的命名趨勢。 通用語法匹配“斷言testObject是factoryMethod ”。 方法名稱的語法通常設(shè)計為可以在“ is”之前使用的當(dāng)前時態(tài)動作。在命名自己的靜態(tài)工廠方法時，通常應(yīng)遵循此約定，但實際上我建議將“ is”放入名稱中已經(jīng)。 這樣，Matcher的用戶無需將您的方法嵌套在is（）方法內(nèi)。 但是，如果執(zhí)行此操作，則還需要創(chuàng)建反函數(shù)。 允許使用is（）方法包裝Matcher的原因是，因此您也可以將其包裝在not（）方法中，以測試已經(jīng)測試的內(nèi)容的逆函數(shù)。 這將導(dǎo)致類似“斷言testObject不是factoryMethod ”的句子。如果您認(rèn)為遵循約定對特定的Matcher過于嚴(yán)格，則只需確保使用當(dāng)前的時態(tài)操作測試即可。 例如，我做了一個匹配器，檢查是否拋出了一個異常，該異常的靜態(tài)工廠方法是throwsA（）。 我只是不喜歡將它命名為throwingA（）以便與“ is”一起使用。 但是，如果再次違反約定，則必須確定要創(chuàng)建一個靜態(tài)靜態(tài)工廠方法。 例如，如果您要實現(xiàn)自己的逆工廠，最簡單的方法通常是用not（）包裝正工廠。 因此，我的nottThrowA（）方法將返回not（throwsA（））。 不過要小心：有時候，將正負(fù)誤轉(zhuǎn)實際上并不能給出您想要的正確逆。

奧托羅

好吧，這就是我為您準(zhǔn)備的。 如果您想讓我繼續(xù)談?wù)揌amcrest Matchers，請在評論中告訴我。 否則，您可以在其github頁面上的Hamcrest Matchers上進(jìn)行自己的研究。下周，我將討論如何讓您的Hamcrest Matchers以類似于AssertJ斷言的流暢方式檢查多個事情。

翻譯自: https://www.javacodegeeks.com/2015/01/advanced-creation-of-hamcrest-matchers.html

matchers依賴

總結(jié)

以上是生活随笔為你收集整理的matchers依赖_Hamcrest Matchers的高级创建的全部內(nèi)容，希望文章能夠幫你解決所遇到的問題。

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