Comment écrire votre première API REST sur Spring Boot

Spring Boot est depuis longtemps devenu la norme pour la création d'applications backend en Java. Sa force réside dans sa simplicité et sa rapidité : vous pouvez littéralement créer une API REST fonctionnelle en quelques minutes. Dans cet article, nous verrons comment faire le premier pas.

L'API REST est un moyen de communication entre le client et le serveur via des requêtes HTTP. Voici quelques exemples :

• GET /users — obtenir la liste des utilisateurs

• POST /users — créer un nouvel utilisateur

• DELETE /users/1 — supprimer l'utilisateur avec ID = 1

  

Étape 1. Créer un projet

Le plus rapide pour commencer Spring Initializr:

1. Indiquez la langue — Java.

2. Choisissez la dépendance : Spring Web.

3. Téléchargez et ouvrez le projet dans l'IDE (IntelliJ IDEA, Eclipse ou VS Code).

Étape 2. Premier contrôleur

Dans le dossier src/main/java créer une classe :

import org.springframework.web.bind.annotation.GetMapping;
import org.springframework.web.bind.annotation.RestController;

@RestController
public class HelloController {

    @GetMapping("/hello")
    public String hello() {
        return "Hi, this is my first REST API!";
    }
}

Que se passe-t-il ?

• @RestController — la classe est responsable des requêtes REST.

• @GetMapping("/hello") — traite une requête GET à l'adresse /hello.

• La méthode renvoie une chaîne et elle est affichée dans le navigateur.

Étape 3. Lancer l'application

Le projet a déjà une classe avec l'annotation @SpringBootApplication. L'exécuter. Aller dans le navigateur sur http://localhost:8080/hello — et voir la réponse de l'API. 🎉

Étape 4. Travail avec les données

Ajoutons une liste d'utilisateurs :

import org.springframework.web.bind.annotation.GetMapping;
import org.springframework.web.bind.annotation.RestController;
import java.util.List;

@RestController
public class UserController {

    @GetMapping("/users")
    public List<String> getUsers() {
        return List.of("Alice", "Bob", "Eva");
    }
}

Maintenant, lors de la demande /users, nous recevrons JSON :

["Alice", "Bob", "Eva"]

Et ensuite ?

• Ajouter les méthodes POST, PUT, DELETE.

• Connecter la base de données (Spring Data JPA).

• Configurer les tests et la documentation (par exemple, Swagger).

Conclusion

Spring Boot vous permet de déployer rapidement une API REST : de la première requête au travail avec les données, en quelques lignes de code seulement. Après avoir maîtrisé la base, vous pouvez créer des services à part entière, des projets de formation aux microservices.

Pour se sentir en confiance avec Java et Spring Boot, il est important de comprendre les bases de la programmation. Dans l'application Code vous pouvez apprendre Python, JavaScript, Lua et d'autres langages, suivre des cours et obtenir un certificat. C'est un excellent point de départ pour passer à des frameworks backend sérieux.

Et nous avons aussi un chaîne de télégram, où nous discutons d'idées intéressantes, partageons nos expériences et analysons ensemble les tâches, apprendre devient non seulement utile, mais aussi amusant.