Accueil › Spring Boot › L'injection de dépendances
L'injection de dépendances
Les fondamentaux — IoC et injection de dépendancesdebutant
L'injection de dépendances consiste à fournir à un objet ce dont il a besoin. Spring propose trois façons de le faire. Retenez surtout la première.
Par constructeur (recommandée) :
@Service
public class CommandeService {
private final CommandeRepository repo;
private final NotificationService notifications;
public CommandeService(CommandeRepository repo, NotificationService notifications) {
this.repo = repo;
this.notifications = notifications;
}
}
Avec un seul constructeur, pas besoin de @Autowired. Les champs sont final et la classe se teste avec un simple new.
Par setter et par champ existent aussi, mais sont réservés à des cas particuliers (champ : déconseillé).
Quand plusieurs beans ont le même type, on choisit avec @Primary (choix par défaut) ou @Qualifier (choix explicite).
Les termes à connaître
- Injection de dépendances (DI)
Technique qui consiste à fournir à un objet les objets dont il a besoin (ses dépendances), au lieu qu'il les crée lui-même. C'est la façon dont Spring met en œuvre l'inversion de contrôle.
- Injection par constructeur
Les dépendances sont des paramètres du constructeur. C'est la méthode recommandée : les champs peuvent être
final, l'objet est complet dès sa création, et on peut le tester avec un simplenew. Depuis Spring 4.3, si la classe n'a qu'un seul constructeur,@Autowiredest inutile.- Injection par setter
Spring appelle une méthode
setXxx(...)annotée@Autowiredaprès la création de l'objet. Utile pour une dépendance optionnelle ou modifiable, rare en pratique.- Injection par champ
@Autowireddirectement sur un attribut. Court à écrire mais déconseillé : le champ ne peut pas êtrefinal, les dépendances sont cachées, et l'objet est inutilisable sans Spring (le champ restenulldans un test avecnew).- @Autowired
Demande à Spring d'injecter une dépendance (sur un constructeur, un setter ou un champ). Obligatoire par défaut : si aucun bean ne correspond, le démarrage échoue.
@Autowired(required = false)la rend optionnelle.- @Qualifier
Précise quel bean injecter quand plusieurs beans ont le même type :
@Qualifier("smsNotification"). Il est prioritaire sur@Primary.- @Primary
Désigne le bean choisi par défaut quand plusieurs beans du même type existent et qu'aucun
@Qualifiern'est précisé.- NoUniqueBeanDefinitionException
Erreur levée quand Spring trouve plusieurs beans pour un point d'injection et ne sait pas lequel choisir. Spring Boot affiche : « required a single bean, but 2 were found ».
- NoSuchBeanDefinitionException
Erreur levée quand Spring ne trouve aucun bean du type demandé. Spring Boot affiche : « required a bean of type '…' that could not be found ».
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.