Comment écrire une API REST en Java en 30 minutes : guide pas à pas

Comment écrire une API REST en Java en 30 minutes : guide étape par étape

La création d'une API REST est l'une des compétences clés d'un développeur Java moderne. REST (Representational State Transfer) permet de construire des services web légers, évolutifs et compréhensibles. Dans ce guide, nous allons créer en 30 minutes une API REST complète avec Spring Boot. Vous apprendrez à configurer le projet, créer des endpoints pour travailler avec les utilisateurs, traiter le JSON et tester l'API via Postman ou un navigateur.

1. Qu'est-ce qu'une API REST et pourquoi en a-t-on besoin ?

Une API REST est un style architectural dans lequel le client et le serveur échangent des données via des requêtes HTTP. Les principes fondamentaux de REST :

• Ressources — chaque objet (utilisateur, produit, commande) est représenté par une URL.
• Méthodes HTTP — GET (lecture), POST (création), PUT (mise à jour), DELETE (suppression).
• Stateless — chaque requête contient toutes les informations nécessaires ; le serveur ne stocke pas l'état de la session.
• Formats de données — le plus souvent JSON ou XML.

Les API REST sont utilisées dans les applications mobiles, les fronts web, les microservices et l'intégration de systèmes. En Java, le framework le plus populaire pour créer des API REST est Spring Boot — il fournit des annotations prêtes à l'emploi et une configuration automatique.

2. Préparation du projet Spring Boot

Pour commencer, vous aurez besoin de :

• JDK 17 ou supérieur
• IntelliJ IDEA ou tout autre IDE
• Maven ou Gradle

Créons un projet avec Spring Initializr. Sélectionnez :

• Project: Maven
• Language: Java
• Spring Boot: 3.2.0 (ou la dernière version stable)
• Dependencies: Spring Web, Spring Boot DevTools

Cliquez sur "Generate" et décompressez l'archive. Ouvrez le projet dans l'IDE. La structure ressemblera à ceci :

rest-api-demo/├── src/main/java/com/example/restapidemo/│   ├── RestApiDemoApplication.java│   └── controller/│       └── UserController.java├── src/main/resources/│   └── application.properties└── pom.xml

3. Création du modèle de données et du contrôleur

Créons un modèle simple User (classe dans le package model) :

package com.example.restapidemo.model;

public class User {    private Long id;    private String name;    private String email;

    public User() {}

    public User(Long id, String name, String email) {        this.id = id;        this.name = name;        this.email = email;    }

    // Getters et Setters    public Long getId() { return id; }    public void setId(Long id) { this.id = id; }    public String getName() { return name; }    public void setName(String name) { this.name = name; }    public String getEmail() { return email; }    public void setEmail(String email) { this.email = email; }}

Créons maintenant le contrôleur UserController dans le package controller. C'est le cœur de notre API :

package com.example.restapidemo.controller;

import com.example.restapidemo.model.User;import org.springframework.web.bind.annotation.*;

import java.util.ArrayList;import java.util.List;import java.util.concurrent.atomic.AtomicLong;

@RestController@RequestMapping("/api/users")public class UserController {

    private final List<User> users = new ArrayList<>();    private final AtomicLong counter = new AtomicLong();

    public UserController() {        // Données de test        users.add(new User(counter.incrementAndGet(), "Alice", "alice@example.com"));        users.add(new User(counter.incrementAndGet(), "Bob", "bob@example.com"));    }

    // GET /api/users — obtenir tous les utilisateurs    @GetMapping    public List<