Accueil › Spring Boot › Tests d'intégration avec @SpringBootTest
Tests d'intégration avec @SpringBootTest
Tester son applicationdebutant
@SpringBootTest démarre toute l'application, comme au vrai lancement : tous les beans sont créés et assemblés. Contrairement à un test unitaire (leçon précédente), on vérifie que les différentes couches fonctionnent ensemble.
@SpringBootTest
@ActiveProfiles("test")
class CommandeServiceIT {
@Autowired
private CommandeService service;
@MockitoBean
private NotificationService notificationService; // remplacé par un mock
@Test
void confirmerCommande_change_le_statut() {
Commande resultat = service.confirmer(1L);
assertThat(resultat.getStatut()).isEqualTo("CONFIRMEE");
verify(notificationService).envoyer(anyString());
}
}
Par défaut, webEnvironment = WebEnvironment.MOCK : pas de vrai serveur HTTP. Avec RANDOM_PORT, un serveur démarre réellement sur un port libre, utilisable avec TestRestTemplate. @MockitoBean remplace un bean gênant (un vrai envoi d'e-mail, un appel à une API externe) par un mock, le temps du test.
Ces tests sont plus lents qu'un test unitaire : Spring doit charger le contexte complet. Spring essaie de le réutiliser entre les classes de test qui ont la même configuration, mais chaque configuration différente en force un nouveau.
Les termes à connaître
- @SpringBootTest
Démarre le vrai contexte Spring pour le test : tous les beans de l'application sont créés, comme au lancement réel. Contrairement aux tests unitaires, on vérifie que les pièces s'assemblent correctement. Plus lent qu'un test unitaire, car tout le contexte est chargé.
- webEnvironment
Attribut de
@SpringBootTestqui choisit comment le serveur web est simulé.MOCK(par défaut) : pas de vrai serveur, un contexte web simulé.RANDOM_PORT: un vrai serveur démarre sur un port libre, utile avecTestRestTemplateouWebTestClient.DEFINED_PORTetNONEexistent aussi, plus rares.- @AutoConfigureMockMvc
Ajoute un bean
MockMvcau contexte du test, pour simuler des requêtes HTTP sans serveur réel (utilisable avecwebEnvironment = MOCK, la valeur par défaut).- TestRestTemplate
Client HTTP fourni par Spring Boot pour appeler l'application via de vraies requêtes réseau, quand
webEnvironment = RANDOM_PORT. Utile pour un test bout-en-bout proche de la réalité.- @MockitoBean
Remplace un bean du contexte Spring par un mock Mockito, le temps du test (package
org.springframework.test.context.bean.override.mockito). Introduite avec Spring Framework 6.2 / Spring Boot 3.4. Elle remplace@MockBean, dépréciée mais encore très répandue dans les projets existants — même principe, ancien package (org.springframework.boot.test.mock.mockito).- @ActiveProfiles
Active un ou plusieurs profils Spring pour le test, par exemple
@ActiveProfiles("test"). Permet de charger une configuration différente (application-test.yml), typiquement une base H2 en mémoire à la place de la vraie base.- @Transactional (sur un test)
Sur une méthode ou une classe de test, ouvre une transaction avant chaque test et la annule (rollback) à la fin, qu'il réussisse ou échoue. Les données insérées pendant le test ne polluent pas les tests suivants.
- Cache du contexte Spring
Spring réutilise un contexte déjà démarré entre plusieurs classes de test si leur configuration est strictement identique (mêmes annotations, mêmes profils, mêmes beans remplacés). Un contexte différent (ex. un
@MockitoBeandifférent) force un redémarrage complet, ce qui ralentit la suite de tests.
Cette page présente la partie essentielle de la leçon. Les exemples commentés, les pièges courants et les trois questions de quiz sont dans l'application.