szit

Ez az oldal csak olvasható. Megtekintheted a forrását, de nem változtathatod meg. Ha úgy gondolod, hogy ez helytelen, kérdezd az Adminisztrátorokat!
[[:oktatas:web:express|< Express]]

====== Express - Adatok fogadása ES ======

  * **Szerző:** Sallai András
  * Copyright (c) 2025, Sallai András
  * Szerkesztve: 2025
  * Licenc: [[https://creativecommons.org/licenses/by-sa/4.0/|CC Attribution-Share Alike 4.0 International]]
  * Web: https://szit.hu


===== JSON adatok fogadása =====

REST API esetén az adatokat JSON formátumban szoktuk fogadni. 

Az express beépítve tartalmaz egy köztes szoftvert erre a célra, csak használatba kell venni:

<code javascript>
app.use(express.json());
</code>

<code javascript app/index.js>
import express from 'express'
const app = express()
import routes from './routes/api.js'

app.use(express.json()) // <--
app.use(routes)

app.listen(8000, () => {
  console.log('Server running on port 8000')
})
</code>


===== Projekt készítése =====

Készítsünk egy receive nevű projektet.

<code>
receive/
  |-app/
  |  |-controllers/
  |  |-routes/
  |  |  `-api.js
  |  `-index.js
  |-node_modules/
  `-package.json
</code>

Az alkalmazás belépési pontja továbbra is az index.js fájl.

Telepítsük az express és a nodemon csomagokat:
  npm init -y
  npm install express
  npm install --save-dev nodemon

<code javascript package.json>
{
    "type": "module",
}
</code>


Készítsük el a kontrollerünket, egyetlen store() függvénnyel:

<code javascript app/controllers/employeecontroller.js>
const EmployeeController = {
  store(req, res) {
    res.json(req.body.name)
  }
}

export default EmployeeController
</code>

A store függvény visszaküldi a kapott értéket.

Készítsünk hozzá egy routingot:

<code javascript app/routes/api.js>
import Router from 'express'
const router = Router()
import EmployeeController from '../controllers/employeecontroller.js'

router.post('/employees', EmployeeController.store)

export default router
</code>

Készítsük el a belépési pontot:
<code javascript app/index.js>
import express from 'express'
const app = express()
import routes from './routes/api.js'

app.use(express.json()) // <--
app.use('/api', routes)

const PORT = 8000
app.listen(PORT, () => {
  console.log(`Server running on port ${PORT}`)
})
</code>

Készítsünk start scriptet:

<code javascript>
{
  "scripts": {
    "start": "nodemon app --watch app"
  },
}
</code>

Indítsuk el az szervert:
  npm start

Ellenőrizzük a választ:
  res localhost:8000/api/employees
  res localhost:8000/api/employees name='Árpád'

Amikor nem küldünk adatokat, egy üres választ kell kapjunk.
Ha küldünk egy nevet, vissza kell kapjuk a nevet.

===== Érvényesség ellenőrzése =====

<code javascript app/controllers/employeecontroller.js>
const EmployeeController = {

    store(req, res) {
        if(!req.body.name) {
            res.status(400)
            res.json({ 
                success: false, 
                message: 'Bad request'
            });
        }
        res.status(200)
        res.json(req.body.name )
    }
}

export default EmployeeController
</code>

===== Paraméterek fogadása =====

Az update és a delete művelet esetén az adott felhasználó azonosítóját paraméterként adjuk át az URL-ben. Például:
  http://localost:8000/api/valami/28
A 28 paramétert adjuk át a mintában.


Egészítsük ki az EmployeeController-t egy delete() függvénnyel:

<code javascript app/controllers/employeecontroller.js>
const EmployeeController = {

    store(req, res) {
        if(!req.body.name) {
            res.status(400);
            res.json({ 
                success: false, 
                message: 'Bad request'
            });
        }
        res.status(200);
        res.json(req.params.id);
    },
    delete(req, res) {
        if(!req.params.id) {
            res.status(400);
            res.json({ 
                success: false, 
                message: 'Bad request'
            });
        }
        res.status(200)
        res.json(req.body.name );        
    }
}

export default EmployeeController;
</code>

A delete esetén egy azonosítót várunk paraméterként. A példánkban ezt is megvizsgáljuk, ha nem érkezett ilyen, akkor sikertelen kérés a válasz.

Vegyünk fel egy új útválasztási sort:
<code javascript>
router.delete('/employees/:id', EmployeeController.delete);
</code>
A :id mondja meg, hogy "id" néven egy paramétert fogunk küldeni.

A teljes api.js ekkor:

<code javascript app/routes/api.js>
const Router = require('express');
const router = Router();
const EmployeeController = require('../controllers/employeecontrollers');

router.post('/employees', EmployeeController.store);
router.delete('/employees/:id', EmployeeController.delete);

export default router;
</code>


===== Adatok frissítése - update =====
Egészítsük ki az EmployeeControllert egy update függvénnyel:
<code javascript>
    update(req, res) {
        if(!req.params.id || !req.body.name) {
            res.status(400);
            res.json({
                success: false,
                message: 'Bad request'
            });
        }
        res.status(201);
        res.json({ id: req.params.id, name: req.body.name});
    }
</code>

A teljes kód:

<code javascript app/controllers/employeecontroller.js>
const EmployeeController = {

    store(req, res) {
        if(!req.body.name) {
            res.status(400);
            res.json({ 
                success: false, 
                message: 'Bad request'
            });
        }
        res.status(200)
        res.json(req.body.name );
    },
    delete(req, res) {
        if(!req.params.id) {
            res.status(400);
            res.json({ 
                success: false, 
                message: 'Bad request'
            });
        }
        res.status(200);
        res.json(req.params.id);
    },
    update(req, res) {
        if(!req.params.id || !req.body.name) {
            res.status(400);
            res.json({
                success: false,
                message: 'Bad request'
            });
        }
        res.status(201);
        res.json({ id: req.params.id, name: req.body.name});
    }
}

export default EmployeeController;
</code>

Vegyünk fel hozzá egy új routingot:
<code javascript>
router.put('/employees/:id', EmployeeController.update);
</code>

A teljes api.js:

<code javascript app/routes/api.js>
const Router = require('express');
const router = Router();
const EmployeeController = require('../controllers/employeecontrollers');

router.post('/employees', EmployeeController.store);
router.delete('/employees/:id', EmployeeController.delete);
router.put('/employees/:id', EmployeeController.update);

export default router;
</code>

Teszteljük a put metódust:
  res put localhost:8000/api/employees/30 name='Árpád'