Felhasználói eszközök

Eszközök a webhelyen


oktatas:web:back-end_framework:express:swagger:swagger_json_fajl

< Swagger

Express - Swagger JSON fájl

Projekt

mkdri app01
cd app01
npm init -y

Függőségek:

pnpm install --save express nodemon morgan
pnpm install --save-dev swagger-jsdoc swagger-ui-express

Script:

package.json
{
  "scripts": {
    "start":"nodemon app --watch app"
  }
}

Szerver

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)
})

Swagger hozzáadása

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)
})

Router

app/routes/api.js
const router = require('express').Router();
 
router.get('/ping', async (req, res) => {
    res.send({message: 'Helló'})
})
 
module.exports = router

swagger.json fájl

swagger.json
{
    "swagger": "2.0",
    "paths": {
        "/ping": {
            "get": {
                "operationId": "pingEndpoint",
                "description": "Egyszerű elérés ellenőrzés",
                "responses": {
                    "200": {
                        "description": "Siker"
                    }
                }
            }
        }
    }
 
}

Nézzük meg az eredményt:

Read művelet

swagger.json
{
    "swagger": "2.0",
    "basePath": "/api",
    "paths": {
        "/employees": {
            "get": {
 
                "description": "Dolgozók lekérése",
                "responses": {
                    "200": {
                        "description": "Siker"
                    }
                }
            }
        }
    } 
}
oktatas/web/back-end_framework/express/swagger/swagger_json_fajl.txt · Utolsó módosítás: 2024/04/01 01:57 szerkesztette: admin