Formations — 1 037 leçons en français

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 :

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, @Scheduled est 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 le TaskScheduler par 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 fixedRate ou fixedDelay ; 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 @Scheduled aux 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 @Scheduled de 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.

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.