Formations — 1 037 leçons en français

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 dans src/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 @ConfigurationProperties dans 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_PORT alimente la propriété server.port.

Fichier de configuration externe

Un application.properties (ou .yml) placé à côté du jar, ou dans un sous-dossier config/, est chargé et prend le pas sur celui packagé à l'intérieur du jar. Pratique pour changer la configuration sans reconstruire l'application.

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.