Különbségek

A kiválasztott változat és az aktuális verzió közötti különbségek a következők.

--- oktatas:web:back-end_framework:express:swagger:swagger_json_fajl [2025/07/28 11:46] – [Projekt] admin
+++ oktatas:web:back-end_framework:express:swagger:swagger_json_fajl [2025/08/01 10:20] (aktuális) – eltávolítva admin
@@ Sor 1: / Sor 1: @@
-[[:oktatas:web:back-end_framework:express:swagger|< Swagger]]
-====== Express - Swagger JSON fájl ======
-  * **Szerző:** Sallai András
-  * Copyright (c) 2023, Sallai András
-  * Szerkesztve: 2024
-  * Licenc: [[https://creativecommons.org/licenses/by-sa/4.0/|CC Attribution-Share Alike 4.0 International]]
-  * Web: https://szit.hu
-===== Projekt =====
-  mkdri app01
-  cd app01
-  npm init -y
-Függőségek:
-<code>
-npm install --save express nodemon morgan
-npm install --save-dev swagger-jsdoc swagger-ui-express
-</code>
-Script:
-<code javascript package.json>
-{
-  "scripts": {
-    "start":"nodemon app --watch app"
-  }
-}
-</code>
-===== Szerver =====
-<code javascript app/index.js>
-const express = require('express')
-const app = new express()
-const morgan = require('morgan')
-const router = require('./routes/api')
-const PORT = process.env.PORT || 8000;
-app.use(express.json())
-app.use(morgan('tiny'))
-app.use(router)
-app.listen(PORT, () => {
-    console.log('Server is running on port: ', PORT)
-})
-</code>
-===== Swagger hozzáadása =====
-<code javascript app/index.js>
-const express = require('express')
-const app = new express()
-const morgan = require('morgan')
-const router = require('./routes/api')
-const swaggerUi = require('swagger-ui-express')
-const swaggerDocument = require('../swagger.json')
-const PORT = process.env.PORT || 8000;
-app.use('/swagger', swaggerUi.serve)
-app.get('/swagger', swaggerUi.setup(swaggerDocument))
-app.use(express.json())
-app.use(morgan('tiny'))
-app.use(router)
-app.listen(PORT, () => {
-    console.log('Server is running on port: ', PORT)
-})
-</code>
-===== Router =====
-<code javascript app/routes/api.js>
-const router = require('express').Router();
-router.get('/ping', async (req, res) => {
-    res.send({message: 'Helló'})
-})
-module.exports = router
-</code>
-===== swagger.json fájl =====
-<code javascript swagger.json>
-{
-    "swagger": "2.0",
-    "paths": {
-        "/ping": {
-            "get": {
-                "operationId": "pingEndpoint",
-                "description": "Egyszerű elérés ellenőrzés",
-                "responses": {
-                    "200": {
-                        "description": "Siker"
-                    }
-                }
-            }
-        }
-    }
-}
-</code>
-Nézzük meg az eredményt:
-  * http://localhost:8000/api-docs/
-===== Read művelet =====
-<code javascript swagger.json>
-{
-    "swagger": "2.0",
-    "basePath": "/api",
-    "paths": {
-        "/employees": {
-            "get": {
-                "description": "Dolgozók lekérése",
-                "responses": {
-                    "200": {
-                        "description": "Siker"
-                    }
-                }
-            }
-        }
-    }
-}
-</code>