Accueil › Spring Boot › @DataJpaTest : tester la couche de données
@DataJpaTest : tester la couche de données
Tests avancésintermediaire
@DataJpaTest est un test slice ciblé sur la couche JPA : il charge les entités, les repositories Spring Data et l'infrastructure JPA (EntityManager, DataSource), mais ni les services ni les contrôleurs.
@DataJpaTest
class ProduitRepositoryTest {
@Autowired
private ProduitRepository repository;
@Autowired
private TestEntityManager entityManager;
@Test
void findByNomContenant_trouve_le_produit() {
entityManager.persistAndFlush(new Produit("Clavier mécanique", 89.90));
List<Produit> resultats = repository.findByNomContainingIgnoreCase("clavier");
assertThat(resultats).hasSize(1);
}
}
Par défaut, @DataJpaTest remplace la vraie source de données par une base embarquée en mémoire (H2, si elle est sur le classpath) et exécute chaque test dans une transaction annulée à la fin : aucune donnée ne fuit d'un test à l'autre.
TestEntityManager (à ne pas confondre avec EntityManager) offre des méthodes pratiques pour préparer des données de test : persist(entite), persistAndFlush(entite), find(...). Le flush() est souvent nécessaire pour forcer l'exécution immédiate du SQL généré par Hibernate, sinon les écritures restent en attente jusqu'à la fin de la transaction.
Les termes à connaître
- @DataJpaTest
Test slice pour la couche JPA : ne charge que les entités, les repositories Spring Data et l'infrastructure JPA (
EntityManager,DataSource). Ni les@Service, ni les@Controllerne font partie du contexte.- Base embarquée par défaut
Sans configuration particulière,
@DataJpaTestremplace la source de données réelle par une base embarquée en mémoire (H2, Derby ou HSQLDB, selon ce qui est présent sur le classpath), via@AutoConfigureTestDatabase.- @AutoConfigureTestDatabase(replace = Replace.NONE)
Désactive le remplacement automatique par une base embarquée : le test utilise le vrai
DataSourceconfiguré dans l'application (ou celui fourni par Testcontainers, voir la leçon suivante).- Rollback automatique
@DataJpaTestapplique@Transactionalimplicitement : chaque méthode de test s'exécute dans une transaction annulée à la fin, réussite ou échec. Aucune donnée de test ne persiste d'un test à l'autre.- TestEntityManager
Version simplifiée de l'
EntityManagerJPA, pensée pour les tests :persistAndFlush(entite),persist(entite),find(...),clear()… Injectable par@Autowireddans un@DataJpaTest.- flush() et clear()
flush()force l'écriture immédiate en base des changements en attente (sans lui, Hibernate peut différer le SQL jusqu'à la fin de la transaction).clear()vide le contexte de persistance (le cache de premier niveau) pour forcer une vraie relecture en base plutôt qu'un renvoi de l'objet déjà en mémoire.- Contexte de persistance (premier niveau)
Cache interne d'Hibernate qui associe chaque entité chargée à son identifiant, pour la durée de la session. Un
findByIdrépété dans la même transaction renvoie l'objet déjà en mémoire sans exécuter de nouvelle requête SQL.
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.