Créer une API REST avec Spring Boot en moins d’une heure

Tu veux créer une API REST rapidement avec Java ? Spring Boot est l’un des frameworks les plus populaires pour ça. Dans cet article, on va créer une API simple pour gérer une liste de tâches (ToDo) — en moins d’une heure !

🧰 Prérequis

Avant de commencer, assure-toi d’avoir installé :

• Java 17 ou plus

• Maven ou Gradle

• Un IDE (IntelliJ, VS Code, Eclipse…)

• Postman ou curl pour tester l’API

🚀 Étape 1 : Créer le projet Spring Boot

Tu peux utiliser Spring Initializr pour générer ton projet.

Configuration recommandée :

• Project: Maven

• Language: Java

• Spring Boot: 3.x

• Dependencies :

  • Spring Web

  • Spring Data JPA

  • H2 Database (pour tester en mémoire)

Télécharge le projet, dézippe-le et ouvre-le dans ton IDE.

📦 Étape 2 : Créer l'entité Task

@Entity
public class Task {
    @Id
    @GeneratedValue(strategy = GenerationType.IDENTITY)
    private Long id;

    private String title;
    private boolean completed;

    // Getters et setters
}

🗃️ Étape 3 : Créer le repository

public interface TaskRepository extends JpaRepository<Task, Long> {
}

🧠 Étape 4 : Créer le contrôleur REST

@RestController
@RequestMapping("/api/tasks")
public class TaskController {

    @Autowired
    private TaskRepository taskRepository;

    @GetMapping
    public List<Task> getAllTasks() {
        return taskRepository.findAll();
    }

    @PostMapping
    public Task createTask(@RequestBody Task task) {
        return taskRepository.save(task);
    }

    @PutMapping("/{id}")
    public ResponseEntity<Task> updateTask(@PathVariable Long id, @RequestBody Task taskDetails) {
        return taskRepository.findById(id)
            .map(task -> {
                task.setTitle(taskDetails.getTitle());
                task.setCompleted(taskDetails.isCompleted());
                return ResponseEntity.ok(taskRepository.save(task));
            })
            .orElse(ResponseEntity.notFound().build());
    }

    @DeleteMapping("/{id}")
    public ResponseEntity<Void> deleteTask(@PathVariable Long id) {
        return taskRepository.findById(id)
            .map(task -> {
                taskRepository.delete(task);
                return ResponseEntity.noContent().build();
            })
            .orElse(ResponseEntity.notFound().build());
    }
}

🧪 Étape 5 : Tester l’API

./mvnw spring-boot:run

Puis teste les endpoints avec Postman ou curl :

• GET /api/tasks → Liste des tâches

• POST /api/tasks → Créer une tâche

• PUT /api/tasks/{id} → Modifier une tâche

• DELETE /api/tasks/{id} → Supprimer une tâche

🧼 Étape 6 : Bonus – Activer la console H2

spring.h2.console.enabled=true
spring.datasource.url=jdbc:h2:mem:testdb

Accède à la console H2 sur http://localhost:8080/h2-console.

✅ Conclusion

Tu viens de créer une API REST complète avec Spring Boot, en moins d’une heure ! Tu peux maintenant :

• Ajouter la validation des champs

• Connecter une vraie base de données (MySQL, PostgreSQL…)

• Ajouter la sécurité avec Spring Security