介紹

如果您不知道什么是軟斷言，請(qǐng)閱讀軟斷言 – 為什么應(yīng)該將它們用于單元和集成測(cè)試？

本文是 Assert with Grace: Custom Assertions for Cleaner Code 的延續(xù)，它向您展示了如何使用 AssertJ 創(chuàng)建自定義斷言。在這里，您將學(xué)習(xí)如何擴(kuò)展其方法以在自定義斷言之上使用軟斷言方法。

使用 AssertJ 自定義軟斷言

您可以使用 AssertJ 中的 Assertions 類或自定義類進(jìn)行硬斷言。為了獲得軟斷言的所有好處，我們需要：

• 實(shí)現(xiàn)自定義斷言
• 創(chuàng)建自定義軟斷言類并從 AssertJ 擴(kuò)展 AbstractSoftAssertions

自定義斷言

您在 Assert with Grace: Custom Assertions for Cleaner Code 一文中了解了如何創(chuàng)建自定義斷言?？雌饋?lái)像這樣：

public class SimulationAssert extends AbstractAssert<SimulationAssert, Simulation> {
    protected SimulationAssert(Simulation actual) {
        super(actual, SimulationAssert.class);
    }
    public static SimulationAssert assertThat(Simulation actual) {
        return new SimulationAssert(actual);
    }
    public SimulationAssert hasValidInstallments() {
        isNotNull();
        if (actual.getInstallments() < 2 || actual.getInstallments() >= 48) {
            failWithMessage("Installments must be must be equal or greater than 2 and equal or less than 48");
        }
        return this;
    }
    public SimulationAssert hasValidAmount() {
        isNotNull();
        var minimum = new BigDecimal("1.000");
        var maximum = new BigDecimal("40.000");
        if (actual.getAmount().compareTo(minimum) < 0 || actual.getAmount().compareTo(maximum) > 0) {
            failWithMessage("Amount must be equal or greater than $ 1.000 or equal or less than than $ 40.000");
        }
        return this;
    }
}

自定義斷言的使用在測(cè)試中顯示出更多的易讀性，并將測(cè)試有效值的責(zé)任發(fā)送給它：

class SimulationsCustomAssertionTest {
    @Test
    void simulationErrorAssertion() {
        var simulation = Simulation.builder().name("John").cpf("9582728395").email("john@gmail.com")
                .amount(new BigDecimal("1.500")).installments(5).insurance(false).build();
        SimulationAssert.assertThat(simulation).hasValidInstallments();
        SimulationAssert.assertThat(simulation).hasValidAmount();
    }
}

有了自定義斷言，是時(shí)候?qū)崿F(xiàn)自定義軟斷言了。

創(chuàng)建自定義軟斷言

創(chuàng)建自定義軟斷言的過(guò)程很簡(jiǎn)單，前提是實(shí)現(xiàn)自定義斷言。鑒于上一篇文章，我們將SimulationAssert 類作為自定義斷言，并將創(chuàng)建SimulationSoftAssert 作為自定義軟斷言。步驟如下：

1. 擴(kuò)展 AbstractSoftAssertions 類
2. 使用以下命令創(chuàng)建assertThat()方法：
   • 該方法返回一個(gè)對(duì)象作為自定義斷言類
   • 斷言主題的參數(shù)
   • 該方法返回方法代理，其中參數(shù)是自定義斷言類和斷言的主題
3. 使用以下命令創(chuàng)建assertSoftly() 方法：
   • 作為自定義軟斷言類的 Consumer 的參數(shù)
   • 使用SoftAssertionsProvider.assertSoftly()方法，參數(shù)是自定義軟斷言類，方法參數(shù)

步驟看起來(lái)很復(fù)雜，但實(shí)際上，你最終會(huì)得到這樣的結(jié)果：

public class SimulationSoftAssert extends AbstractSoftAssertions {
    public SimulationAssert assertThat(Simulation actual) {
        return proxy(SimulationAssert.class, Simulation.class, actual);
    }
    public static void assertSoftly(Consumer<SimulationSoftAssert> softly) {
        SoftAssertionsProvider.assertSoftly(SimulationSoftAssert.class, softly);
    }
}

使用自定義軟斷言

AssertJ SoftAssertion 類負(fù)責(zé)軟斷言。這是適用于模擬上下文的示例：

AssertJ SoftAssertion 類負(fù)責(zé)軟斷言。這是適用于模擬上下文的示例：

public class SimulationAssert extends AbstractAssert<SimulationAssert, Simulation> {
    protected SimulationAssert(Simulation actual) {
        super(actual, SimulationAssert.class);
    }
    public static SimulationAssert assertThat(Simulation actual) {
        return new SimulationAssert(actual);
    }
    public SimulationAssert hasValidInstallments() {
        isNotNull();
        if (actual.getInstallments() < 2 || actual.getInstallments() >= 48) {
            failWithMessage("Installments must be must be equal or greater than 2 and equal or less than 48");
        }
        return this;
    }
    public SimulationAssert hasValidAmount() {
        isNotNull();
        var minimum = new BigDecimal("1.000");
        var maximum = new BigDecimal("40.000");
        if (actual.getAmount().compareTo(minimum) < 0 || actual.getAmount().compareTo(maximum) > 0) {
            failWithMessage("Amount must be equal or greater than $ 1.000 or equal or less than than $ 40.000");
        }
        return this;
    }
}

使用它的“問(wèn)題”是我們將無(wú)法使用我們創(chuàng)建的自定義斷言。在上面的示例中，您可以使用 isEqualTo() 查看分期付款和金額中的斷言，因?yàn)?SoftAssertions 類無(wú)法訪問(wèn)自定義斷言。

我們通過(guò)創(chuàng)建自定義軟斷言類解決了這個(gè)問(wèn)題。因此，我們將使用自定義類：SimulationSoftAssert，而不是使用 SoftAssertions 類。

class SimulationsCustomAssertionTest {
    @Test
    void simulationErrorAssertion() {
        var simulation = Simulation.builder().name("John").cpf("9582728395").email("john@gmail.com")
                .amount(new BigDecimal("1.500")).installments(5).insurance(false).build();
        SimulationAssert.assertThat(simulation).hasValidInstallments();
        SimulationAssert.assertThat(simulation).hasValidAmount();
    }
}

SimulationSoftAssert.assertSoftly() 是軟斷言的提供者，它將調(diào)用所有內(nèi)部方法以便能夠在斷言期間管理錯(cuò)誤和其他活動(dòng)。在assertSoftly() 內(nèi)部使用的assertThat() 將是自定義斷言，它將可以通過(guò)軟斷言和斷言主題之間的proxy() 訪問(wèn)自定義斷言。

使用這種方法，我們可以通過(guò)實(shí)現(xiàn)自定義斷言來(lái)在軟斷言中使用自定義斷言。

結(jié)束

這就是大家！

您可以在credit-api項(xiàng)目中找到一個(gè)完全實(shí)現(xiàn)且有效的示例，您可以在其中看到以下內(nèi)容：

• 模擬斷言類
• SimulationsCustomAssertionTest 類中的測(cè)試用法

以上是優(yōu)雅斷言：使用 AssertJ 實(shí)現(xiàn)更簡(jiǎn)潔的代碼的自定義軟斷言的詳細(xì)內(nèi)容。更多信息請(qǐng)關(guān)注PHP中文網(wǎng)其他相關(guān)文章！