Comment écrire une API REST en Java en 30 minutes : pour les débutants

Comment écrire une API REST en Java en 30 minutes : pour les débutants

Créer une API REST est l'une des compétences clés du développeur moderne. Si vous commencez tout juste à apprendre Java et souhaitez créer rapidement votre premier service web, ce guide est fait pour vous. Nous passerons de l'installation des outils à une API fonctionnelle que vous pourrez tester dans un navigateur ou Postman. L'ensemble du processus ne prendra pas plus de 30 minutes.

Dans cet article, nous utiliserons Spring Boot — le framework le plus populaire pour créer des applications web en Java. Il prend en charge toute la configuration de routine, vous permettant de vous concentrer sur la logique. En résultat, vous obtiendrez une API simple pour gérer une liste de tâches (Todo List).

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

REST (Representational State Transfer) est un style architectural pour construire des services web. Une API REST fonctionne sur le protocole HTTP et utilise des méthodes standard :

• GET — récupération de données
• POST — création d'un nouvel enregistrement
• PUT — mise à jour d'un enregistrement existant
• DELETE — suppression d'un enregistrement

Les données sont généralement transmises au format JSON. L'API REST est utilisée partout : des applications mobiles à l'architecture microservices. En la maîtrisant, vous pourrez créer la partie serveur pour n'importe quel client.

Étape 1 : Préparation de l'environnement

Pour travailler, nous avons besoin de trois choses. Assurez-vous qu'elles sont installées sur votre ordinateur.

1.1. JDK (Java Development Kit)

Téléchargez et installez JDK 17 ou plus récent depuis le site officiel d'Oracle ou utilisez OpenJDK. Vérifiez l'installation avec la commande dans le terminal :

java -version

1.2. IntelliJ IDEA (Community Edition)

C'est un environnement de développement gratuit, parfaitement adapté à Java. Téléchargez-le depuis le site officiel.

1.3. Postman (optionnel)

Outil pour tester les API. Téléchargeable depuis postman.com. Au début, vous pouvez vous contenter d'un navigateur.

Étape 2 : Création du projet Spring Boot

Le moyen le plus rapide est d'utiliser Spring Initializr. C'est un outil web qui génère une ébauche de projet.

1. Allez sur start.spring.io.
2. Sélectionnez : Project: Maven, Language: Java, Spring Boot: 3.x.x.
3. Dans le champ Group, entrez com.example, dans Artifact — todoapi.
4. Cliquez sur Add Dependencies et ajoutez Spring Web.
5. Cliquez sur Generate — un archive ZIP avec le projet sera téléchargée.
6. Décompressez l'archive et ouvrez le dossier dans IntelliJ IDEA.

La structure du projet ressemblera à ceci :

• src/main/java/com/example/todoapi/ — code principal
• src/main/resources/application.properties — paramètres
• pom.xml — fichier de construction Maven

Étape 3 : Création du modèle de données et du contrôleur

Maintenant, nous allons écrire le code. D'abord, créons un modèle simple — la classe TodoItem.

3.1. Classe du modèle

Créez une nouvelle classe Java dans le package com.example.todoapi avec le nom TodoItem.java :

package com.example.todoapi;

public class TodoItem {    private Long id;    private String title;    private boolean completed;

    // Constructeur par défaut    public TodoItem() {}

    // Constructeur avec paramètres    public TodoItem(Long id, String title, boolean completed) {        this.id = id;        this.title = title;        this.completed = completed;    }

    // Getters et setters    public L