Formations — 1 037 leçons en français

Accueil › Fullstack Angular + Spring Boot › Filtres, recherche et état partageable dans l'URL

Filtres, recherche et état partageable dans l'URL

Listes, pagination et fichiersintermediaire

Un écran de liste a un état : filtres, tri, page. La question est de savoir où il vit. La bonne réponse est l'URL.

/commandes?statut=VALIDEE&client=dupont&page=2&sort=creeLe,desc

Côté Angular, on lit cet état depuis le routeur et on l'y réécrit à chaque changement :

export class CommandesComponent {
  private route = inject(ActivatedRoute);
  private router = inject(Router);
  private service = inject(CommandeService);

  // l'URL est la source de vérité
  private parametres = toSignal(this.route.queryParams, { requireSync: true });

  protected filtres = computed(() => {
    const p = this.parametres();
    return {
      statut: (p['statut'] as StatutCommande) ?? null,
      client: p['client'] ?? '',
      page: Number(p['page'] ?? 0),
      tri: p['sort'] ?? 'creeLe,desc',
    };
  });

  protected modifier(partiel: Partial<Record<string, string | number | null>>) {
    this.router.navigate([], {
      relativeTo: this.route,
      queryParams: { ...partiel, page: partiel['page'] ?? 0 },
      queryParamsHandling: 'merge',   // conserve les autres filtres
    });
  }
}

Côté Spring, les filtres sont des @RequestParam optionnels, assemblés en une seule requête :

@GetMapping("/api/commandes")
public PagedModel<CommandeDto> lister(
        @RequestParam(required = false) StatutCommande statut,
        @RequestParam(required = false) String client,
        @RequestParam(required = false) LocalDate depuis,
        @PageableDefault(size = 20, sort = "creeLe") Pageable pageable) {

    return new PagedModel<>(service.rechercher(statut, client, depuis, pageable));
}

Les termes à connaître

Paramètre de requête (query param)

Partie de l'URL après le ? (?statut=VALIDEE&page=2). Côté Spring, on les lit avec @RequestParam ; côté Angular, le routeur les expose dans route.queryParams et sait les écrire sans recharger la page.

État dans l'URL

Principe consistant à stocker les filtres, le tri et la page courante dans l'URL plutôt que dans des variables du composant. L'écran devient partageable, l'historique du navigateur fonctionne, et un rechargement de page ne perd rien.

queryParamsHandling

Option de navigation Angular qui décide du sort des paramètres existants : 'merge' les conserve et fusionne les nouveaux, 'preserve' garde les anciens à l'identique, et la valeur par défaut les remplace tous.

debounceTime

Opérateur RxJS qui attend un silence d'une durée donnée avant d'émettre. Appliqué à un champ de recherche, il évite une requête par frappe : on part une fois que l'utilisateur a fini de taper.

Specification (JPA Criteria)

Interface Spring Data permettant de composer dynamiquement les conditions d'une requête (where combinés par and). C'est la réponse propre au problème des filtres optionnels, qui produirait sinon une explosion de méthodes de repository.

Recherche insensible aux accents

Pour qu'une recherche de « cafe » trouve « café », il faut une collation adaptée côté base (par exemple une collation non sensible aux accents en PostgreSQL ou MySQL). Le faire en Java oblige à charger toutes les lignes : c'est un travail pour la base.

Lire l'explication détaillée et faire le quiz →

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.