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énomn'existe pas,defautest 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êmeList<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}" ».
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.