Accueil › Spring Boot › Tâches planifiées avec @Scheduled
Tâches planifiées avec @Scheduled
Cache, tâches asynchrones et planifiéesintermediaire
@Scheduled déclenche une méthode automatiquement, à intervalle régulier ou selon une expression cron.
@Configuration
@EnableScheduling
public class SchedulingConfig { }
@Component
public class RelanceService {
@Scheduled(fixedRate = 60_000) // toutes les 60 secondes, depuis le début de l'exécution précédente
public void verifierRelances() { ... }
@Scheduled(cron = "0 0 2 * * *") // tous les jours à 2h00
public void nettoyerFichiersTemporaires() { ... }
}
Trois façons principales de planifier :
fixedRate: intervalle fixe depuis le début de l'exécution précédente.fixedDelay: intervalle fixe depuis la fin de l'exécution précédente.cron: expression à six champs (secondes en premier), pour des horaires précis ou récurrents complexes.
initialDelay retarde la toute première exécution. Par défaut, Spring Boot n'utilise qu'un seul thread pour toutes les tâches planifiées (spring.task.scheduling.pool.size = 1) : deux tâches planifiées se bloquent l'une l'autre si l'une dure longtemps, sauf à augmenter ce pool.
Les termes à connaître
- @EnableScheduling
Annotation posée sur une classe
@Configuration(ou la classe principale) qui active la détection et l'exécution des méthodes@Scheduled. Sans elle,@Scheduledest silencieusement ignorée.- fixedRate
Déclenche l'exécution suivante à intervalle fixe depuis le début de l'exécution précédente, en millisecondes. Si le traitement dure plus longtemps que
fixedRate, la prochaine exécution démarre dès que la précédente se termine (pas de chevauchement avec leTaskSchedulerpar défaut, mono-thread), mais sans attendre le délai complet écoulé.- fixedDelay
Déclenche l'exécution suivante à intervalle fixe depuis la fin de l'exécution précédente, en millisecondes. Contrairement à
fixedRate, la durée du traitement ne raccourcit jamais l'intervalle réel entre deux exécutions.- cron
Attribut qui prend une expression cron à six champs (secondes, minutes, heures, jour du mois, mois, jour de la semaine), à la différence du cron Unix classique qui n'en a que cinq (pas de champ secondes). Exemple :
"0 0 2 * * *"s'exécute tous les jours à 2h00.- initialDelay
Délai, en millisecondes, avant la première exécution de la tâche après le démarrage de l'application. Se combine avec
fixedRateoufixedDelay; utile pour laisser le temps à l'application de finir son démarrage avant la première exécution.- TaskScheduler
Composant qui déclenche effectivement les méthodes
@Scheduledaux bons moments. Spring Boot en auto-configure un (ThreadPoolTaskScheduler) avec, par défaut, un seul thread (spring.task.scheduling.pool.size = 1) : toutes les tâches planifiées se partagent ce thread unique, sauf configuration explicite d'un pool plus grand.- ShedLock
Bibliothèque tierce (pas fournie par Spring) qui empêche une tâche
@Scheduledde s'exécuter simultanément sur plusieurs instances d'une application déployée en cluster, via un verrou partagé (base de données, Redis…) et l'annotation@SchedulerLock. Spring ne résout pas ce problème nativement : chaque instance possède son propre planificateur, indépendant des autres.
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.