From 196b9f411273c812f0089b4b363df5ed96c622fe Mon Sep 17 00:00:00 2001
From: tactonbishop <tactonbishop@gmail.com>
Date: Tue, 30 Aug 2022 14:30:05 +0100
Subject: [PATCH] Last Sync: 2022-08-30 14:30:05

---
 .../NodeJS/REST_APIs/3_PUT.md                 |  1 +
 ...base.md => 5__Integrating_the_database.md} | 97 +++++++++++++++++++
 2 files changed, 98 insertions(+)
 rename Programming_Languages/NodeJS/REST_APIs/{05__Integrating_the_database.md => 5__Integrating_the_database.md} (55%)

diff --git a/Programming_Languages/NodeJS/REST_APIs/3_PUT.md b/Programming_Languages/NodeJS/REST_APIs/3_PUT.md
index 86a8c80..7525e1b 100644
--- a/Programming_Languages/NodeJS/REST_APIs/3_PUT.md
+++ b/Programming_Languages/NodeJS/REST_APIs/3_PUT.md
@@ -14,6 +14,7 @@ router.put("/:id", (req, res) => {
 
   if (!course)
     return res.status(404).send("A course with the given ID was not found");
+
   const { error } = validateCourse(req.body);
 
   if (error)
diff --git a/Programming_Languages/NodeJS/REST_APIs/05__Integrating_the_database.md b/Programming_Languages/NodeJS/REST_APIs/5__Integrating_the_database.md
similarity index 55%
rename from Programming_Languages/NodeJS/REST_APIs/05__Integrating_the_database.md
rename to Programming_Languages/NodeJS/REST_APIs/5__Integrating_the_database.md
index f3febac..27cecd2 100644
--- a/Programming_Languages/NodeJS/REST_APIs/05__Integrating_the_database.md
+++ b/Programming_Languages/NodeJS/REST_APIs/5__Integrating_the_database.md
@@ -94,3 +94,100 @@ const Course = new mongoose.model('Course', courseSchema);
 ## Rewriting the REST handlers
 
 Now we need to rewrite our RESTful request handlers so that the data is sourced from and added to the database. We will mainly be using the Mongo syntax defined at [Querying a collection](/Databases/MongoDB/Querying_a_collection.md) and [Adding documents to a collection](/Databases/MongoDB/Adding_documents_to_a_collection.md).
+
+### GET
+
+Instead of simply returning the array, we use the Mongoose `find` method.
+
+```diff
+- router.get("/", (req, res) => {
+-  res.send(courses);
+ });
+
++ router.get("/", async (res, res) => {
++  const courses = await Courses.find();
+  res.send(courses)
+})
+```
+
+### POST
+
+Now we make our new course an instance of the `Courses` model:
+
+```js
+// Original formulation
+
+router.post("/", (req, res) => {
+-  const course = {
+-    id: courses.length + 1,
+-    name: req.body.name,
+-  };
+  courses.push(course);
+  res.send(course);
+});
+```
+
+```diff
+router.post("/", async (req, res) => {
++  let course = new Course({ // make new course instance of Course model
+-   id: courses.length + 1, // not needed as DB automatically adds an id
+    name: req.body.name,
+  });
+- courses.push(course); // not pushing to the array anymore
++ await course.save() // save to Mongo
+  res.send(course);
+});
+
+```
+
+### PUT
+
+When updating a value in the database we are going to use the [query-first](/Databases/MongoDB/Update_document.md#query-first-document-update) approach to updating a Mongo document.
+
+```js
+router.put("/:id", (req, res) => {
+  const course = courses.find((c) => c.id === parseInt(req.params.id));
+
+  if (!course)
+    return res.status(404).send("A course with the given ID was not found");
+
+  const { error } = validateCourse(req.body);
+  if (error)
+    return error.details.map((joiErr) => res.status(400).send(joiErr.message));
+
+  course.name = req.body.name;
+  res.send(course);
+});
+```
+
+```diff
+router.put("/:id", async (req, res) => {
+- const course = courses.find((c) => c.id === parseInt(req.params.id));
+ const { error } = validateCourse(req.body);
+ if (!course) return res.status(404).send("A course with the given ID was not found");
++ const updatedCourse = await Course.findByIdAndUpdate(req.params.id,
++  { name: req.body.name },
++  { new: true}
++ )
+
+-   if (error)
+-   return error.details.map((joiErr) => res.status(400).send(joiErr.message));
+- })
+
+- course.name = req.body.name;
+  res.send(course);
+```
+
+### DELETE
+
+```js
+router.delete("/:id", (req, res) => {
+  const course = courses.find((c) => c.id === parseInt(req.params.id));
+  if (!course)
+    return res.status(404).send("A course with the given ID was not found");
+
+  courses.indexOf(course);
+  courses.splice(index, 1);
+  res.send(course);
+});
+```