Définir les entités et les référentiels

Dans cette leçon, nous allons apprendre à connecter votre application Java à une base de données avec Spring Boot. C’est ce qu’on appelle la persistance des données : vos données continuent d’exister même après l’arrêt de votre application.

Nous nous concentrerons sur deux concepts essentiels :

• Entités : vos objets Java qui correspondent aux tables de la base de données.
• Référentiels : des interfaces qui fournissent des moyens simples d’interagir avec vos entités et la base de données.

Une entité JPA est une classe Java ordinaire qui représente une table de votre base de données relationnelle. Chaque instance de cette classe correspond à une ligne de cette table.

La Java Persistence API (JPA) est une norme de gestion des données relationnelles dans les applications Java. Spring Data JPA s’appuie dessus pour simplifier encore davantage les interactions avec les bases de données.

Pour marquer une classe Java comme entité JPA, vous utilisez l’annotation @Entity. Vous devez également définir une clé primaire à l’aide de @Id.

Créons une entité Product simple :

Attribuer manuellement les ID peut être fastidieux et source d’erreurs. Les bases de données peuvent générer automatiquement des ID uniques pour vous !

Utilisez l’annotation @GeneratedValue avec une strategy. GenerationType.IDENTITY est couramment utilisé avec les bases de données qui incrémentent automatiquement les valeurs, comme MySQL et H2.

Par défaut, JPA associe les champs aux colonnes portant le même nom. Vous pouvez personnaliser cette association à l’aide de l’annotation @Column.

Elle vous permet de spécifier le nom de la colonne, si elle peut être nulle, sa longueur, et bien plus encore :

Maintenant que nous avons une entité, comment l'enregistrer dans la base de données ou la récupérer ? C'est là qu'interviennent les référentiels Spring Data !

Un référentiel est une interface qui fournit des méthodes puissantes et prédéfinies pour les opérations courantes sur une base de données (comme la création, la lecture, la mise à jour et la suppression — CRUD). Vous n'écrivez pas de SQL : Spring Data JPA le génère pour vous.

Pour créer un référentiel pour votre entité, il vous suffit de définir une interface qui étend JpaRepository de Spring Data JPA.

JpaRepository accepte deux paramètres de type : le type de l'entité et le type de sa clé primaire.

Voici comment définir un référentiel pour notre entité Product :

import org.springframework.data.jpa.repository.JpaRepository;
import org.springframework.stereotype.Repository;

// Assuming 'Product' entity is defined in the same package or imported
@Repository
public interface ProductRepository extends JpaRepository<Product, Long> {
    // Spring Data JPA automatically provides CRUD methods here!
    // You can add custom query methods if needed, e.g.,
    // List<Product> findByName(String name);
}

Remarque : l'annotation @Repository est facultative, mais constitue une bonne pratique pour plus de clarté.

En étendant JpaRepository, votre ProductRepository hérite automatiquement de nombreuses méthodes puissantes. En voici quelques-unes :

• save(entity) : enregistre une entité donnée (l'insère si elle est nouvelle, la met à jour si elle existe déjà).
• findById(id) : récupère une entité à partir de son ID et renvoie un Optional.
• findAll() : renvoie toutes les instances du type d'entité.
• delete(entity) ou deleteById(id) : supprime une entité.

Vous disposez ainsi de toutes les fonctionnalités CRUD sans écrire une seule ligne de code d'implémentation !

Dans une véritable application Spring Boot, vous injecteriez votre référentiel dans un service ou un contrôleur à l'aide de @Autowired, puis vous appelleriez ses méthodes.

Nous ne pouvons pas exécuter ici une application Spring Boot complète avec une base de données, mais cet extrait montre l'utilisation conceptuelle au sein d'un composant Spring Boot type :

import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.stereotype.Service;
import java.util.List;

// Assuming Product and ProductRepository are defined

@Service
public class ProductService {

    private final ProductRepository productRepository;

    @Autowired
    public ProductService(ProductRepository productRepository) {
        this.productRepository = productRepository;
    }

    public Product createProduct(String name, double price) {
        Product newProduct = new Product(name, price);
        return productRepository.save(newProduct);
    }

    public List<Product> getAllProducts() {
        return productRepository.findAll();
    }

    public Product getProductById(Long id) {
        return productRepository.findById(id).orElse(null);
    }
}

Ce ProductService serait ensuite utilisé par d'autres parties de votre application.

Excellent travail ! Vous avez appris les bases de la persistance des données avec Spring Data JPA :

• Les entités sont des classes Java annotées avec @Entity qui correspondent à des tables de base de données.
• @Id désigne la clé primaire, et @GeneratedValue permet à la base de données de gérer la génération de l'ID.
• @Column permet de personnaliser les correspondances entre les champs et les colonnes.
• Les référentiels sont des interfaces qui étendent JpaRepository<Entity, ID> et fournissent de puissantes méthodes CRUD prêtes à l'emploi, sans écrire de SQL.

Ensuite, vous approfondirez l'exécution de diverses opérations CRUD !