Mise en place d'une application Spring Boot

Générer le projet

Sur Spring Initializr : Maven, Java 21, packaging Jar, et la dépendance Spring Web. On téléchargera d'autres starters plus tard (Data MongoDB, Validation, Security…).

src/main/java/com/fioul/api/
    FioulApiApplication.java   // classe de démarrage
src/main/resources/
    application.properties
pom.xml                        // dépendances Maven

La classe de démarrage

@SpringBootApplication marque le point d'entrée et déclenche l'auto-configuration + le scan des composants.

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

Lancer

mvn spring-boot:run   # → Tomcat started on port 8080

Un premier contrôleur (healthcheck)

Un endpoint minimal pour vérifier que l'API tourne.

@RestController
public class HealthController {
    @GetMapping("/api/health")
    public Map<String,String> health() {
        return Map.of("statut", "OK");
    }
}

Résultat — GET /api/health

Poser les trois couches

On organise le code en paquets par couche : controller, service, repository (+ model, dto). Chaque type d'objet a sa place.