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 dansroute.queryParamset 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 (
wherecombinés parand). 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.
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.