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 points d'accès
• Corrections de bugs ou refactoring
• 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 creerMarche() {
    CreerMarcheRequete requete = new CreerMarcheRequete("nom", "desc", Instant.now(), List.of("cat"));
    when(repo.save(any())).thenAnswer(inv -> inv.getArgument(0));

    Marche resultat = service.creer(requete);

    assertThat(resultat.nom()).isEqualTo("nom");
    verify(repo).save(any());
  }
}

Modèles :

• 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 retourneMarches() throws Exception {
    when(marketService.lister(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 creerMarche() throws Exception {
    mockMvc.perform(post("/api/markets")
        .contentType(MediaType.APPLICATION_JSON)
        .content("""
          {"nom":"Test","description":"Desc","dateFin":"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 sauvegardeEtTrouve() {
    MarketEntite entite = new MarketEntite();
    entite.setNom("Test");
    repo.save(entite);

    Optional<MarketEntite> trouve = repo.findByNom("Test");
    assertThat(trouve).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 nom = "Test";
  MarketBuilder avecNom(String nom) { this.nom = nom; return this; }
  Market construire() { return new Market(null, nom, MarketStatus.ACTIF); }
}

Commandes CI

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

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