Accueil › Spring Boot › Tests unitaires avec JUnit 5 et Mockito
Tests unitaires avec JUnit 5 et Mockito
Tester son applicationdebutant
spring-boot-starter-test apporte tout ce qu'il faut pour écrire des tests : JUnit 5 (le moteur de test), AssertJ (assertions lisibles), Mockito (mocks) et quelques utilitaires JSON.
Un test unitaire vérifie une classe isolée, sans démarrer Spring. Grâce à l'injection par constructeur, on peut créer l'objet testé avec un simple new et lui passer des mocks à la place de ses vraies dépendances :
@ExtendWith(MockitoExtension.class)
class CommandeServiceTest {
@Mock
private CommandeRepository repository;
@InjectMocks
private CommandeService service;
@Test
void trouver_renvoie_la_commande_existante() {
// Given
Commande commande = new Commande(1L, "En cours");
when(repository.findById(1L)).thenReturn(Optional.of(commande));
// When
Commande resultat = service.trouver(1L);
// Then
assertThat(resultat.getStatut()).isEqualTo("En cours");
verify(repository).findById(1L);
}
}
La structure Given / When / Then (ou Arrange / Act / Assert) organise chaque test : préparer les données et le comportement des mocks, appeler la méthode testée, puis vérifier le résultat. Ce type de test s'exécute en quelques millisecondes : aucun contexte Spring, aucune base de données.
Les termes à connaître
- spring-boot-starter-test
Le starter qui apporte tout ce qu'il faut pour tester : JUnit Jupiter (JUnit 5), AssertJ (assertions fluides), Mockito (mocks), Hamcrest, JSONassert et JsonPath. Un seul
<dependency>(scopetest), généré par défaut par Spring Initializr.- @Test
Marque une méthode comme un test JUnit 5 (package
org.junit.jupiter.api). La méthode doit être publique ou package-private, sans paramètre, et ne renvoie rien.- @BeforeEach
Exécute la méthode annotée avant chaque test de la classe. Sert à préparer un état commun (créer les mocks, instancier l'objet testé) pour éviter la duplication.
- @ParameterizedTest
Exécute le même test avec plusieurs jeux de données, fournis par exemple avec
@ValueSourceou@CsvSource. Évite de dupliquer un test presque identique.- AssertJ (assertThat)
Bibliothèque d'assertions fluides et chaînables :
assertThat(total).isEqualTo(42). Messages d'erreur plus lisibles queAssertions.assertEqualsde JUnit, et beaucoup de méthodes dédiées (isEmpty(),containsExactly(),hasSize()…).- Mock (Mockito)
Un objet simulé qui remplace une vraie dépendance : on lui dit quoi répondre (
when(...).thenReturn(...)) et on vérifie ensuite qu'il a été appelé (verify(...)). Permet de tester une classe isolément, sans ses dépendances réelles (base de données, appel HTTP…).- @ExtendWith(MockitoExtension.class)
Extension JUnit 5 qui active Mockito dans la classe de test : elle initialise les champs annotés
@Mocket@InjectMocks, et vérifie que les mocks inutilisés (« unnecessary stubbing ») lèvent une erreur.- @Mock et @InjectMocks
@Mockcrée un mock pour le champ annoté.@InjectMockscrée une vraie instance de la classe testée et y injecte les champs@Mockcorrespondants (par le constructeur si possible).
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.