Spring Boot — Cucumber + Gherkin (BDD)

<dependency>
    <groupId>io.cucumber</groupId>
    <artifactId>cucumber-java</artifactId>
    <scope>test</scope>
</dependency>
<dependency>
    <groupId>io.cucumber</groupId>
    <artifactId>cucumber-spring</artifactId>
    <scope>test</scope>
</dependency>
<dependency>
    <groupId>io.cucumber</groupId>
    <artifactId>cucumber-junit-platform-engine</artifactId>
    <scope>test</scope>
</dependency>

@CucumberContextConfiguration
@SpringBootTest(webEnvironment = SpringBootTest.WebEnvironment.RANDOM_PORT)
public class CucumberSpringConfig {
    // aucun contenu — la classe sert de pont entre Cucumber et Spring
}

@Component
@ScenarioScope                   // ✓ bean recréé pour chaque scénario
public class TestContext {
    private int responseStatus;
    private String responseBody;
    // getters/setters
}

@Component
@RequiredArgsConstructor
public class StockSteps {

    private final WebTestClient webTestClient;
    private final TestContext ctx;             // ✓ injecté par Spring

    @Given("le stock {string} existe avec {int} unités")
    public void stockExists(String productId, int quantity) {
        // setup en DB ou via API
    }

    @When("je récupère les stocks de l'adresse {string}")
    public void getStocks(String addressId) {
        var result = webTestClient.get()
            .uri("/stocks?addressId=" + addressId)
            .exchange()
            .expectBody()
            .returnResult();
        ctx.setResponseStatus(result.getStatus().value());
        ctx.setResponseBody(new String(result.getResponseBody()));
    }

    @Then("le code de retour est {int}")
    public void checkStatus(int expectedStatus) {
        assertEquals(expectedStatus, ctx.getResponseStatus());
    }
}

@Testcontainers
@SpringBootTest(webEnvironment = SpringBootTest.WebEnvironment.RANDOM_PORT)
@CucumberContextConfiguration
public class CucumberTestConfig {

    @Container
    static PostgreSQLContainer<?> postgres =
        new PostgreSQLContainer<>("postgres:15");

    @Container
    static KafkaContainer kafka =
        new KafkaContainer("confluentinc/cp-kafka:7.5.0");

    @DynamicPropertySource
    static void register(DynamicPropertyRegistry registry) {
        registry.add("spring.datasource.url", postgres::getJdbcUrl);
        registry.add("spring.datasource.username", postgres::getUsername);
        registry.add("spring.datasource.password", postgres::getPassword);
        registry.add("spring.kafka.bootstrap-servers", kafka::getBootstrapServers);
    }
}

@Then("un événement StockCreated doit être publié")
public void verifyKafkaEvent() {
    ConsumerRecord<String, Object> record = kafkaConsumer.poll(Duration.ofSeconds(5));
    assertNotNull(record);
    assertEquals("StockCreated", record.value().getType());
}

@Given("les stocks suivants existent")
public void createStocks(DataTable table) {
    List<Map<String, String>> rows = table.asMaps();
    rows.forEach(row -> {
        String product = row.get("produit");
        String address = row.get("adresse");
        int quantity = Integer.parseInt(row.get("quantité"));
        // créer le stock
    });
}

flowchart TD
    U["Tests unitaires\n~70%\nLogique métier, branches, cas edge"]
    I["Tests d'intégration\n~25%\n@WebMvcTest, @DataJpaTest"]
    C["Cucumber\n~5%\nFlux métier critiques bout-en-bout"]
    U --> I --> C