⚠️ Avant de commencer cette quête, nous te recommandons de jeter un œil à celles-ci :

Dans les quêtes précédentes, tu as appris à :

• Configurer et créer une base de données avec Express
• Créer des routes basiques
• Récupérer des informations de ta base de données
• Insérer de nouvelles données dans ta base
• Appliquer des changements aux données existantes.

Dans cette quête, pour compléter le développement de ton API REST, tu vas apprendre à supprimer les données existantes. Voyons comment faire en utilisant Express et MySQL.

🤓 Dans cette quête, tu vas apprendre comment :

✅ Ecrire des routes DELETE ✅ Supprimer des données de la base de données ✅ Tester ces routes en utilisant Postman

🗑️ Comment créer un HANDLER de routes DELETE avec Express ?

Précédemment, quand tu as rencontré une requête de ce type :

PUT http://localhost:5000/api/movies/2
Content-type: application/json

{
  "title": "Citizen Kane",
  "director": "Orson Wells",
  "year": "1941",
  "color": "0",
  "duration": 120
}

Tu as déclaré une route pour y répondre comme ceci :

app.put("/api/movies/:id", HANDLER);

Ensuite, dans le HANDLER, tu as récupéré le 2 de l'url via req.params.id. Enfin, tu as déterminé si cet id était valide via le affectedRows de la requête SQL.

Maintenant, nous voulons gérer les requêtes pour supprimer des ressources, comme celle-ci :

DELETE http://localhost:5000/api/movies/2

À toi de jouer :

false|||true|||false
# Quelle méthode app dois-tu utiliser pour déclarer une route ?
[] `app.post()`
[] `app.get()`
[x] `app.delete()`
[] `app.put()`
# Quel chemin dois-tu utiliser comme premier paramètre ?
[x] `"/api/movies/:id"`
[] `"/api/movies"`
[] `"/api/users"`
[] `"/api/users/:id"`
# A travers quelle propriété de requête vas-tu récupérer l'id du film ?
[x] `req.params`
[] `req.body`
[] `req.query`
# Quelle opération SQL vas-tu réaliser ici ?
[] `SELECT`
[] `INSERT`
[] `UPDATE`
[x] `DELETE`

C'est parti ! Essaie de créer une route pour DELETE /api/movies/:id. Souviens toi d'aller checker cette page pour choisir le status HTTP adapté à ta réponse. En cas de succès, tu peux choisir l'option "No Content" comme indiqué dans la description détaillée pour DELETE ;)

Afficher la solution|||javascript|||Tu as des doutes sur comment faire ?|||0|||Masquer
// in movieControllers.js

const deleteMovie = (req, res) => {
  const id = parseInt(req.params.id);

  database
    .query("delete from movies where id = ?", [id])
    .then(([result]) => {
      if (result.affectedRows === 0) {
        res.sendStatus(404);
      } else {
        res.sendStatus(204);
      }
    })
    .catch((err) => {
      console.error(err);
      res.sendStatus(500);
    });
};

module.exports = {
  getMovies,
  getMovieById,
  postMovie,
  updateMovie,
  deleteMovie, // don't forget to export your function ;)
};

// in app.js

app.delete("/api/movies/:id", movieControllers.deleteMovie);

Tester notre route DELETE

Crée un nouveau film en utilisant la route POST et note son id.

Crée une nouvelle requête, fais défiler la liste des méthodes et sélectionne "DELETE". Ensuite, entre l'adresse du film :

http://localhost:5000/api/movies/<id of the newly created movie>

Clique sur "Send", et regarde le résultat. Essaie de supprimer à nouveau : cette fois-ci ton serveur devrait répondre "Not Found" ;)

💪 Challenge

Supprimer un utilisateur dans la base de données

Maintenant que tu as créé la route DELETE pour les films, créé la route DELETE pour supprimer des utilisateurs !

• Crée une route DELETE pour le chemin /api/users/:id qui va supprimer un utilisateur dans la base de données
• Poste un lien GitHub pour partager ta solution

🧐 Critères de validation

• [ ] Le lien GitHub contient une route DELETE pour les utilisateurs
• [ ] Une requête DELETE sur /api/users/:id devrait supprimer le bon utilisateur dans la base de données

==$==

Ce que tu devrais avoir dans :

// ...

const movieControllers = require("./controllers/movieControllers");
const validateMovie = require("./middlewares/validateMovie");

app.get("/api/movies", movieControllers.getMovies);
app.get("/api/movies/:id", movieControllers.getMovieById);
app.post("/api/movies", validateMovie, movieControllers.createMovie);
app.put("/api/movies/:id", validateMovie, movieControllers.updateMovie);
app.delete("/api/movies/:id", userControllers.deleteMovie);

const userControllers = require("./controllers/userControllers");
const validateUser = require("./middlewares/validateUser");

app.get("/api/users", userControllers.getUsers);
app.get("/api/users/:id", userControllers.getUserById);
app.post("/api/users", validateUser, userControllers.postUser);
app.put("/api/users/:id", validateUser, userControllers.updateUser);
app.delete("/api/users/:id", userControllers.deleteUser);

// ...

// ...

const deleteUser = (req, res) => {
  const id = parseInt(req.params.id);

  database
    .query("delete from users where id = ?", [id])
    .then(([result]) => {
      if (result.affectedRows === 0) {
        res.sendStatus(404);
      } else {
        res.sendStatus(204);
      }
    })
    .catch((err) => {
      console.error(err);
      res.sendStatus(500);
    });
};

module.exports = {
  getUsers,
  getUserById,
  postUser,
  updateUser,
  deleteUser,
};

// ...

const deleteMovie = (req, res) => {
  const id = parseInt(req.params.id);

  database
    .query("delete from movies where id = ?", [id])
    .then(([result]) => {
      if (result.affectedRows === 0) {
        res.sendStatus(404);
      } else {
        res.sendStatus(204);
      }
    })
    .catch((err) => {
      console.error(err);
      res.sendStatus(500);
    });
};

module.exports = {
  getMovies,
  getMovieById,
  postMovie,
  updateMovie,
  deleteMovie,
};