TP JPA 01 : Introduction à Jakarta Persistence

Premiers pas avec JPA : Création et gestion d’entités

Exercices
Java
JPA
I211
Apprenez les bases de Jakarta Persistence API (JPA) en créant un projet Java simple avec des entités, en configurant l’EntityManager et en effectuant des opérations CRUD.
Auteur
Affiliations

Emmanuel BRUNO

Université de Toulon

LIS UMR CNRS 7020

Date de publication

2026-10-01

Objectifs

  • Comprendre les concepts fondamentaux de JPA
  • Savoir configurer un projet avec JPA
  • Maîtriser les opérations CRUD de base
  • Apprendre à modéliser des entités JPA

Étape 1 : Préparer l’environnement

Le TP utilisera une base de données H2 en mémoire pour simplifier la configuration. Vous basculerez vers une base de données réelle dans la suite.

https://repo1.maven.org/maven2/com/h2database/h2/2.3.232/h2-2.3.232.jar

java -cp h2*.jar \
    org.h2.tools.Server \
        -webAllowOthers \
        -tcpAllowOthers \
        -pgAllowOthers \
        -ifNotExists

lancer H2 pour accéder à la console web : http://localhost:8082 avec une base de données testdb et le user sa sans mot de passe.

  1. Créer un projet Java Maven avec IntelliJ ou VSCode :

    • Définissez bien les informations suivantes en les adaptant à votre projet :
      • Group ID : com.example.jpa.tps
      • Artifact ID : tp01
      • Version : 0.1.0-SNAPSHOT.

  2. Ajouter les dépendances Jakarta Persistence et H2 dans le pom.xml :

     <dependencies>
     <dependency>
         <groupId>jakarta.persistence</groupId>
         <artifactId>jakarta.persistence-api</artifactId>
         <version>3.2.0</version>
     </dependency>
     <dependency>
         <groupId>org.hibernate.orm</groupId>
         <artifactId>hibernate-core</artifactId>
         <version>6.6.4.Final</version>
     </dependency>
     <dependency>
         <groupId>com.h2database</groupId>
         <artifactId>h2</artifactId>
         <version>2.3.232</version>
         <scope>runtime</scope>
     </dependency>
 </dependencies>

  3. Configurer le fichier persistence.xml :

    • Créez le fichier dans src/main/resources/META-INF/persistence.xml et ajoutez :

         <persistence xmlns="https://jakarta.ee/xml/ns/persistence"
        xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
        xsi:schemaLocation="https://jakarta.ee/xml/ns/persistence https://jakarta.ee/xml/ns/persistence/persistence_3_0.xsd"
        version="3.0">

       <persistence-unit name="tpJakartaUnit">
           <class>fr.univtln.bruno.jpa.Person</class>
           <properties>
               <property name="jakarta.persistence.jdbc.driver" value="org.h2.Driver" />
               <property name="jakarta.persistence.jdbc.url" value="jdbc:h2:tcp://localhost/~/testdb" />
               <property name="jakarta.persistence.jdbc.user" value="sa" />
               <property name="jakarta.persistence.jdbc.password" value="" />

               <!-- Database creation: none, create, drop-and-create, drop -->
               <property name="jakarta.persistence.schema-generation.database.action"
                         value="drop-and-create" />
               <!-- Script generation: none, create, drop-and-create, drop -->
               <property name="jakarta.persistence.schema-generation.scripts.action"
                         value="drop-and-create"/>

               <!-- The paths of scripts generated by JPA -->
               <property name="jakarta.persistence.schema-generation.scripts.create-target"
                       value="generated-create.ddl" />
               <property name="jakarta.persistence.schema-generation.scripts.drop-target"
                       value="generated-drop.ddl" />
           </properties>
       </persistence-unit>

   </persistence>

Étape 2 : Créer une première entité

  1. Créer une classe Person dans le package :

    • Cette classe représente une personne avec un identifiant, un nom et un âge.
    • Ajoutez les annotations de base Jakarta Persistence.

    Exemple de code :

    package com.example.tp_jakarta.entities;

import jakarta.persistence.*;

@Entity
@Table(name = "persons")
public class Person {
    @Id
    @GeneratedValue(strategy = GenerationType.IDENTITY)
    private Long id;

    @Column(nullable = false)
    private String name;

    @Column
    private int age;

    public Person() {}

    public Person(String name, int age) {
        this.name = name;
        this.age = age;
    }

    public Long getId() {
        return id;
    }

    public String getName() {
        return name;
    }

    public void setName(String name) {
        this.name = name;
    }

    public int getAge() {
        return age;
    }

    public void setAge(int age) {
        this.age = age;
    }
}

  2. Ajouter la classe au persistence.xml : Vérifiez que la classe Person est bien déclarée dans le fichier persistence.xml.

Étape 3 : Configurer l’EntityManager

  1. Créer une classe JpaUtil dans le package com.example.tp_jakarta.utils :

    • Elle fournira un EntityManagerFactory pour simplifier l’accès au gestionnaire d’entités.

    Exemple :

    import jakarta.persistence.EntityManagerFactory;
import jakarta.persistence.Persistence;

public class JpaUtil {
    private static final EntityManagerFactory emf =
        Persistence.createEntityManagerFactory("tpJakartaUnit");

    public static EntityManagerFactory getEntityManagerFactory() {
        return emf;
    }

    public static void close() {
        emf.close();
    }
}

  2. Créer une classe Main pour tester l’enregistrement d’une entité :

    • Insérez une personne dans la base de données en utilisant l’EntityManager.

    Exemple :

    import jakarta.persistence.EntityManager;

public class Main {
    public static void main(String[] args) {
        EntityManager em = JpaUtil.getEntityManagerFactory().createEntityManager();

        // Persistance d'une entité
        em.getTransaction().begin();
        Person person = new Person("Alice", 30);
        em.persist(person);
        em.getTransaction().commit();

        // Lecture de l'entité persistée
        Person foundPerson = em.find(Person.class, person.getId());
        System.out.println("Person found: " + foundPerson.getName() + ", Age: " + foundPerson.getAge());

        em.close();
        JpaUtil.close();
    }
}

Ajoutez des personnes supplémentaires, des modifications et des suppressions pour tester les opérations CRUD.

Étape 5 : Activité finale

Créez l’entité suivante pour enrichir votre modèle :

Book : - Représente un livre avec un titre, un auteur, une année de publication, un ISBN et une description. - Expérimentez avec les annotations Jakarta Persistence pour la modélisation d’une entité sans association.

Réutilisation