CREATE-Post-Päätepisteen Rakentaminen

Tarkastellaan uuden julkaisun luomista "CREATE POST" -reitillä tiedostossa postsRoutes.js. Tämä reitti vastaa julkaisun luomisesta ja tallentamisesta tietolähteeseen (database/posts.json).

Reitin määrittely

Alla oleva koodi määrittelee "CREATE POST" -reitin käyttäen router.post():

router.post("/", validatePostData, async (req, res, next) => { ... }

• Tämä reitti on määritetty käsittelemään HTTP POST -pyyntöjä juuripolkuun /;
• Se käyttää validatePostData-välimuistia, joka varmistaa, että pyynnön rungossa lähetetyt tiedot ovat kelvollisia ennen jatkamista.

Datan validointivälimuisti

Ennen kuin siirrytään reitin logiikkaan, tulee luoda datan validointivälimuisti. Tämä välimuisti varmistaa, että pyynnön rungossa lähetetty data on kelvollista ennen uuden postauksen luomista.

// Middleware to validate post data
function validatePostData(req, res, next) {
  const { username, postTitle, postContent } = req.body;

  if (!username || !postTitle || !postContent) {
    return res.status(400).json({ error: "Missing required fields" });
  }

  // If data is valid, proceed to the next route handler
  next();
}

• validatePostData-funktio poimii username, postTitle ja postContent pyynnön rungosta;
• Se tarkistaa, että nämä kentät ovat olemassa. Jos jokin niistä puuttuu (!username, !postTitle tai !postContent), palautetaan 400 (Bad Request) -statuskoodi ja virheilmoitus puuttuvista pakollisista kentistä;
• Jos data on kelvollista, välimuisti kutsuu next(), jolloin pyyntö jatkuu reitin käsittelijälle (tässä tapauksessa "CREATE POST" -reitille).

Kun datan validointivälimuisti on käytössä, voidaan jatkaa "CREATE POST" -reitin logiikkaan.

Uuden postauksen tiedot

Uutta postausta luodessa generoidaan yksilöllinen tunniste käyttämällä Date.now().toString(). Lisäksi poimitaan username, postTitle ja postContent pyynnön rungosta.

const newPost = {
  id: Date.now().toString(),
  username: req.body.username,
  postTitle: req.body.postTitle,
  postContent: req.body.postContent,
};

Uuden postauksen lisääminen tietokantaan

Seuraavat vaiheet kuvaavat, miten uusi postaus lisätään tietokantaan:

const data = await readData();
data.push(newPost);
await fs.writeFile("./database/posts.json", JSON.stringify(data));

• Olemassa oleva data luetaan JSON-tiedostosta asynkronisella readData-funktiolla, kuten aiemmin selitettiin;
• Uusi postaus lisätään data-taulukkoon;
• Päivitetty data-taulukko kirjoitetaan takaisin JSON-tiedostoon, jolloin uusi postaus tallentuu.

Vastausviestin lähettäminen

Kun uusi postaus on luotu onnistuneesti, asiakkaalle lähetetään onnistumisviesti. Vastaus sisältää tilakoodin 201 (Created) ja juuri luodun postauksen tiedot JSON-muodossa.

res.status(201).json(newPost);

Virheenkäsittely

Reittikoodi kääritään try-catch-lohkoon mahdollisten virheiden käsittelemiseksi tietojen haun tai pyynnön käsittelyn aikana. Kaikki esiintyvät virheet kirjataan konsoliin virheenkorjausta varten:

try {
  // ... (code for retrieving and processing data)
} catch (error) {
  console.error(error.message);
}

postsRoutes.js-tiedoston koko koodi tässä vaiheessa

const express = require("express");
const fs = require("fs/promises");
const validatePostData = require("../middlewares/validateData");

const router = express.Router();

// Function to read data from the JSON file
async function readData() {
  try {
    // Read the contents of the `posts.json` file
    const data = await fs.readFile("./database/posts.json");
    // Parse the JSON data into a JavaScript object
    return JSON.parse(data);
  } catch (error) {
    // If an error occurs during reading or parsing, throw the error
    throw error;
  }
}

// GET ALL POSTS
router.get("/", async (req, res, next) => {
  try {
    // Call the `readData` function to retrieve the list of posts
    const data = await readData();
    // Send the retrieved data as the response
    res.status(200).send(data);
  } catch (error) {
    // If an error occurs during data retrieval or sending the response
    console.error(error.message); // Log the error to the console for debugging
  }
});

// GET POST BY ID
router.get("/post/:id", async (req, res, next) => {
  try {
    // Extract the post ID from the request parameters
    const postId = req.params.id;
    // Read data from the JSON file
    const data = await readData();

    // Find the post with the matching ID
    const post = data.find((post) => post.id === postId);

    // If the post is not found, send a 404 response
    if (!post) {
      res.status(404).json({ error: "Post not found" });
    } else {
      // If the post is found, send it as the response
      res.status(200).send(post);
    }
  } catch (error) {
    // Handle errors by logging them and sending an error response
    console.error(error.message);
  }
});

// CREATE POST
router.post("/", validatePostData, async (req, res, next) => {
  try {
    // Generate a unique ID for the new post
    const newPost = {
      id: Date.now().toString(),
      username: req.body.username,
      postTitle: req.body.postTitle,
      postContent: req.body.postContent,
    };

    // Read the existing data
    const data = await readData();

    // Add the new post to the data
    data.push(newPost);

    // Write the updated data back to the JSON file
    await fs.writeFile("./database/posts.json", JSON.stringify(data));

    // Send a success response with the new post
    res.status(201).json(newPost);
  } catch (error) {
    // Handle errors by logging them to the console
    console.error(error.message);
  }
});

validateData.js-tiedoston täydellinen koodi

// Middleware to validate post data
function validatePostData(req, res, next) {
  const { username, postTitle, postContent } = req.body;

  if (!username || !postTitle || !postContent) {
    return res.status(400).json({ error: "Missing required fields" });
  }

  // If data is valid, proceed to the next route handler
  next();
}

module.exports = validatePostData;