Grace with Assert: 더 깔끔한 코드를 위해 AssertJ를 사용한 사용자 정의 소프트 어설션

소개

소프트 어설션이 무엇인지 모르신다면 소프트 어설션 - 단위 및 통합 테스트에 소프트 어설션을 사용해야 하는 이유를 읽어보세요.

이 기사는 AssertJ를 사용하여 사용자 정의 어설션을 생성하는 방법을 보여주는 Assert with Grace: 더욱 깔끔한 코드를 위한 사용자 정의 어설션의 연속입니다. 여기서는 사용자 지정 어설션 위에 소프트 어설션 접근 방식을 사용하도록 접근 방식을 확장하는 방법을 알아봅니다.

AssertJ를 사용한 사용자 정의 소프트 어설션

AssertJ의 Assertions 클래스나 사용자 정의 클래스를 사용하여 하드 어설션을 가질 수 있습니다. 소프트 어설션의 모든 이점을 얻으려면 다음을 수행해야 합니다.

• 사용자 정의 어설션을 구현합니다
• 사용자 정의 소프트 어설션 클래스를 생성하고 AssertJ에서 AbstractSoftAssertions를 확장합니다

사용자 정의 어설션

Asert with Grace: Cleaner Code를 위한 사용자 지정 어설션 문서에서 사용자 지정 어설션을 만드는 방법을 배웠습니다. 다음과 같습니다:

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;
    }
}

사용자 정의 어설션을 사용하면 테스트에서 더 많은 가독성을 얻을 수 있을 뿐만 아니라 유효한 값을 테스트하는 책임도 어설션에 전달됩니다.

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();
    }
}

사용자 정의 어설션이 준비되었으므로 이제 사용자 정의 소프트 어설션을 구현할 차례입니다.

사용자 지정 소프트 어설션 만들기

사용자 지정 어설션을 구현하는 것이 전제 조건인 경우 사용자 지정 소프트 어설션을 만드는 쉬운 프로세스가 있습니다. 이전 기사에서는 SimulationAssert 클래스를 사용자 정의 어설션으로 사용하고 SimulationSoftAssert를 사용자 정의 소프트 어설션으로 생성하겠습니다. 단계는 다음과 같습니다.

1. AbstractSoftAssertions 클래스 확장
2. 다음을 사용하여 AssertThat() 메서드를 만듭니다.
   • 이 메소드는 객체를 사용자 정의 어설션 클래스로 반환합니다
   • 어설션 제목에 대한 매개변수
   • 메서드는 매개변수가 사용자 정의 어설션 클래스와 어설션의 주제인 메서드 프록시를 반환합니다
3. 다음을 사용하여 AssertSoftly() 메서드를 만듭니다.
   • 사용자 정의 소프트 어설션 클래스에 대한 소비자로서의 매개변수
   • 매개변수가 사용자 정의 소프트 어설션 클래스이고 메소드 매개변수이므로 SoftAssertionsProvider.assertSoftly() 메소드를 사용하십시오.

단계가 복잡해 보이지만 실제로는 다음과 같이 됩니다.

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 클래스는 소프트 어설션을 담당합니다. 시뮬레이션 컨텍스트에 적용할 수 있는 예는 다음과 같습니다.

AssertJ SoftAssertion 클래스는 소프트 어설션을 담당합니다. 시뮬레이션 컨텍스트에 적용할 수 있는 예는 다음과 같습니다.

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;
    }
}

이를 사용하는 "문제"는 우리가 만든 사용자 정의 어설션을 사용할 수 없다는 것입니다. 위의 예에서는 SoftAssertions 클래스가 사용자 정의 어설션에 액세스할 수 없으므로 isEqualTo()를 사용하여 할부 및 금액의 어설션을 볼 수 있습니다.

우리는 사용자 정의 소프트 어설션 클래스를 생성하여 이 문제를 해결했습니다. 따라서 SoftAssertions 클래스를 사용하는 대신 사용자 정의 클래스인 SimulationSoftAssert를 사용하겠습니다.

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()는 어설션 중 오류 및 기타 활동을 관리할 수 있도록 모든 내부 메서드를 호출하는 소프트 어설션을 위한 공급자입니다. AssertSoftly() 내부에서 사용 중인 AssertThat()은 소프트 Assert와 주장 주제 사이의 Proxy()에 의해 사용자 정의 주장에 액세스할 수 있는 사용자 정의 주장이 됩니다.

이 접근 방식을 사용하면 사용자 정의 어설션을 구현하여 소프트 어설션에서 사용할 수 있는 사용자 정의 어설션을 갖게 됩니다.

끝

여기까지입니다 여러분!

credit-api 프로젝트에서 완전히 구현되고 작동하는 예제를 찾을 수 있으며, 여기서는 다음을 볼 수 있습니다.

• SimulationAssert 클래스
• SimulationsCustomAssertionTest 클래스의 테스트 사용법

위 내용은 Grace with Assert: 더 깔끔한 코드를 위해 AssertJ를 사용한 사용자 정의 소프트 어설션의 상세 내용입니다. 자세한 내용은 PHP 중국어 웹사이트의 기타 관련 기사를 참조하세요!