Formations — 1 037 leçons en français

Accueil › Spring Boot › Injecter une valeur avec @Value

Injecter une valeur avec @Value

Configurer l'applicationdebutant

@Value injecte une propriété directement dans un champ, avec la syntaxe ${nom.propriete} :

@Service
public class FactureService {

    @Value("${app.tva-taux}")
    private double tauxTva;

    @Value("${app.devise:EUR}") // valeur par défaut si absente
    private String devise;
}

Sans valeur par défaut, une propriété absente fait échouer le démarrage avec « Could not resolve placeholder ». Spring convertit automatiquement la valeur (toujours du texte à l'origine) vers le type du champ : int, boolean, List<String> (à partir d'une valeur séparée par des virgules)…

@Value peut aussi s'utiliser sur un paramètre de constructeur, ce qui garde la classe testable et le champ final :

@Service
public class FactureService {
    private final double tauxTva;

    public FactureService(@Value("${app.tva-taux}") double tauxTva) {
        this.tauxTva = tauxTva;
    }
}

@Value fonctionne bien pour une propriété isolée. Pour un groupe de propriétés liées, préférez @ConfigurationProperties (leçon suivante) : structure, validation et autocomplétion IDE.

Les termes à connaître

@Value

Annotation qui injecte la valeur d'une propriété (ou une expression) dans un champ, un paramètre de constructeur ou de méthode @Bean. Syntaxe : @Value("${nom.propriete}").

Valeur par défaut

@Value("${nom:defaut}") : si la propriété nom n'existe pas, defaut est utilisée à la place. Sans :defaut, une propriété absente fait échouer le démarrage.

Conversion de types

Spring convertit automatiquement la propriété (toujours une chaîne de caractères à l'origine) vers le type du champ : int, boolean, long, une énumération, et même List<String> à partir d'une valeur séparée par des virgules.

SpEL (Spring Expression Language)

Langage d'expression de Spring, introduit avec #{...} (à ne pas confondre avec ${...}). Permet des calculs, des appels de méthode ou l'accès à d'autres beans directement dans une annotation.

Could not resolve placeholder

Message d'erreur au démarrage quand @Value("${nom}") référence une propriété absente et sans valeur par défaut : « Could not resolve placeholder 'nom' in value "${nom}" ».

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.