springboot-tdd

Workflow TDD Spring Boot

Guide TDD pour les services Spring Boot avec une couverture de 80%+ (unitaire + intégration).

Quand l'utiliser

• Nouvelles fonctionnalités ou endpoints
• Corrections de bugs ou refactorisations
• Ajout de logique d'accès aux données ou de règles de sécurité

Workflow

1. Écrire d'abord les tests (ils doivent échouer)
2. Implémenter le code minimal pour les passer
3. Refactoriser avec les tests au vert
4. Appliquer la couverture (JaCoCo)

Tests Unitaires (JUnit 5 + Mockito)

@ExtendWith(MockitoExtension.class)
class MarketServiceTest {
  @Mock MarketRepository repo;
  @InjectMocks MarketService service;

  @Test
  void createsMarket() {
    CreateMarketRequest req = new CreateMarketRequest("name", "desc", Instant.now(), List.of("cat"));
    when(repo.save(any())).thenAnswer(inv -> inv.getArgument(0));

    Market result = service.create(req);

    assertThat(result.name()).isEqualTo("name");
    verify(repo).save(any());
  }
}

Patterns :

• Arrange-Act-Assert
• Éviter les mocks partiels ; privilégier le stubbing explicite
• Utiliser @ParameterizedTest pour les variantes

Tests de la Couche Web (MockMvc)

@WebMvcTest(MarketController.class)
class MarketControllerTest {
  @Autowired MockMvc mockMvc;
  @MockBean MarketService marketService;

  @Test
  void returnsMarkets() throws Exception {
    when(marketService.list(any())).thenReturn(Page.empty());

    mockMvc.perform(get("/api/markets"))
        .andExpect(status().isOk())
        .andExpect(jsonPath("$.content").isArray());
  }
}

Tests d'Intégration (SpringBootTest)

@SpringBootTest
@AutoConfigureMockMvc
@ActiveProfiles("test")
class MarketIntegrationTest {
  @Autowired MockMvc mockMvc;

  @Test
  void createsMarket() throws Exception {
    mockMvc.perform(post("/api/markets")
        .contentType(MediaType.APPLICATION_JSON)
        .content("""
          {"name":"Test","description":"Desc","endDate":"2030-01-01T00:00:00Z","categories":["general"]}
        ")))
      .andExpect(status().isCreated());
  }
}

Tests de Persistance (DataJpaTest)

@DataJpaTest
@AutoConfigureTestDatabase(replace = AutoConfigureTestDatabase.Replace.NONE)
@Import(TestContainersConfig.class)
class MarketRepositoryTest {
  @Autowired MarketRepository repo;

  @Test
  void savesAndFinds() {
    MarketEntity entity = new MarketEntity();
    entity.setName("Test");
    repo.save(entity);

    Optional<MarketEntity> found = repo.findByName("Test");
    assertThat(found).isPresent();
  }
}

Testcontainers

• Utiliser des conteneurs réutilisables pour Postgres/Redis afin de refléter la production
• Injecter via @DynamicPropertySource les URLs JDBC dans le contexte Spring

Couverture (JaCoCo)

Extrait Maven :

<plugin>
  <groupId>org.jacoco</groupId>
  <artifactId>jacoco-maven-plugin</artifactId>
  <version>0.8.14</version>
  <executions>
    <execution>
      <goals><goal>prepare-agent</goal></goals>
    </execution>
    <execution>
      <id>report</id>
      <phase>verify</phase>
      <goals><goal>report</goal></goals>
    </execution>
  </executions>
</plugin>

Assertions

• Privilégier AssertJ (assertThat) pour la lisibilité
• Pour les réponses JSON, utiliser jsonPath
• Pour les exceptions : assertThatThrownBy(...)

Builders de Données de Test

class MarketBuilder {
  private String name = "Test";
  MarketBuilder withName(String name) { this.name = name; return this; }
  Market build() { return new Market(null, name, MarketStatus.ACTIVE); }
}

Commandes CI

• Maven : mvn -T 4 test ou mvn verify
• Gradle : ./gradlew test jacocoTestReport

Rappel : Gardez les tests rapides, isolés et déterministes. Testez le comportement, pas les détails d'implémentation.