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éthodemainqui appelleSpringApplication.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) ettemplates/(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
CommandLineRunnerdont la méthoderun(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.
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.