Formations — 1 037 leçons en français

Accueil › Spring Boot › Portée (scope) et cycle de vie des beans

Portée (scope) et cycle de vie des beans

Les fondamentaux — IoC et injection de dépendancesdebutant

Le scope d'un bean indique combien d'instances existent :

@Component
@Scope("prototype")
public class Panier { ... }

Un bean passe par un cycle de vie : création → injection des dépendances → @PostConstruct → utilisation → @PreDestroy (à l'arrêt).

@Component
public class CacheProduits {

    @PostConstruct
    void charger() { /* après l'injection : on remplit le cache */ }

    @PreDestroy
    void vider() { /* à l'arrêt : on libère les ressources */ }
}
DÉMARRAGE DU CONTEXTE 1. Instanciation appel du constructeur les champs sont nuls 2. Injection dépendances fournies par le constructeur 3. @PostConstruct initialisation qui a besoin des dépendances 4. Prêt utilisable ARRÊT DU CONTEXTE 5. @PreDestroy appelé sur les singletons uniquement Un bean prototype n'est jamais détruit Spring le crée et l'oublie aussitôt Pourquoi le constructeur ne suffit pas : à l'étape 1, aucune dépendance n'est encore disponible avec l'injection par champ. @PostConstruct est le premier moment où le bean est complet.
C'est l'ordre de ces étapes qui explique pourquoi une initialisation dépendant d'un autre bean appartient à @PostConstruct et non au constructeur.

Les termes à connaître

Scope (portée)

Règle qui détermine combien d'instances d'un bean existent et combien de temps elles vivent. Se déclare avec @Scope(...) sur la classe ou la méthode @Bean.

singleton

Le scope par défaut : une seule instance par conteneur, créée au démarrage et partagée par tous ceux qui l'injectent. À ne pas confondre avec le patron de conception Singleton (une instance par JVM) : ici c'est une instance par conteneur Spring.

prototype

Une nouvelle instance est créée à chaque fois que le bean est demandé au conteneur (injection ou getBean). Spring la crée et l'initialise, puis ne s'en occupe plus : sa méthode de destruction n'est jamais appelée automatiquement.

Scopes web : request, session, application

Disponibles dans une application web. request : une instance par requête HTTP. session : une instance par session utilisateur. application : une instance pour toute l'application web (ServletContext).

@PostConstruct

Méthode appelée une fois, après la création du bean et l'injection de toutes ses dépendances. Sert à initialiser (charger un cache, vérifier une configuration…). Dans Spring Boot 3, elle vient du package jakarta.annotation.

@PreDestroy

Méthode appelée à l'arrêt du conteneur, avant la destruction du bean. Sert à libérer des ressources (fermer une connexion, arrêter un thread…). Non appelée pour les beans prototype.

@Lazy

Retarde la création d'un bean singleton à sa première utilisation au lieu du démarrage. Utile pour un bean coûteux rarement utilisé, mais les erreurs de configuration n'apparaissent alors qu'au premier appel.

ObjectProvider

Interface de Spring qui permet de demander un bean au moment voulu (getObject()), au lieu de le recevoir une seule fois à la création. Solution classique pour obtenir un nouveau prototype à chaque fois depuis un singleton.

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.