Formations — 1 037 leçons en français

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 simple new. Depuis Spring 4.3, si la classe n'a qu'un seul constructeur, @Autowired est inutile.

Injection par setter

Spring appelle une méthode setXxx(...) annotée @Autowired après la création de l'objet. Utile pour une dépendance optionnelle ou modifiable, rare en pratique.

Injection par champ

@Autowired directement sur un attribut. Court à écrire mais déconseillé : le champ ne peut pas être final, les dépendances sont cachées, et l'objet est inutilisable sans Spring (le champ reste null dans un test avec new).

@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 @Qualifier n'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 ».

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.