[[:oktatas:web:back-end_framework:express|< Express]]

====== Express - Kontrollerek ======

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

===== Kontroller használta =====

Az előző fejezetben a routing-ban határoztuk meg, mit küldünk vissza
a kliens számára. Ezt most egy kontrollerre szeretnénk bízni.
A kontroller fogja elkérni az adatokat az adatbázistól.
A routing-ban pedig csak megmondjuk melyik kontrollert használjuk.

A kontrollereket JavaScript nyelven több módon is megvalósíthatjuk.

Ezek:
  * osztály (class) használata
  * objektumban függvények
  * objektumban névtelen függvények

Az exportálást is meg lehet oldani több módon, erre most nem térünk ki.
Ha több kontrollerre számítunk, érdemes egy külön **controllers** nevű
könyvtárba tenni azokat.
==== A class használata ====

Az indexet elnevezést szoktuk használni a függvény vagy metódus számára, ha GET HTTP metódusra válaszolunk.

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

    index(req, res) {
        res.send('műkdik');
    }
}

module.exports = EmployeeController;
</code>

A routing-t a következő példában egy **routes** nevű könyvtárba fogjuk tenni,
az állomány pedig **api.js** lesz.

A routingban ekkor így hivatkozunk a kontrollerre:

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

router.get('/employees', EmployeeController.prototype.index);
</code>

==== Objektumban függvény ====

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

    index(req, res) {
        res.send('műkdik');
    }
}

module.exports = EmployeeController;
</code>

A routingban ekkor így hivatkozunk:

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

router.get('/employees', EmployeeController.index);
</code>

==== Objektumban névtelen függvény ====

Egy index nevű tulajdonságot hozunk létre. Az érték pedig egy névtelen függvény.

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

    index: (req, res) => {
        res.send('műkdik');
    }
}

module.exports = EmployeeController;
</code>

A routingban ekkor így hivatkozunk:

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

router.get('/employees', EmployeeController.index);
</code>

===== Dolgozók =====

Készítsünk egy projektet. Ebben a projektben a routingot egy routes könyvtárba, azon belül az api.js fájlba tesszük. Készítünk egy controllers könyvtárat, abba tesszük a kontrollereket. A projekt neve legyen emp.

<code>
emp/
  |-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:
  yarn init -y
  pnpm install express
  pnpm install --save-dev nodemon

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

<code javascript app/controllers/employeecontroler.js>
const EmployeeController = {
    index(req, res) {
        res.send('műkdik');
    }
}

module.exports = EmployeeController;
</code>


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

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

router.get('/employees', EmployeeController.index);

module.exports = router;
</code>

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

app.use(express.json());
app.use('/api',router);

app.listen(8000, () => {
    console.log('Listening: localhost:8000');
});
</code>

Készítsünk start scriptet:

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

==== Indítás ====

Indítsuk el a szervert:
  npm start

==== Tesztelés ====


Teszteljük például a HTTPie eszköz http paranccsával:
  http localhost:8000/api/employees

===== Linkek =====

  * https://developer.mozilla.org/en-US/docs/Learn/Server-side/Express_Nodejs/routes (2023)