Comment créer des requêtes JPA Dynamic Spring Data avec des critères de filtre facultatifs ?

Requête du référentiel JPA de données Dynamic Spring avec critères de filtre facultatifs

Problème :

Au printemps Data JPA, générer des requêtes dynamiques avec des critères de filtrage facultatifs devient un défi lorsque le nombre de champs augmente, conduisant à un grand nombre de requêtes statiques qui doivent être écrits manuellement.

Meilleure approche : API de spécifications et de critères

Spring Data JPA fournit l'interface de spécifications et l'API de critères pour résoudre ce problème. Les spécifications permettent la création par programmation de prédicats qui peuvent être combinés dynamiquement et utilisés pour créer des requêtes.

Implémentation des spécifications

Pour utiliser les spécifications, étendez l'interface du référentiel avec JpaSpecificationExecutor interface :

public interface EmployeeRepository extends JpaRepository<Employee, Integer>, JpaSpecificationExecutor<Employee> {}

Création d'un Spécification

Créez une classe Java qui implémente l'interface Spécification, définissant la logique de prédicat pour chaque critère de filtre. Par exemple, pour créer une spécification pour le champ EmployeeNumber :

public class EmployeeNumberSpecification implements Specification<Employee> {

    private String employeeNumber;

    public EmployeeNumberSpecification(String employeeNumber) {
        this.employeeNumber = employeeNumber;
    }

    @Override
    public Predicate toPredicate(Root<Employee> root, CriteriaQuery<?> query, CriteriaBuilder builder) {
        if (employeeNumber == null || employeeNumber.isEmpty()) {
            return builder.disjunction(); // Allow any value
        }
        return builder.like(root.get("employeeNumber"), "%" + employeeNumber + "%");
    }
}

Combination de spécifications

Plusieurs spécifications peuvent être combinées à l'aide d'opérateurs logiques (par exemple, et, ou, not) pour créer des critères de recherche plus complexes. Par exemple, pour rechercher des employés avec un EmployeeNumber et une Profession spécifiques :

Specification<Employee> employeeNumberSpec = new EmployeeNumberSpecification("10");
Specification<Employee> professionSpec = new ProfessionSpecification("IT");
Specification<Employee> combinedSpec = Specification.where(employeeNumberSpec).and(professionSpec);

Exécution de la requête

Les spécifications peuvent être utilisées avec findAll et d'autres méthodes du JPA référentiel pour exécuter la requête dynamique :

List<Employee> employees = employeeRepository.findAll(combinedSpec);

Avantages de Spécifications :

• Extensibilité : Ajoutez et combinez facilement des critères de recherche en fonction de l'évolution des besoins de l'entreprise.
• Filtrage dynamique : Filtrez les données basé sur des critères arbitraires sans avoir besoin de critères prédéfinis requêtes.
• Robustesse : Gère les valeurs nulles et autres cas extrêmes avec élégance.
• Clarté du code : Sépare la logique de requête de la logique métier, améliorant ainsi la testabilité et maintenabilité.

Ce qui précède est le contenu détaillé de. pour plus d'informations, suivez d'autres articles connexes sur le site Web de PHP en chinois!