Accueil › Spring Boot › application.properties et application.yml
application.properties et application.yml
Configurer l'applicationdebutant
Spring Boot lit sa configuration dans src/main/resources/application.properties ou application.yml (un seul suffit). Ce sont deux syntaxes pour les mêmes propriétés :
server.port=8081
spring.application.name=boutique-api
logging.level.root=INFO
logging.level.com.boutique=DEBUG
spring.datasource.url=jdbc:postgresql://localhost/boutique
server:
port: 8081
spring:
application:
name: boutique-api
datasource:
url: jdbc:postgresql://localhost/boutique
logging:
level:
root: INFO
com.boutique: DEBUG
En YAML, chaque niveau d'indentation correspond à un segment entre deux points. server.port devient server: puis, en dessous et indenté, port:.
Une valeur peut référencer une autre propriété avec ${...}, avec une valeur par défaut optionnelle : ${server.port:8080}.
Une même propriété peut être définie à plusieurs endroits (fichier, variable d'environnement, ligne de commande). En simplifiant : ligne de commande > variable d'environnement > fichier de configuration. C'est ce qui permet de changer server.port sans toucher au code, par exemple avec la variable d'environnement SERVER_PORT.
Les termes à connaître
- application.properties
Fichier de configuration au format
clé=valeur, une propriété par ligne. Placé par défaut danssrc/main/resources.- application.yml
Fichier de configuration au format YAML, où les propriétés sont organisées en arborescence par indentation. Mêmes propriétés qu'
application.properties, syntaxe différente.- Placeholder ${...}
Référence à une autre propriété dans une valeur, ex.
${server.port}. Accepte une valeur par défaut avec${nom:defaut}, utilisée si la propriété n'existe pas.- Relaxed binding
Spring Boot accepte plusieurs écritures d'un même nom de propriété (kebab-case, camelCase, majuscules avec underscores…) et les fait correspondre entre elles. Détaillé pour
@ConfigurationPropertiesdans la leçon suivante.- Ordre de priorité des sources
Quand une même propriété est définie à plusieurs endroits, Spring Boot choisit la source la plus prioritaire. Simplifié : arguments de ligne de commande > variables d'environnement > fichiers de configuration.
- Variable d'environnement
Propriété fournie par le système d'exploitation. Spring Boot la fait correspondre automatiquement à son équivalent en point, ex. la variable
SERVER_PORTalimente la propriétéserver.port.- Fichier de configuration externe
Un
application.properties(ou.yml) placé à côté du jar, ou dans un sous-dossierconfig/, est chargé et prend le pas sur celui packagé à l'intérieur du jar. Pratique pour changer la configuration sans reconstruire l'application.
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.