Formations — 1 037 leçons en français

Accueil › Spring Boot › Structure d'un projet et démarrage de l'application

Structure d'un projet et démarrage de l'application

Démarrer un projet Spring Bootdebutant

Un projet généré par Spring Initializr suit une arborescence standard :

mon-projet/
├── pom.xml
├── src/
│   ├── main/
│   │   ├── java/com/boutique/
│   │   │   ├── BoutiqueApplication.java   ← classe principale
│   │   │   └── commande/CommandeService.java
│   │   └── resources/
│   │       ├── application.properties
│   │       ├── static/                     ← fichiers servis tels quels
│   │       └── templates/                  ← vues (Thymeleaf…)
│   └── test/java/com/boutique/
│       └── BoutiqueApplicationTests.java

La classe principale est à la racine des packages, et lance l'application :

@SpringBootApplication
public class BoutiqueApplication {
    public static void main(String[] args) {
        SpringApplication.run(BoutiqueApplication.class, args);
    }
}

SpringApplication.run(...) prépare l'environnement, crée l'ApplicationContext, exécute le component scan et l'auto-configuration, puis démarre le serveur Tomcat embarqué (port 8080 par défaut) si spring-boot-starter-web est présent.

Deux façons de lancer l'application : mvn spring-boot:run (pendant le développement) ou java -jar mon-app.jar (après mvn package, en production).

Les termes à connaître

Classe principale

Classe annotée @SpringBootApplication, placée à la racine des packages du projet (ex. com.boutique.BoutiqueApplication), avec une méthode main qui appelle SpringApplication.run(...). Point d'entrée de l'application.

SpringApplication.run(...)

Méthode qui démarre l'application : elle crée l'ApplicationContext, prépare l'environnement (propriétés, profils), déclenche le component scan et l'auto-configuration, puis lance le serveur web embarqué s'il y en a un.

src/main/resources

Dossier des ressources non-Java : application.properties (ou .yml), static/ (fichiers servis tels quels : CSS, JS, images) et templates/ (vues HTML pour un moteur de template comme Thymeleaf).

Serveur embarqué

Serveur web inclus dans le jar de l'application (Tomcat par défaut avec spring-boot-starter-web, alternatives : Jetty, Undertow). Il démarre avec l'application elle-même, sur le port 8080 par défaut : pas de serveur externe à installer.

CommandLineRunner

Interface fonctionnelle avec une méthode run(String... args). Un bean qui l'implémente est exécuté automatiquement juste après le démarrage complet de l'application, avec les arguments bruts de la ligne de commande.

ApplicationRunner

Variante de CommandLineRunner dont la méthode run(ApplicationArguments args) reçoit les arguments déjà découpés en options nommées (--nom=valeur) et arguments non nommés.

src/test/java

Dossier des tests, avec la même arborescence de packages que src/main/java. Spring Initializr y génère un test de démarrage (@SpringBootTest) qui vérifie que le contexte se charge sans erreur.

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.