{"id":1681,"date":"2026-04-30T15:16:54","date_gmt":"2026-04-30T15:16:54","guid":{"rendered":"https:\/\/wayhope.kro.kr\/?p=1681"},"modified":"2026-08-31T07:32:41","modified_gmt":"2026-08-31T07:32:41","slug":"node-js-%ec%84%9c%eb%b2%84-%ea%b0%9c%eb%b0%9c-%ed%95%b5%ec%8b%ac-%ec%a0%95%eb%a6%ac","status":"publish","type":"post","link":"https:\/\/wayhope.kro.kr\/?p=1681","title":{"rendered":"Node.js REST API \uc11c\ubc84 \uac1c\ubc1c \ud575\uc2ec \uc815\ub9ac"},"content":{"rendered":"\n

Node.js REST API \uc11c\ubc84 \uac1c\ubc1c \ud575\uc2ec \uc815\ub9ac<\/h1>\n\n\n\n

Node.js\ub294 JavaScript\ub97c \ube0c\ub77c\uc6b0\uc800 \ubc16\uc5d0\uc11c \uc2e4\ud589\ud560 \uc218 \uc788\uac8c \ud574\uc8fc\ub294 \ub7f0\ud0c0\uc784\uc774\ub2e4. Chrome\uc758 V8 JavaScript \uc5d4\uc9c4\uc744 \uae30\ubc18\uc73c\ub85c \ub3d9\uc791\ud558\uba70, \uc11c\ubc84 \uac1c\ubc1c\uc5d0\uc11c\ub294 HTTP \uc694\uccad\uc744 \ucc98\ub9ac\ud558\uace0 \ub370\uc774\ud130\ubca0\uc774\uc2a4\uc640 \ud1b5\uc2e0\ud558\ub294 API \uc11c\ubc84\ub97c \ub9cc\ub4dc\ub294 \uc6a9\ub3c4\ub85c \ub9ce\uc774 \uc0ac\uc6a9\ud55c\ub2e4.<\/p>\n\n\n\n

Node.js \uc790\uccb4\uac00 \uc6f9 \ud504\ub808\uc784\uc6cc\ud06c\uc778 \uac83\uc740 \uc544\ub2c8\ub2e4. HTTP \uc11c\ubc84\ub97c \uc9c1\uc811 \ub9cc\ub4e4 \uc218 \uc788\ub294 http<\/code> \ubaa8\ub4c8\uc744 \uc81c\uacf5\ud558\uace0, Express \uac19\uc740 \ud504\ub808\uc784\uc6cc\ud06c\ub97c \ucd94\uac00\ud574\uc11c \ub77c\uc6b0\ud305, \ubbf8\ub4e4\uc6e8\uc5b4, \uc694\uccad \ucc98\ub9ac \ub4f1\uc744 \ud3b8\ud558\uac8c \uad6c\uc131\ud558\ub294 \ubc29\uc2dd\uc774 \uc77c\ubc18\uc801\uc774\ub2e4.<\/p>\n\n\n\n

REST API \uc11c\ubc84\uc758 \uc804\uccb4\uc801\uc778 \ud750\ub984\uc740 \ub2e4\uc74c\uacfc \uac19\uc774 \ubcfc \uc218 \uc788\ub2e4.<\/p>\n\n\n\n

Client -> HTTP Request -> Node.js -> Express -> Middleware -> Router -> Controller -> Service -> Repository -> Database\n<\/code><\/pre>\n\n\n\n
\uc751\ub2f5\uc740 \ubc18\ub300 \ubc29\ud5a5\uc73c\ub85c \uc804\ub2ec\ub41c\ub2e4.<\/p>\n\n\n\n
Database -> Repository -> Service -> Controller -> HTTP Response -> Client\n<\/code><\/pre>\n\n\n\n
Node.js\uc5d0\uc11c \uc11c\ubc84 \uac1c\ubc1c\uc744 \uc774\ud574\ud558\ub824\uba74 HTTP<\/code>, Routing<\/code>, Middleware<\/code>, Controller<\/code>, Service<\/code>, Database<\/code>, Authentication<\/code>\uc774 \uc5b4\ub5a4 \uad00\uacc4\ub85c \uc5f0\uacb0\ub418\ub294\uc9c0\ub97c \ubcf4\ub294 \uac83\uc774 \uc911\uc694\ud558\ub2e4.<\/p>\n\n\n\n
\n\n\n\n
Node.js\uc640 Express<\/h2>\n\n\n\n
Node.js\ub294 JavaScript \ucf54\ub4dc\ub97c \uc11c\ubc84\uc5d0\uc11c \uc2e4\ud589\ud558\uae30 \uc704\ud55c \ub7f0\ud0c0\uc784\uc774\ub2e4.<\/p>\n\n\n\n
\ube0c\ub77c\uc6b0\uc800\uc5d0\uc11c\ub294 JavaScript\uac00 \uc8fc\ub85c DOM \uc870\uc791\uc774\ub098 \uc0ac\uc6a9\uc790 \uc785\ub825 \ucc98\ub9ac\uc5d0 \uc0ac\uc6a9\ub418\uc9c0\ub9cc, Node.js\uc5d0\uc11c\ub294 \ud30c\uc77c \uc2dc\uc2a4\ud15c, \ub124\ud2b8\uc6cc\ud06c, \ud504\ub85c\uc138\uc2a4, \ub370\uc774\ud130\ubca0\uc774\uc2a4 \uac19\uc740 \uc11c\ubc84 \uae30\ub2a5\uc5d0 \uc811\uadfc\ud560 \uc218 \uc788\ub2e4.<\/p>\n\n\n\n
Node.js\uc758 \uae30\ubcf8 http<\/code> \ubaa8\ub4c8\ub9cc\uc73c\ub85c\ub3c4 HTTP \uc11c\ubc84\ub97c \uc9c1\uc811 \ub9cc\ub4e4 \uc218 \uc788\ub2e4.<\/p>\n\n\n\n
const http = require('http');\n\nconst server = http.createServer((req, res) => {\n    res.writeHead(200, {\n        'Content-Type': 'application\/json'\n    });\n\n    res.end(JSON.stringify({\n        message: 'Hello'\n    }));\n});\n\nserver.listen(3000);\n<\/code><\/pre>\n\n\n\n
\ud558\uc9c0\ub9cc \uc2e4\uc81c API \uc11c\ubc84\uc5d0\uc11c\ub294 \ub77c\uc6b0\ud305, JSON \ud30c\uc2f1, \uc778\uc99d, \uc5d0\ub7ec \ucc98\ub9ac \uac19\uc740 \uae30\ub2a5\uc774 \ud544\uc694\ud558\ub2e4.<\/p>\n\n\n\n
\uc774\ub7f0 \uc791\uc5c5\uc744 \uc9c1\uc811 \uad6c\uc131\ud558\ub294 \ub300\uc2e0 Express \uac19\uc740 \ud504\ub808\uc784\uc6cc\ud06c\ub97c \uc0ac\uc6a9\ud560 \uc218 \uc788\ub2e4.<\/p>\n\n\n\n
const express = require('express');\n\nconst app = express();\n\napp.use(express.json());\n\napp.get('\/users', (req, res) => {\n    res.json({\n        users: []\n    });\n});\n\napp.listen(3000);\n<\/code><\/pre>\n\n\n\n
\uad00\uacc4\ub97c \uc815\ub9ac\ud558\uba74 \ub2e4\uc74c\uacfc \uac19\ub2e4.<\/p>\n\n\n\n
JavaScript -> Node.js -> Express -> HTTP API Server\n<\/code><\/pre>\n\n\n\n
Node.js\uac00 \uc2e4\ud589 \ud658\uacbd\uc774\ub77c\uba74 Express\ub294 \uadf8 \uc704\uc5d0\uc11c HTTP \uc11c\ubc84\ub97c \uad6c\uc131\ud558\uae30 \uc704\ud55c \ud504\ub808\uc784\uc6cc\ud06c\ub2e4.<\/p>\n\n\n\n
\n\n\n\n
REST API<\/h2>\n\n\n\n
REST API\ub294 HTTP\uc758 \uad6c\uc870\ub97c \uc774\uc6a9\ud574 \uc11c\ubc84\uc758 \ub9ac\uc18c\uc2a4\ub97c \ub2e4\ub8e8\ub294 API \uc124\uacc4 \ubc29\uc2dd\uc774\ub2e4.<\/p>\n\n\n\n
\uc0ac\uc6a9\uc790 \ub370\uc774\ud130\ub97c \uad00\ub9ac\ud55c\ub2e4\uba74 \ub2e4\uc74c\uacfc \uac19\uc774 \uad6c\uc131\ud560 \uc218 \uc788\ub2e4.<\/p>\n\n\n\n
GET \/users\nGET \/users\/10\nPOST \/users\nPUT \/users\/10\nPATCH \/users\/10\nDELETE \/users\/10\n<\/code><\/pre>\n\n\n\n
HTTP Method\ub294 \uc694\uccad\uc758 \uc758\ub3c4\ub97c \ud45c\ud604\ud55c\ub2e4.<\/p>\n\n\n\n
GET -> \ub370\uc774\ud130 \uc870\ud68c\nPOST -> \ub370\uc774\ud130 \uc0dd\uc131\nPUT -> \ub370\uc774\ud130 \uc804\uccb4 \uc218\uc815\nPATCH -> \ub370\uc774\ud130 \uc77c\ubd80 \uc218\uc815\nDELETE -> \ub370\uc774\ud130 \uc0ad\uc81c\n<\/code><\/pre>\n\n\n\n
REST API\uc5d0\uc11c\ub294 URL\uc774 \ud2b9\uc815 \ub3d9\uc791\ubcf4\ub2e4 \ub9ac\uc18c\uc2a4\ub97c \ud45c\ud604\ud558\ub294 \ubc29\ud5a5\uc73c\ub85c \uc124\uacc4\ub418\ub294 \uac83\uc774 \uc77c\ubc18\uc801\uc774\ub2e4.<\/p>\n\n\n\n
GET \/getUsers\nPOST \/createUser\nDELETE \/deleteUser\n<\/code><\/pre>\n\n\n\n
\ubcf4\ub2e4\ub294 \ub2e4\uc74c\uacfc \uac19\uc740 \ud615\ud0dc\uac00 \uc790\uc5f0\uc2a4\ub7fd\ub2e4.<\/p>\n\n\n\n
GET \/users\nPOST \/users\nDELETE \/users\/:id\n<\/code><\/pre>\n\n\n\n
REST\uac00 \ubaa8\ub4e0 API\uc758 \uc808\ub300\uc801\uc778 \uaddc\uce59\uc774\ub77c\ub294 \uc758\ubbf8\ub294 \uc544\ub2c8\ub2e4. \uc2e4\uc81c \uc11c\ube44\uc2a4\uc5d0\uc11c\ub294 \ud300\uc758 \uaddc\uce59\uc774\ub098 API \ud2b9\uc131\uc5d0 \ub530\ub77c \uc77c\ubd80 \ubcc0\ud615\ud574\uc11c \uc0ac\uc6a9\ud560 \uc218 \uc788\ub2e4.<\/p>\n\n\n\n
\n\n\n\n
HTTP Request\uc640 Response<\/h2>\n\n\n\n
API \uc11c\ubc84\uc758 \uac00\uc7a5 \uae30\ubcf8\uc801\uc778 \uc5ed\ud560\uc740 HTTP Request\ub97c \ubc1b\uace0 HTTP Response\ub97c \ubc18\ud658\ud558\ub294 \uac83\uc774\ub2e4.<\/p>\n\n\n\n
\ud074\ub77c\uc774\uc5b8\ud2b8\uac00 \ub2e4\uc74c \uc694\uccad\uc744 \ubcf4\ub0b8\ub2e4\uace0 \uc0dd\uac01\ud574\ubcf4\uc790.<\/p>\n\n\n\n
Client -> GET \/users\/10 -> Node.js Server\n<\/code><\/pre>\n\n\n\n
\uc694\uccad\uc5d0\ub294 Header, URL, Parameter, Body \ub4f1\uc758 \uc815\ubcf4\uac00 \ud3ec\ud568\ub420 \uc218 \uc788\ub2e4.<\/p>\n\n\n\n
GET \/users\/10 HTTP\/1.1\nHost: example.com\nAuthorization: Bearer TOKEN\n<\/code><\/pre>\n\n\n\n
\uc11c\ubc84\ub294 \uc694\uccad\uc744 \ubd84\uc11d\ud558\uace0 \ud544\uc694\ud55c \ub85c\uc9c1\uc744 \uc218\ud589\ud55c\ub2e4.<\/p>\n\n\n\n
HTTP Request -> Routing -> Business Logic -> Database -> HTTP Response\n<\/code><\/pre>\n\n\n\n
\uc751\ub2f5\uc740 \ub2e4\uc74c\uacfc \uac19\uc740 \ud615\ud0dc\uac00 \ub420 \uc218 \uc788\ub2e4.<\/p>\n\n\n\n
HTTP\/1.1 200 OK\nContent-Type: application\/json\n\n{\n    \"id\": 10,\n    \"name\": \"user\"\n}\n<\/code><\/pre>\n\n\n\n
Express\uc5d0\uc11c\ub294 \ub2e4\uc74c\uacfc \uac19\uc774 \ucc98\ub9ac\ud560 \uc218 \uc788\ub2e4.<\/p>\n\n\n\n
app.get('\/users\/:id', (req, res) => {\n    const id = req.params.id;\n\n    res.json({\n        id: id,\n        name: 'user'\n    });\n});\n<\/code><\/pre>\n\n\n\n
\uc5ec\uae30\uc11c :id<\/code>\ub294 URL Parameter\ub2e4.<\/p>\n\n\n\n
\/users\/10 -> id = 10\n<\/code><\/pre>\n\n\n\n
Express\uc5d0\uc11c\ub294 req.params<\/code>\ub97c \ud1b5\ud574 \uc811\uadfc\ud55c\ub2e4.<\/p>\n\n\n\n
\n\n\n\n
Query Parameter\uc640 Request Body<\/h2>\n\n\n\n
HTTP \uc694\uccad\uc5d0\uc11c\ub294 \ub370\uc774\ud130\ub97c \uc804\ub2ec\ud558\ub294 \ubc29\uc2dd\uc774 \ubaa9\uc801\uc5d0 \ub530\ub77c \ub2ec\ub77c\uc9c4\ub2e4.<\/p>\n\n\n\n
\ud2b9\uc815 \ub9ac\uc18c\uc2a4\ub97c \uc2dd\ubcc4\ud558\ub294 \uac12\uc740 URL Parameter\ub97c \uc0ac\uc6a9\ud560 \uc218 \uc788\ub2e4.<\/p>\n\n\n\n
\/users\/10 -> URL Parameter -> id = 10\n<\/code><\/pre>\n\n\n\n
\uac80\uc0c9, \uc815\ub82c, \ud398\uc774\uc9c0\ub124\uc774\uc158 \uac19\uc740 \uc870\uac74\uc740 Query Parameter\ub97c \uc0ac\uc6a9\ud560 \uc218 \uc788\ub2e4.<\/p>\n\n\n\n
\/users?page=2&limit=20 -> Query Parameter -> page = 2, limit = 20\n<\/code><\/pre>\n\n\n\n
Express\uc5d0\uc11c\ub294 req.query<\/code>\ub85c \uac00\uc838\uc628\ub2e4.<\/p>\n\n\n\n
app.get('\/users', (req, res) => {\n    const page = req.query.page;\n    const limit = req.query.limit;\n});\n<\/code><\/pre>\n\n\n\n
POST\ub098 PUT \uac19\uc740 \uc694\uccad\uc5d0\uc11c JSON \ub370\uc774\ud130\ub97c \uc804\ub2ec\ud560 \ub54c\ub294 Request Body\ub97c \uc0ac\uc6a9\ud560 \uc218 \uc788\ub2e4.<\/p>\n\n\n\n
{\n    \"name\": \"user\",\n    \"age\": 25\n}\n<\/code><\/pre>\n\n\n\n
Express\uc5d0\uc11c JSON Middleware\ub97c \ub4f1\ub85d\ud558\uba74 req.body<\/code>\ub97c \ud1b5\ud574 \uc811\uadfc\ud560 \uc218 \uc788\ub2e4.<\/p>\n\n\n\n
HTTP Request -> express.json() -> req.body\n<\/code><\/pre>\n\n\n\n
app.use(express.json());\n\napp.post('\/users', (req, res) => {\n    const { name, age } = req.body;\n});\n<\/code><\/pre>\n\n\n\n
\uc815\ub9ac\ud558\uba74 \ub2e4\uc74c\uacfc \uac19\ub2e4.<\/p>\n\n\n\n
Resource Identifier -> URL Parameter\nSearch \/ Filter \/ Sort \/ Pagination -> Query Parameter\nCreate \/ Update Data -> Request Body\n<\/code><\/pre>\n\n\n\n
\n\n\n\n
Routing<\/h2>\n\n\n\n
Routing\uc740 HTTP Method\uc640 URL\uc5d0 \ub530\ub77c \uc5b4\ub5a4 \ucf54\ub4dc\ub97c \uc2e4\ud589\ud560\uc9c0 \uacb0\uc815\ud558\ub294 \uacfc\uc815\uc774\ub2e4.<\/p>\n\n\n\n
HTTP Request -> Method + URL \ud655\uc778 -> Route \uc120\ud0dd -> Handler \uc2e4\ud589\n<\/code><\/pre>\n\n\n\n
Express\uc5d0\uc11c\ub294 \ub2e4\uc74c\uacfc \uac19\uc774 \uc815\uc758\ud560 \uc218 \uc788\ub2e4.<\/p>\n\n\n\n
app.get('\/users', getUsers);\napp.get('\/users\/:id', getUser);\napp.post('\/users', createUser);\napp.delete('\/users\/:id', deleteUser);\n<\/code><\/pre>\n\n\n\n
API\uac00 \ucee4\uc9c0\uba74 \ubaa8\ub4e0 Route\ub97c \ud558\ub098\uc758 \ud30c\uc77c\uc5d0 \ub123\ub294 \ubc29\uc2dd\uc740 \uad00\ub9ac\ud558\uae30 \uc5b4\ub824\uc6cc\uc9c4\ub2e4.<\/p>\n\n\n\n
\uadf8\ub798\uc11c Express Router\ub97c \uc0ac\uc6a9\ud574 \uae30\ub2a5\ubcc4\ub85c \ub77c\uc6b0\ud2b8\ub97c \ubd84\ub9ac\ud560 \uc218 \uc788\ub2e4.<\/p>\n\n\n\n
const router = express.Router();\n\nrouter.get('\/', getUsers);\nrouter.get('\/:id', getUser);\nrouter.post('\/', createUser);\n\nmodule.exports = router;\n<\/code><\/pre>\n\n\n\n
\uadf8\ub9ac\uace0 \uc11c\ubc84\uc5d0\uc11c Router\ub97c \uc5f0\uacb0\ud55c\ub2e4.<\/p>\n\n\n\n
app.use('\/users', userRouter);\n<\/code><\/pre>\n\n\n\n
\uadf8\ub7ec\uba74 \uc2e4\uc81c \uc694\uccad \ud750\ub984\uc740 \ub2e4\uc74c\uacfc \uac19\ub2e4.<\/p>\n\n\n\n
GET \/users -> \/users Router -> getUsers\nGET \/users\/10 -> \/users Router -> getUser\nPOST \/users -> \/users Router -> createUser\n<\/code><\/pre>\n\n\n\n
Routing\uc758 \uc5ed\ud560\uc740 \uc694\uccad\uc744 \uc801\uc808\ud55c \ucc98\ub9ac \ucf54\ub4dc\uc5d0 \uc5f0\uacb0\ud558\ub294 \uac83\uc774\ub2e4.<\/p>\n\n\n\n
Router \uc548\uc5d0 \ubaa8\ub4e0 \ube44\uc988\ub2c8\uc2a4 \ub85c\uc9c1\uc744 \ub123\ub294 \uac83\uc740 \ubcc4\uac1c\uc758 \ubb38\uc81c\ub2e4.<\/p>\n\n\n\n
\n\n\n\n
Middleware<\/h2>\n\n\n\n
Express\uc5d0\uc11c \uc911\uc694\ud55c \uac1c\ub150 \uc911 \ud558\ub098\uac00 Middleware\ub2e4.<\/p>\n\n\n\n
Middleware\ub294 \uc694\uccad\uc774 Route Handler\uc5d0 \ub3c4\ub2ec\ud558\uae30 \uc804\uc774\ub098 \ucc98\ub9ac \uacfc\uc815\uc5d0\uc11c \uc2e4\ud589\ub418\ub294 \ud568\uc218\ub2e4.<\/p>\n\n\n\n
Request -> Middleware -> Middleware -> Route Handler -> Response\n<\/code><\/pre>\n\n\n\n
\uc608\ub97c \ub4e4\uc5b4 \ub85c\uadf8\ub97c \uae30\ub85d\ud558\ub294 Middleware\ub97c \ub9cc\ub4e4 \uc218 \uc788\ub2e4.<\/p>\n\n\n\n
app.use((req, res, next) => {\n    console.log(req.method, req.url);\n    next();\n});\n<\/code><\/pre>\n\n\n\n
next()<\/code>\uac00 \ud638\ucd9c\ub418\uba74 \ub2e4\uc74c Middleware \ub610\ub294 Route Handler\ub85c \ub118\uc5b4\uac04\ub2e4.<\/p>\n\n\n\n
Request -> Middleware -> next() -> Next Middleware -> Route Handler\n<\/code><\/pre>\n\n\n\n
\uc778\uc99d\ub3c4 Middleware\ub85c \ucc98\ub9ac\ud560 \uc218 \uc788\ub2e4.<\/p>\n\n\n\n
app.use(authMiddleware);\n<\/code><\/pre>\n\n\n\n
\ud2b9\uc815 API\uc5d0\ub9cc \uc801\uc6a9\ud560 \uc218\ub3c4 \uc788\ub2e4.<\/p>\n\n\n\n
router.get('\/profile', authMiddleware, getProfile);\n<\/code><\/pre>\n\n\n\n
Middleware\ub97c \uc0ac\uc6a9\ud558\uba74 \uc778\uc99d, \ub85c\uae45, \uc694\uccad \uac80\uc99d, \uc5d0\ub7ec \ucc98\ub9ac \uac19\uc740 \uacf5\ud1b5 \uae30\ub2a5\uc744 API \ub85c\uc9c1\uacfc \ubd84\ub9ac\ud560 \uc218 \uc788\ub2e4.<\/p>\n\n\n\n
\ub300\ud45c\uc801\uc778 \ud750\ub984\uc740 \ub2e4\uc74c\uacfc \uac19\ub2e4.<\/p>\n\n\n\n
Request -> Logging -> Authentication -> Validation -> Router -> Controller\n<\/code><\/pre>\n\n\n\n
\n\n\n\n
Controller\uc640 Business Logic<\/h2>\n\n\n\n
\uac04\ub2e8\ud55c API\ub77c\uba74 Route Handler\uc5d0\uc11c \ubaa8\ub4e0 \uc791\uc5c5\uc744 \ucc98\ub9ac\ud560 \uc218\ub3c4 \uc788\ub2e4.<\/p>\n\n\n\n
app.post('\/users', async (req, res) => {\n    const user = await db.users.insert(req.body);\n\n    res.json(user);\n});\n<\/code><\/pre>\n\n\n\n
\ud558\uc9c0\ub9cc \uc11c\ube44\uc2a4\uac00 \ucee4\uc9c0\uba74 \uc0ac\uc6a9\uc790 \uc0dd\uc131 \uc804\uc5d0 \uc774\uba54\uc77c \uc911\ubcf5 \ud655\uc778, \ube44\ubc00\ubc88\ud638 \uc554\ud638\ud654, \uad8c\ud55c \ud655\uc778, \ub370\uc774\ud130 \uac80\uc99d \uac19\uc740 \ub85c\uc9c1\uc774 \ucd94\uac00\ub420 \uc218 \uc788\ub2e4.<\/p>\n\n\n\n
\uc774\ub7f0 \ub85c\uc9c1\uc744 \ud558\ub098\uc758 Handler\uc5d0 \uacc4\uc18d \ub123\uc73c\uba74 \ucf54\ub4dc\uac00 \ubcf5\uc7a1\ud574\uc9c4\ub2e4.<\/p>\n\n\n\n
\uadf8\ub798\uc11c \uc11c\ubc84\ub97c \uc5ec\ub7ec \uacc4\uce35\uc73c\ub85c \ub098\ub204\ub294 \ubc29\uc2dd\uc744 \uc0ac\uc6a9\ud560 \uc218 \uc788\ub2e4.<\/p>\n\n\n\n
Route -> Controller -> Service -> Repository -> Database\n<\/code><\/pre>\n\n\n\n
\uac01 \uacc4\uce35\uc758 \uc5ed\ud560\uc740 \ub2e4\uc74c\uacfc \uac19\uc774 \uc0dd\uac01\ud560 \uc218 \uc788\ub2e4.<\/p>\n\n\n\n
Route -> HTTP Method\uc640 URL\uc744 Controller\uc5d0 \uc5f0\uacb0\nController -> HTTP Request\uc640 Response \ucc98\ub9ac\nService -> Business Logic \ucc98\ub9ac\nRepository -> Database \uc811\uadfc\nDatabase -> \uc2e4\uc81c \ub370\uc774\ud130 \uc800\uc7a5\n<\/code><\/pre>\n\n\n\n
\uc0ac\uc6a9\uc790 \uc0dd\uc131 API\ub97c \uc608\ub85c \ub4e4\uba74 \ub2e4\uc74c\uacfc \uac19\ub2e4.<\/p>\n\n\n\n
POST \/users -> UserController -> UserService -> UserRepository -> Database\n<\/code><\/pre>\n\n\n\n
Service\uc5d0\uc11c\ub294 \ub2e4\uc74c\uacfc \uac19\uc740 \ube44\uc988\ub2c8\uc2a4 \uaddc\uce59\uc744 \ucc98\ub9ac\ud560 \uc218 \uc788\ub2e4.<\/p>\n\n\n\n
UserService -> \uc774\uba54\uc77c \uc911\ubcf5 \ud655\uc778 -> \ube44\ubc00\ubc88\ud638 \uc554\ud638\ud654 -> \uc0ac\uc6a9\uc790 \uc0dd\uc131 -> UserRepository\n<\/code><\/pre>\n\n\n\n
\ub2e4\ub9cc \uc774 \uad6c\uc870\ub97c \ubaa8\ub4e0 \ud504\ub85c\uc81d\ud2b8\uc5d0 \ub611\uac19\uc774 \uc801\uc6a9\ud560 \ud544\uc694\ub294 \uc5c6\ub2e4.<\/p>\n\n\n\n
\uc791\uc740 \ud504\ub85c\uc81d\ud2b8\uc5d0\uc11c \uc9c0\ub098\uce58\uac8c \ub9ce\uc740 \uacc4\uce35\uc744 \ub9cc\ub4e4\uba74 \uc624\ud788\ub824 \ucf54\ub4dc\uac00 \ubcf5\uc7a1\ud574\uc9c8 \uc218 \uc788\ub2e4.<\/p>\n\n\n\n
\uc911\uc694\ud55c \uac83\uc740 HTTP \ucc98\ub9ac\uc640 \ube44\uc988\ub2c8\uc2a4 \uaddc\uce59, \ub370\uc774\ud130 \uc811\uadfc\uc744 \ud544\uc694 \uc774\uc0c1\uc73c\ub85c \uc11e\uc9c0 \uc54a\ub294 \uac83\uc774\ub2e4.<\/p>\n\n\n\n
\n\n\n\n
Database \uc5f0\uacb0<\/h2>\n\n\n\n
Node.js API \uc11c\ubc84\ub294 \uc77c\ubc18\uc801\uc73c\ub85c \ub370\uc774\ud130\ubca0\uc774\uc2a4\uc640 \ud1b5\uc2e0\ud55c\ub2e4.<\/p>\n\n\n\n
MySQL\uc744 \uc0ac\uc6a9\ud558\ub294 \uacbd\uc6b0\ub97c \ubcf4\uba74 \ub2e4\uc74c\uacfc \uac19\uc740 \uad6c\uc870\uac00 \ub420 \uc218 \uc788\ub2e4.<\/p>\n\n\n\n
Client -> Node.js -> Controller -> Service -> Repository -> MySQL\n<\/code><\/pre>\n\n\n\n
Repository\ub294 \ub370\uc774\ud130\ubca0\uc774\uc2a4 \uc811\uadfc\uc744 \ub2f4\ub2f9\ud55c\ub2e4.<\/p>\n\n\n\n
Service -> Repository -> SQL Query -> MySQL\n<\/code><\/pre>\n\n\n\n
ORM\uc744 \uc0ac\uc6a9\ud55c\ub2e4\uba74 \uac1d\uccb4 \uc911\uc2ec\uc73c\ub85c \ub370\uc774\ud130\ubca0\uc774\uc2a4\ub97c \ub2e4\ub8f0 \uc218 \uc788\ub2e4.<\/p>\n\n\n\n
\ubc18\ub300\ub85c SQL\uc744 \uc9c1\uc811 \uc2e4\ud589\ud558\ub294 \ubc29\uc2dd\ub3c4 \uc0ac\uc6a9\ud560 \uc218 \uc788\ub2e4.<\/p>\n\n\n\n
\uc5b4\ub5a4 \ubc29\uc2dd\uc744 \uc120\ud0dd\ud558\ub4e0 API Route\ub9c8\ub2e4 \ub370\uc774\ud130\ubca0\uc774\uc2a4 \uc811\uadfc \ucf54\ub4dc\ub97c \uc9c1\uc811 \uc791\uc131\ud558\uae30\ubcf4\ub2e4\ub294 \ubcc4\ub3c4\uc758 \ub370\uc774\ud130 \uc811\uadfc \uacc4\uce35\uc73c\ub85c \ubd84\ub9ac\ud558\ub294 \uac83\uc774 \uad00\ub9ac\uc5d0 \uc720\ub9ac\ud560 \uc218 \uc788\ub2e4.<\/p>\n\n\n\n
\ub610\ud55c DB \uc5f0\uacb0\uc744 \uc694\uccad\ub9c8\ub2e4 \uc0c8\ub85c \uc0dd\uc131\ud558\uae30\ubcf4\ub2e4 Connection Pool\uc744 \uc0ac\uc6a9\ud558\ub294 \uac83\uc774 \uc77c\ubc18\uc801\uc774\ub2e4.<\/p>\n\n\n\n
Node.js -> Connection Pool -> Database\n<\/code><\/pre>\n\n\n\n
Connection Pool\uc5d0\ub294 \uc5ec\ub7ec DB \uc5f0\uacb0\uc774 \uc900\ube44\ub418\uc5b4 \uc788\ub2e4.<\/p>\n\n\n\n
Node.js -> Connection Pool -> Connection 1 -> MySQL\nNode.js -> Connection Pool -> Connection 2 -> MySQL\nNode.js -> Connection Pool -> Connection 3 -> MySQL\nNode.js -> Connection Pool -> Connection 4 -> MySQL\n<\/code><\/pre>\n\n\n\n
\uc694\uccad\uc774 \ub4e4\uc5b4\uc624\uba74 \uae30\uc874 \uc5f0\uacb0\uc744 \uac00\uc838\uc640 \uc0ac\uc6a9\ud558\uace0 \uc791\uc5c5\uc774 \ub05d\ub098\uba74 Pool\uc5d0 \ubc18\ud658\ud55c\ub2e4.<\/p>\n\n\n\n
Request -> Connection Pool\uc5d0\uc11c \uc5f0\uacb0 \ud68d\ub4dd -> Query -> \uc5f0\uacb0 \ubc18\ud658\n<\/code><\/pre>\n\n\n\n
\uc774\ub807\uac8c \ud558\uba74 \uc694\uccad\ub9c8\ub2e4 \ub370\uc774\ud130\ubca0\uc774\uc2a4 \uc5f0\uacb0\uc744 \uc0c8\ub85c \uc0dd\uc131\ud558\ub294 \ube44\uc6a9\uc744 \uc904\uc77c \uc218 \uc788\ub2e4.<\/p>\n\n\n\n
\n\n\n\n
\ube44\ub3d9\uae30 \ucc98\ub9ac\uc640 Event Loop<\/h2>\n\n\n\n
Node.js \uc11c\ubc84\ub97c \uc774\ud574\ud560 \ub54c \ube44\ub3d9\uae30 \ucc98\ub9ac\ub3c4 \uc911\uc694\ud558\ub2e4.<\/p>\n\n\n\n
Node.js\ub294 JavaScript \uc2e4\ud589\uc744 \uae30\ubcf8\uc801\uc73c\ub85c \ud558\ub098\uc758 \uba54\uc778 \uc2a4\ub808\ub4dc\uc5d0\uc11c \ucc98\ub9ac\ud558\uba74\uc11c I\/O \uc791\uc5c5\uc744 \ube44\ub3d9\uae30\uc801\uc73c\ub85c \ucc98\ub9ac\ud558\ub294 \uad6c\uc870\ub97c \uc0ac\uc6a9\ud55c\ub2e4.<\/p>\n\n\n\n
\uc608\ub97c \ub4e4\uc5b4 \ub370\uc774\ud130\ubca0\uc774\uc2a4 \uc694\uccad\uc744 \uae30\ub2e4\ub9ac\ub294 \ub3d9\uc548 \ub2e4\ub978 \uc694\uccad\uc744 \ucc98\ub9ac\ud560 \uc218 \uc788\ub2e4.<\/p>\n\n\n\n
app.get('\/users', async (req, res) => {\n    const users = await getUsersFromDatabase();\n\n    res.json(users);\n});\n<\/code><\/pre>\n\n\n\n
\ucf54\ub4dc\ub9cc \ubcf4\uba74 await<\/code>\uc5d0\uc11c \uc11c\ubc84\uac00 \uba48\ucd94\ub294 \uac83\ucc98\ub7fc \ubcf4\uc77c \uc218 \uc788\uc9c0\ub9cc Node.js \ud504\ub85c\uc138\uc2a4 \uc804\uccb4\uac00 DB \uc751\ub2f5\uc744 \uae30\ub2e4\ub9ac\uba70 \uc815\uc9c0\ud558\ub294 \uac83\uc740 \uc544\ub2c8\ub2e4.<\/p>\n\n\n\n
\uac1c\ub150\uc801\uc73c\ub85c \ub2e4\uc74c\uacfc \uac19\uc774 \ubcfc \uc218 \uc788\ub2e4.<\/p>\n\n\n\n
Request A -> DB Request -> Waiting\nRequest B -> Processing\nRequest C -> Processing\nRequest D -> Processing\nDB Response A -> Request A Processing -> Response A\n<\/code><\/pre>\n\n\n\n
Node.js\uac00 I\/O \uc911\uc2ec\uc758 \uc11c\ubc84 \uac1c\ubc1c\uc5d0\uc11c \ub9ce\uc774 \uc0ac\uc6a9\ub418\ub294 \uc774\uc720 \uc911 \ud558\ub098\uac00 \uc774\ub7f0 \ube44\ub3d9\uae30 \ucc98\ub9ac \uad6c\uc870\ub2e4.<\/p>\n\n\n\n
\ud558\uc9c0\ub9cc CPU \uc5f0\uc0b0\uc740 \ub2e4\ub974\ub2e4.<\/p>\n\n\n\n
JavaScript \uc2e4\ud589 \uc2a4\ub808\ub4dc\uc5d0\uc11c \ub9e4\uc6b0 \ubb34\uac70\uc6b4 CPU \uc791\uc5c5\uc744 \uc7a5\uc2dc\uac04 \uc218\ud589\ud558\uba74 \ub2e4\ub978 \uc694\uccad \ucc98\ub9ac\uc5d0\ub3c4 \uc601\ud5a5\uc744 \uc904 \uc218 \uc788\ub2e4.<\/p>\n\n\n\n
CPU Heavy Task -> Event Loop \uc810\uc720 -> \ub2e4\ub978 Request \ucc98\ub9ac \uc9c0\uc5f0\n<\/code><\/pre>\n\n\n\n
\ub530\ub77c\uc11c Node.js\ub294 \ubaa8\ub4e0 \uc885\ub958\uc758 \uc11c\ubc84 \uc5f0\uc0b0\uc5d0 \ubb34\uc870\uac74 \uc801\ud569\ud55c \uac83\uc774 \uc544\ub2c8\ub77c I\/O \uc911\uc2ec \uc791\uc5c5\uacfc CPU \uc911\uc2ec \uc791\uc5c5\uc758 \ud2b9\uc131\uc744 \uad6c\ubd84\ud574\uc11c \uc0ac\uc6a9\ud574\uc57c \ud55c\ub2e4.<\/strong><\/p>\n\n\n\n
\n\n\n\n
Error Handling<\/h2>\n\n\n\n
API \uc11c\ubc84\uc5d0\uc11c\ub294 \uc815\uc0c1\uc801\uc778 \uc694\uccad\ub9cc \ub4e4\uc5b4\uc628\ub2e4\uace0 \uac00\uc815\ud560 \uc218 \uc5c6\ub2e4.<\/p>\n\n\n\n
\uc798\ubabb\ub41c \uc694\uccad, \uc778\uc99d \uc2e4\ud328, \uad8c\ud55c \ubd80\uc871, \ub370\uc774\ud130 \ubbf8\uc874\uc7ac, \ub370\uc774\ud130\ubca0\uc774\uc2a4 \uc624\ub958 \ub4f1 \ub2e4\uc591\ud55c \ubb38\uc81c\uac00 \ubc1c\uc0dd\ud560 \uc218 \uc788\ub2e4.<\/p>\n\n\n\n
Express\uc5d0\uc11c\ub294 Error Middleware\ub97c \ud1b5\ud574 \uacf5\ud1b5\uc801\uc778 \uc624\ub958 \ucc98\ub9ac\ub97c \uad6c\uc131\ud560 \uc218 \uc788\ub2e4.<\/p>\n\n\n\n
Request -> Middleware -> Controller -> Service -> Error -> Error Middleware -> HTTP Response\n<\/code><\/pre>\n\n\n\n
\uc608\ub97c \ub4e4\uc5b4:<\/p>\n\n\n\n
app.use((err, req, res, next) => {\n    console.error(err);\n\n    res.status(500).json({\n        message: 'Internal Server Error'\n    });\n});\n<\/code><\/pre>\n\n\n\n
HTTP Status Code\ub3c4 \uc0c1\ud669\uc5d0 \ub9de\uac8c \uc0ac\uc6a9\ud558\ub294 \uac83\uc774 \uc88b\ub2e4.<\/p>\n\n\n\n
200 -> OK\n201 -> Created\n400 -> Bad Request\n401 -> Unauthorized\n403 -> Forbidden\n404 -> Not Found\n409 -> Conflict\n500 -> Internal Server Error\n<\/code><\/pre>\n\n\n\n
\uc608\ub97c \ub4e4\uc5b4 \uc778\uc99d\ub418\uc9c0 \uc54a\uc740 \uc0ac\uc6a9\uc790\uac00 \uc778\uc99d\uc774 \ud544\uc694\ud55c API\uc5d0 \uc811\uadfc\ud558\uba74 401<\/code>\uc744 \uc0ac\uc6a9\ud560 \uc218 \uc788\ub2e4.<\/p>\n\n\n\n
\uc778\uc99d\uc740 \ub418\uc5c8\uc9c0\ub9cc \ud574\ub2f9 \uc791\uc5c5\uc744 \uc218\ud589\ud560 \uad8c\ud55c\uc774 \uc5c6\ub2e4\uba74 403<\/code>\uc744 \uc0ac\uc6a9\ud560 \uc218 \uc788\ub2e4.<\/p>\n\n\n\n
\uc624\ub958 \ucc98\ub9ac\uc758 \uc804\uccb4 \ud750\ub984\uc740 \ub2e4\uc74c\uacfc \uac19\ub2e4.<\/p>\n\n\n\n
Request -> Validation -> Authentication -> Business Logic -> Error Detection -> Error Handling -> Response\n<\/code><\/pre>\n\n\n\n
Status Code\ubfd0\ub9cc \uc544\ub2c8\ub77c API\uc758 \uc624\ub958 \uc751\ub2f5 \ud615\uc2dd\ub3c4 \uc77c\uad00\ub418\uac8c \uc720\uc9c0\ud558\ub294 \uac83\uc774 \ud074\ub77c\uc774\uc5b8\ud2b8 \uac1c\ubc1c\uc5d0 \uc720\ub9ac\ud558\ub2e4.<\/p>\n\n\n\n
\n\n\n\n
Authentication\uacfc JWT<\/h2>\n\n\n\n
REST API\uc5d0\uc11c\ub294 \uc11c\ubc84\uc5d0 \uc138\uc158\uc744 \uc800\uc7a5\ud558\ub294 \ubc29\uc2dd\ubfd0 \uc544\ub2c8\ub77c \ud1a0\ud070 \uae30\ubc18 \uc778\uc99d\ub3c4 \ub9ce\uc774 \uc0ac\uc6a9\ud55c\ub2e4.<\/p>\n\n\n\n
JWT\ub97c \uc0ac\uc6a9\ud558\ub294 \uacbd\uc6b0 \uc77c\ubc18\uc801\uc778 \ud750\ub984\uc740 \ub2e4\uc74c\uacfc \uac19\ub2e4.<\/p>\n\n\n\n
Login -> ID \/ Password \uac80\uc99d -> JWT \ubc1c\uae09 -> Client \uc800\uc7a5 -> API Request -> JWT \uac80\uc99d -> User \uc2dd\ubcc4 -> Business Logic\n<\/code><\/pre>\n\n\n\n
API \uc694\uccad\uc5d0\uc11c\ub294 \uc77c\ubc18\uc801\uc73c\ub85c Authorization Header\uc5d0 \ud1a0\ud070\uc744 \uc804\ub2ec\ud55c\ub2e4.<\/p>\n\n\n\n
Client -> Authorization: Bearer JWT -> API Server\n<\/code><\/pre>\n\n\n\n
Middleware\uc5d0\uc11c JWT\ub97c \uac80\uc99d\ud55c \ub4a4 \uc0ac\uc6a9\uc790 \uc815\ubcf4\ub97c \uc694\uccad \uac1d\uccb4\uc5d0 \ub123\uc744 \uc218\ub3c4 \uc788\ub2e4.<\/p>\n\n\n\n
Request -> Auth Middleware -> JWT \uac80\uc99d -> User \uc815\ubcf4 \ucd94\ucd9c -> req.user -> Controller\n<\/code><\/pre>\n\n\n\n
JWT \uc790\uccb4\uac00 \ub85c\uadf8\uc778 \uc2dc\uc2a4\ud15c\uc774\ub098 \uad8c\ud55c \uad00\ub9ac \uc2dc\uc2a4\ud15c\uc744 \uc81c\uacf5\ud558\ub294 \uac83\uc740 \uc544\ub2c8\ub2e4.<\/p>\n\n\n\n
JWT\ub294 \uc778\uc99d \uc815\ubcf4\ub97c \ud45c\ud604\ud558\uace0 \uc804\ub2ec\ud558\uae30 \uc704\ud55c \ud1a0\ud070 \ud615\uc2dd\uc774\uace0, \uc2e4\uc81c \uc0ac\uc6a9\uc790 \uc778\uc99d\uacfc \uad8c\ud55c \uc815\ucc45\uc740 \uc560\ud50c\ub9ac\ucf00\uc774\uc158\uc5d0\uc11c \uad6c\ud604\ud574\uc57c \ud55c\ub2e4.<\/p>\n\n\n\n
\uc2e4\uc81c \uc11c\ube44\uc2a4\uc5d0\uc11c\ub294 \ub2e4\uc74c \uc694\uc18c\ub3c4 \ud568\uaed8 \uace0\ub824\ud574\uc57c \ud55c\ub2e4.<\/p>\n\n\n\n
JWT -> Signature \uac80\uc99d -> Expiration \uac80\uc99d -> User \uc2dd\ubcc4 -> Authorization \uac80\uc0ac\n<\/code><\/pre>\n\n\n\n
Refresh Token\uc744 \uc0ac\uc6a9\ud558\ub294 \uacbd\uc6b0\uc5d0\ub294 \ub2e4\uc74c\uacfc \uac19\uc740 \uad6c\uc870\ub3c4 \ub9cc\ub4e4 \uc218 \uc788\ub2e4.<\/p>\n\n\n\n
Login -> Access Token \ubc1c\uae09 + Refresh Token \ubc1c\uae09 -> Client -> Access Token \ub9cc\ub8cc -> Refresh Token \uac80\uc99d -> Access Token \uc7ac\ubc1c\uae09\n<\/code><\/pre>\n\n\n\n
\n\n\n\n
Validation<\/h2>\n\n\n\n
\ud074\ub77c\uc774\uc5b8\ud2b8\uac00 \ubcf4\ub0b4\ub294 \ub370\uc774\ud130\ub97c \uadf8\ub300\ub85c \uc2e0\ub8b0\ud574\uc11c\ub294 \uc548 \ub41c\ub2e4.<\/p>\n\n\n\n
\ud68c\uc6d0\uac00\uc785 \uc694\uccad\uc774 \ub2e4\uc74c\uacfc \uac19\uc774 \ub4e4\uc5b4\uc628\ub2e4\uace0 \ud558\uc790.<\/p>\n\n\n\n
{\n    \"email\": \"test@example.com\",\n    \"password\": \"1234\"\n}\n<\/code><\/pre>\n\n\n\n
\uc11c\ubc84\uc5d0\uc11c\ub294 \uc774\uba54\uc77c \ud615\uc2dd, \ube44\ubc00\ubc88\ud638 \uae38\uc774, \ud544\uc218 \ud544\ub4dc \ub4f1\uc744 \uac80\uc99d\ud574\uc57c \ud55c\ub2e4.<\/p>\n\n\n\n
Request -> Validation -> Authentication -> Controller -> Service -> Database\n<\/code><\/pre>\n\n\n\n
Validation\uc744 Middleware\ub098 \ubcc4\ub3c4\uc758 Schema \uacc4\uce35\uc73c\ub85c \ubd84\ub9ac\ud558\uba74 API\ub9c8\ub2e4 \ubc18\ubcf5\ub418\ub294 \uac80\uc99d \ucf54\ub4dc\ub97c \uc904\uc77c \uc218 \uc788\ub2e4.<\/p>\n\n\n\n
\uc911\uc694\ud55c \uac83\uc740 \ud074\ub77c\uc774\uc5b8\ud2b8\uc5d0\uc11c \uac80\uc99d\ud588\ub2e4\uace0 \ud558\ub354\ub77c\ub3c4 \uc11c\ubc84\uc5d0\uc11c \ub2e4\uc2dc \uac80\uc99d\ud574\uc57c \ud55c\ub2e4\ub294 \uc810\uc774\ub2e4.<\/p>\n\n\n\n
Client Validation -> Request -> Server Validation -> Business Logic\n<\/code><\/pre>\n\n\n\n
\uc11c\ubc84 \uc785\uc7a5\uc5d0\uc11c \uc678\ubd80\uc5d0\uc11c \ub4e4\uc5b4\uc624\ub294 \ubaa8\ub4e0 \uc694\uccad\uc740 \uc2e0\ub8b0\ud560 \uc218 \uc5c6\ub294 \uc785\ub825\uc774\ub2e4.<\/p>\n\n\n\n
Validation\uc740 \ub2e8\uc21c\ud55c \ud3b8\uc758 \uae30\ub2a5\uc774 \uc544\ub2c8\ub77c \uc678\ubd80 \uc785\ub825\uacfc \ub0b4\ubd80 \uc2dc\uc2a4\ud15c \uc0ac\uc774\uc758 \uacbd\uacc4<\/strong>\ub97c \ub2f4\ub2f9\ud55c\ub2e4.<\/p>\n\n\n\n
\n\n\n\n
\ud658\uacbd \ubcc0\uc218\uc640 \uc124\uc815 \uad00\ub9ac<\/h2>\n\n\n\n
DB \ube44\ubc00\ubc88\ud638\ub098 JWT Secret \uac19\uc740 \ubbfc\uac10\ud55c \uac12\uc744 \uc18c\uc2a4 \ucf54\ub4dc\uc5d0 \uc9c1\uc811 \uc791\uc131\ud558\uba74 \uc548 \ub41c\ub2e4.<\/p>\n\n\n\n
const dbPassword = 'my-password';\n<\/code><\/pre>\n\n\n\n
\ub300\uc2e0 \ud658\uacbd \ubcc0\uc218\ub97c \uc0ac\uc6a9\ud560 \uc218 \uc788\ub2e4.<\/p>\n\n\n\n
const dbPassword = process.env.DB_PASSWORD;\n<\/code><\/pre>\n\n\n\n
\uac1c\ubc1c \ud658\uacbd\uc5d0\uc11c\ub294 .env<\/code> \ud30c\uc77c\uc744 \uc0ac\uc6a9\ud560 \uc218 \uc788\ub2e4.<\/p>\n\n\n\n
PORT=3000\nDB_HOST=localhost\nDB_USER=root\nDB_PASSWORD=password\nJWT_SECRET=secret\n<\/code><\/pre>\n\n\n\n
\ud658\uacbd \ubcc0\uc218\uc758 \uae30\ubcf8\uc801\uc778 \ud750\ub984\uc740 \ub2e4\uc74c\uacfc \uac19\ub2e4.<\/p>\n\n\n\n
Environment -> Node.js Process -> process.env -> Application Configuration\n<\/code><\/pre>\n\n\n\n
.env<\/code>\uc5d0\ub294 \ubbfc\uac10\ud55c \uc815\ubcf4\uac00 \ub4e4\uc5b4\uac08 \uc218 \uc788\uae30 \ub54c\ubb38\uc5d0 Git\uc5d0 \uadf8\ub300\ub85c \ucee4\ubc0b\ud558\uc9c0 \uc54a\ub3c4\ub85d \uad00\ub9ac\ud574\uc57c \ud55c\ub2e4.<\/p>\n\n\n\n
\uc6b4\uc601 \ud658\uacbd\uc5d0\uc11c\ub294 Docker, Kubernetes, \ud074\ub77c\uc6b0\ub4dc \ud658\uacbd\uc758 Secret\uc774\ub098 \ud658\uacbd \ubcc0\uc218 \uad00\ub9ac \uc2dc\uc2a4\ud15c \ub4f1\uc744 \uc0ac\uc6a9\ud560 \uc218 \uc788\ub2e4.<\/p>\n\n\n\n
\n\n\n\n
API \uc11c\ubc84\uc758 \uc804\uccb4 \uad6c\uc870<\/h2>\n\n\n\n
\uc55e\uc5d0\uc11c \uc124\uba85\ud55c \ub0b4\uc6a9\uc744 \ud558\ub098\ub85c \ubb36\uc73c\uba74 \uc77c\ubc18\uc801\uc778 Node.js REST API \uc11c\ubc84\ub294 \ub2e4\uc74c\uacfc \uac19\uc740 \ud750\ub984\uc73c\ub85c \ubcfc \uc218 \uc788\ub2e4.<\/p>\n\n\n\n
Client -> HTTP Request -> Express -> Middleware -> Router -> Controller -> Service -> Repository -> Database\n<\/code><\/pre>\n\n\n\n
\uac01 \ub2e8\uacc4\uc5d0\uc11c \ub2f4\ub2f9\ud558\ub294 \uc5ed\ud560\uc740 \ub2e4\uc74c\uacfc \uac19\ub2e4.<\/p>\n\n\n\n
Client -> API \uc694\uccad \uc0dd\uc131\nHTTP -> Request\uc640 Response \uc804\ub2ec\nExpress -> HTTP \uc11c\ubc84 \uad6c\uc131\nMiddleware -> \uacf5\ud1b5 \uc694\uccad \ucc98\ub9ac\nRouter -> Endpoint\uc640 Handler \uc5f0\uacb0\nController -> HTTP \uc694\uccad\uacfc \uc751\ub2f5 \ucc98\ub9ac\nService -> Business Logic \ucc98\ub9ac\nRepository -> Database \uc811\uadfc\nDatabase -> \ub370\uc774\ud130 \uc800\uc7a5 \ubc0f \uc870\ud68c\n<\/code><\/pre>\n\n\n\n
\uc751\ub2f5\uc740 \ubc18\ub300 \ubc29\ud5a5\uc73c\ub85c \uc774\ub3d9\ud55c\ub2e4.<\/p>\n\n\n\n
Database -> Repository -> Service -> Controller -> HTTP Response -> Client\n<\/code><\/pre>\n\n\n\n
\uc778\uc99d\uacfc \uac80\uc99d\uae4c\uc9c0 \ud3ec\ud568\ud558\uba74 \ub2e4\uc74c\uacfc \uac19\uc774 \ubcfc \uc218 \uc788\ub2e4.<\/p>\n\n\n\n
Client -> HTTP Request -> Logging -> Authentication -> Validation -> Router -> Controller -> Service -> Repository -> Database\n<\/code><\/pre>\n\n\n\n
\uc624\ub958\uac00 \ubc1c\uc0dd\ud558\uba74 \ubcc4\ub3c4\uc758 Error Handling \uacc4\uce35\uc73c\ub85c \uc804\ub2ec\ub420 \uc218 \uc788\ub2e4.<\/p>\n\n\n\n
Request -> Middleware -> Controller -> Service -> Error -> Error Middleware -> HTTP Response\n<\/code><\/pre>\n\n\n\n
\n\n\n\n
Node.js\uc640 \ub2e4\ub978 \uc11c\ubc84 \uae30\uc220\uc758 \uad00\uacc4<\/h2>\n\n\n\n
Node.js REST API \uc11c\ubc84\ub294 \ud558\ub098\uc758 \uc644\uc131\ub41c \uc11c\ubc84 \uc544\ud0a4\ud14d\ucc98\ub77c\uae30\ubcf4\ub2e4 \uc11c\ubc84\ub97c \uad6c\uc131\ud558\ub294 \uc2e4\ud589 \ud658\uacbd\uacfc \ud504\ub808\uc784\uc6cc\ud06c\uc5d0 \uac00\uae5d\ub2e4.<\/p>\n\n\n\n
\ud544\uc694\ud55c \uae30\ub2a5\uc5d0 \ub530\ub77c \uc5ec\ub7ec \uae30\uc220\uc744 \uc870\ud569\ud560 \uc218 \uc788\ub2e4.<\/p>\n\n\n\n
Node.js -> Express -> REST API\nNode.js -> MySQL -> Persistent Data\nNode.js -> Redis -> Cache \/ Session\nNode.js -> Kafka -> Event Streaming\nNode.js -> JWT -> Authentication\n<\/code><\/pre>\n\n\n\n
\uc804\uccb4 \uc2dc\uc2a4\ud15c\uc73c\ub85c \ubb36\uc73c\uba74 \ub2e4\uc74c\uacfc \uac19\uc740 \uad6c\uc870\uac00 \ub420 \uc218 \uc788\ub2e4.<\/p>\n\n\n\n
Client -> Node.js -> Express -> Service -> MySQL\n                                  |\n                                  -> Redis\n                                  |\n                                  -> Kafka\n<\/code><\/pre>\n\n\n\n
Express\uac00 HTTP \uc694\uccad\uc744 \ubc1b\uace0, Service\uac00 \ube44\uc988\ub2c8\uc2a4 \ub85c\uc9c1\uc744 \ucc98\ub9ac\ud558\uace0, MySQL\uc774 \uc601\uc18d \ub370\uc774\ud130\ub97c \uc800\uc7a5\ud558\uace0, Redis\uac00 \uce90\uc2dc\ub098 \uc138\uc158\uc5d0 \uc0ac\uc6a9\ub418\uace0, Kafka\uac00 \uc11c\ube44\uc2a4 \uac04 \ube44\ub3d9\uae30 \uc774\ubca4\ud2b8 \uc804\ub2ec\uc744 \ub2f4\ub2f9\ud558\ub294 \uc2dd\uc774\ub2e4.<\/p>\n\n\n\n
GraphQL\uc744 \uc0ac\uc6a9\ud558\ub294 \uacbd\uc6b0\uc5d0\ub294 REST \ub300\uc2e0 GraphQL\uc744 API \uacc4\uce35\uc73c\ub85c \uc0ac\uc6a9\ud560 \uc218\ub3c4 \uc788\ub2e4.<\/p>\n\n\n\n
Client -> Node.js -> GraphQL -> Service -> Database\n<\/code><\/pre>\n\n\n\n
\uc911\uc694\ud55c \uac83\uc740 Node.js\uac00 \uc774\ub7f0 \uae30\ub2a5\uc744 \uc790\ub3d9\uc73c\ub85c \uc81c\uacf5\ud558\ub294 \uac83\uc774 \uc544\ub2c8\ub77c\ub294 \uc810\uc774\ub2e4.<\/p>\n\n\n\n
Node.js -> Runtime\nExpress -> HTTP Framework\nJWT -> Authentication Mechanism\nMySQL -> Database\nRedis -> In-Memory Data Store\nKafka -> Event Streaming Platform\n<\/code><\/pre>\n\n\n\n
\ud544\uc694\ud55c \uae30\uc220\uc744 \uc870\ud569\ud574\uc11c \ud558\ub098\uc758 \uc11c\ubc84 \uc2dc\uc2a4\ud15c\uc744 \uad6c\uc131\ud55c\ub2e4.<\/p>\n\n\n\n
\n\n\n\n
\uc2e4\ubb34\uc5d0\uc11c \uc0dd\uac01\ud574\uc57c \ud560 \ubd80\ubd84<\/h2>\n\n\n\n
\uac04\ub2e8\ud55c CRUD API\ub294 Node.js\uc640 Express\ub9cc\uc73c\ub85c\ub3c4 \ube60\ub974\uac8c \ub9cc\ub4e4 \uc218 \uc788\ub2e4.<\/p>\n\n\n\n
\ud558\uc9c0\ub9cc \uc2e4\uc81c \uc11c\ube44\uc2a4\uc5d0\uc11c\ub294 API \ud558\ub098\ub97c \ub9cc\ub4dc\ub294 \uac83\ubcf4\ub2e4 \uc6b4\uc601 \uac00\ub2a5\ud55c \uad6c\uc870\ub97c \ub9cc\ub4dc\ub294 \uac83\uc774 \ub354 \uc911\uc694\ud558\ub2e4.<\/p>\n\n\n\n
\uc2e4\ubb34\uc5d0\uc11c\ub294 \ub2e4\uc74c \uc694\uc18c\ub97c \ud568\uaed8 \uace0\ub824\ud574\uc57c \ud55c\ub2e4.<\/p>\n\n\n\n
Authentication\nAuthorization\nValidation\nError Handling\nLogging\nDatabase Connection Pool\nTransaction\nCaching\nRate Limiting\nSecurity\nEnvironment Configuration\nMonitoring\nTesting\n<\/code><\/pre>\n\n\n\n
\ubb38\uc81c\uac00 \uc0dd\uae30\ub294 \ub300\ud45c\uc801\uc778 \uad6c\uc870\ub294 Controller\uc5d0\uc11c \ubaa8\ub4e0 \uae30\uc220\uc744 \uc9c1\uc811 \uc0ac\uc6a9\ud558\ub294 \uacbd\uc6b0\ub2e4.<\/p>\n\n\n\n
Controller -> Database\nController -> Redis\nController -> JWT\nController -> Kafka\nController -> Business Logic\n<\/code><\/pre>\n\n\n\n
\uc774\ub807\uac8c \ub418\uba74 Controller\uac00 HTTP \ucc98\ub9ac\ubd80\ud130 \ube44\uc988\ub2c8\uc2a4 \uaddc\uce59, \ub370\uc774\ud130\ubca0\uc774\uc2a4, \uce90\uc2dc, \uba54\uc2dc\uc9c0 \ucc98\ub9ac\uae4c\uc9c0 \ubaa8\ub450 \ub2f4\ub2f9\ud558\uac8c \ub41c\ub2e4.<\/p>\n\n\n\n
\ubc18\ub300\ub85c \ubaa8\ub4e0 \ucf54\ub4dc\ub97c \ud558\ub098\uc758 Service\uc5d0 \ubab0\uc544\ub123\ub294 \uac83\ub3c4 \ubb38\uc81c\uac00 \ub420 \uc218 \uc788\ub2e4.<\/p>\n\n\n\n
Controller -> Massive Service -> Everything\n<\/code><\/pre>\n\n\n\n
\uc911\uc694\ud55c \uac83\uc740 \uacc4\uce35\uc744 \ubb34\uc870\uac74 \ub9ce\uc774 \ub9cc\ub4dc\ub294 \uac83\uc774 \uc544\ub2c8\ub2e4.<\/p>\n\n\n\n
\ubcc0\uacbd\ub418\ub294 \ucc45\uc784\uc744 \uc801\uc808\ud55c \uacbd\uacc4\ub85c \ubd84\ub9ac\ud558\ub294 \uac83<\/strong>\uc774 \ud575\uc2ec\uc774\ub2e4.<\/p>\n\n\n\n
\n\n\n\n
\uc11c\ubc84 \uc694\uccad\uc758 \uc804\uccb4 \ud750\ub984<\/h2>\n\n\n\n
Node.js REST API \uc11c\ubc84\uc5d0\uc11c \ud558\ub098\uc758 \uc694\uccad\uc774 \ub4e4\uc5b4\uc640 \ucc98\ub9ac\ub418\ub294 \uacfc\uc815\uc744 \uc804\uccb4\uc801\uc73c\ub85c \uc5f0\uacb0\ud558\uba74 \ub2e4\uc74c\uacfc \uac19\ub2e4.<\/p>\n\n\n\n
Client\n-> HTTP Request\n-> Express\n-> Middleware\n-> Authentication\n-> Validation\n-> Router\n-> Controller\n-> Service\n-> Repository\n-> Database\n-> Repository\n-> Service\n-> Controller\n-> HTTP Response\n-> Client\n<\/code><\/pre>\n\n\n\n
\uc608\ub97c \ub4e4\uc5b4 \uc0ac\uc6a9\uc790 \uc870\ud68c\ub77c\uba74:<\/p>\n\n\n\n
GET \/users\/10\n-> Authentication\n-> Validation\n-> User Router\n-> User Controller\n-> User Service\n-> User Repository\n-> MySQL\n-> User Repository\n-> User Service\n-> User Controller\n-> JSON Response\n-> Client\n<\/code><\/pre>\n\n\n\n
\uc0ac\uc6a9\uc790 \uc0dd\uc131\uc774\ub77c\uba74:<\/p>\n\n\n\n
POST \/users\n-> Authentication\n-> Validation\n-> User Router\n-> User Controller\n-> User Service\n-> Email \uc911\ubcf5 \ud655\uc778\n-> Password \uc554\ud638\ud654\n-> User Repository\n-> MySQL\n-> User Repository\n-> User Service\n-> User Controller\n-> HTTP Response\n-> Client\n<\/code><\/pre>\n\n\n\n
\uc774 \ud750\ub984\uc744 \uc774\ud574\ud558\uba74 Express\uc758 \uac1c\ubcc4 API\ub97c \uc678\uc6b0\ub294 \uac83\ubcf4\ub2e4 \uc11c\ubc84\uac00 \uc2e4\uc81c\ub85c \uc5b4\ub5bb\uac8c \ub3d9\uc791\ud558\ub294\uc9c0 \ud6e8\uc52c \uba85\ud655\ud558\uac8c \ubcfc \uc218 \uc788\ub2e4.<\/p>\n\n\n\n
\n\n\n\n
\uc815\ub9ac<\/h2>\n\n\n\n
Node.js REST API \uc11c\ubc84\uc758 \ud575\uc2ec \uad6c\uc870\ub294 \ub2e4\uc74c\uacfc \uac19\uc774 \uc815\ub9ac\ud560 \uc218 \uc788\ub2e4.<\/p>\n\n\n\n
Client -> HTTP Request -> Middleware -> Router -> Controller -> Service -> Repository -> Database\n<\/code><\/pre>\n\n\n\n
\uc751\ub2f5\uc740 \ubc18\ub300 \ubc29\ud5a5\uc73c\ub85c \ub3cc\uc544\uc628\ub2e4.<\/p>\n\n\n\n
Database -> Repository -> Service -> Controller -> HTTP Response -> Client\n<\/code><\/pre>\n\n\n\n
Node.js\ub294 JavaScript\ub97c \uc11c\ubc84\uc5d0\uc11c \uc2e4\ud589\ud558\uae30 \uc704\ud55c \ub7f0\ud0c0\uc784\uc774\uace0, Express\ub294 \uadf8 \uc704\uc5d0\uc11c HTTP API\ub97c \uad6c\uc131\ud558\uae30 \uc27d\uac8c \ud574\uc8fc\ub294 \ud504\ub808\uc784\uc6cc\ud06c\ub2e4.<\/p>\n\n\n\n
REST API\uc5d0\uc11c\ub294 HTTP Method\uc640 URL\uc744 \uc774\uc6a9\ud574 \ub9ac\uc18c\uc2a4\ub97c \ud45c\ud604\ud558\uace0, URL Parameter, Query Parameter, Request Body \ub4f1\uc744 \ud1b5\ud574 \ub370\uc774\ud130\ub97c \uc804\ub2ec\ud55c\ub2e4.<\/p>\n\n\n\n
Middleware\ub294 \uc778\uc99d, \uac80\uc99d, \ub85c\uae45 \uac19\uc740 \uacf5\ud1b5 \ucc98\ub9ac\ub97c \ub2f4\ub2f9\ud560 \uc218 \uc788\uace0, Router\ub294 \uc694\uccad\uc744 \uc801\uc808\ud55c Handler\uc5d0 \uc5f0\uacb0\ud55c\ub2e4.<\/p>\n\n\n\n
Controller\ub294 HTTP \uc694\uccad\uacfc \uc751\ub2f5\uc744 \ub2e4\ub8e8\uace0, Service\ub294 \ube44\uc988\ub2c8\uc2a4 \ub85c\uc9c1\uc744 \ucc98\ub9ac\ud558\uba70, Repository\ub294 \ub370\uc774\ud130\ubca0\uc774\uc2a4 \uc811\uadfc\uc744 \ub2f4\ub2f9\ud558\ub3c4\ub85d \ubd84\ub9ac\ud560 \uc218 \uc788\ub2e4.<\/p>\n\n\n\n
\uc5ec\uae30\uc5d0 JWT, Redis, MySQL, Kafka \uac19\uc740 \uae30\uc220\uc744 \ubaa9\uc801\uc5d0 \ub9de\uac8c \uc870\ud569\ud574\uc11c \ud558\ub098\uc758 \uc11c\ubc84 \uc2dc\uc2a4\ud15c\uc744 \uad6c\uc131\ud55c\ub2e4.<\/p>\n\n\n\n
Node.js \uc11c\ubc84 \uac1c\ubc1c\uc5d0\uc11c \uc911\uc694\ud55c \uac83\uc740 Express \ubb38\ubc95 \uc790\uccb4\uac00 \uc544\ub2c8\ub2e4.<\/p>\n\n\n\n
HTTP Request\n-> Middleware\n-> Router\n-> Controller\n-> Service\n-> Repository\n-> Database\n-> Response\n<\/code><\/pre>\n\n\n\n
\uc694\uccad\uc774 \ub4e4\uc5b4\uc640\uc11c \uc5b4\ub5a4 \uacc4\uce35\uc744 \uac70\uccd0 \ub370\uc774\ud130\ub97c \ucc98\ub9ac\ud558\uace0, \ub2e4\uc2dc \uc5b4\ub5a4 \ud615\ud0dc\ub85c \uc751\ub2f5\ub418\ub294\uc9c0\ub97c \uc774\ud574\ud558\ub294 \uac83<\/strong>\uc774 \ud575\uc2ec\uc774\ub2e4.<\/p>\n\n\n\n
\uc774 \uad6c\uc870\uac00 \uc7a1\ud788\uba74 Express\uc758 \uc138\ubd80 \uae30\ub2a5\uc774\ub098 \ub2e4\ub978 Node.js \ub77c\uc774\ube0c\ub7ec\ub9ac\ub97c \ucd94\uac00\ub85c \ud559\uc2b5\ud560 \ub54c\ub3c4 \uac01\uac01\uc758 \uae30\uc220\uc774 \uc5b4\ub290 \uc704\uce58\uc5d0\uc11c \uc5b4\ub5a4 \uc5ed\ud560\uc744 \ub2f4\ub2f9\ud558\ub294\uc9c0 \uc790\uc5f0\uc2a4\ub7fd\uac8c \uc5f0\uacb0\ud560 \uc218 \uc788\ub2e4.<\/p>\n","protected":false},"excerpt":{"rendered":"
Node.js REST API \uc11c\ubc84 \uac1c\ubc1c \ud575\uc2ec \uc815\ub9ac Node.js\ub294 JavaScript\ub97c \ube0c\ub77c\uc6b0\uc800 \ubc16\uc5d0\uc11c \uc2e4\ud589\ud560 \uc218 \uc788\uac8c \ud574\uc8fc\ub294 \ub7f0\ud0c0\uc784\uc774\ub2e4. Chrome\uc758 V8 JavaScript \uc5d4\uc9c4\uc744 \uae30\ubc18\uc73c\ub85c \ub3d9\uc791\ud558\uba70, \uc11c\ubc84 \uac1c\ubc1c\uc5d0\uc11c\ub294 HTTP \uc694\uccad\uc744 \ucc98\ub9ac\ud558\uace0 \ub370\uc774\ud130\ubca0\uc774\uc2a4\uc640 \ud1b5\uc2e0\ud558\ub294 API \uc11c\ubc84\ub97c \ub9cc\ub4dc\ub294 \uc6a9\ub3c4\ub85c \ub9ce\uc774 \uc0ac\uc6a9\ud55c\ub2e4. Node.js \uc790\uccb4\uac00 \uc6f9 \ud504\ub808\uc784\uc6cc\ud06c\uc778 \uac83\uc740 \uc544\ub2c8\ub2e4. HTTP \uc11c\ubc84\ub97c \uc9c1\uc811 \ub9cc\ub4e4 \uc218 \uc788\ub294 http \ubaa8\ub4c8\uc744 \uc81c\uacf5\ud558\uace0, Express \uac19\uc740 \ud504\ub808\uc784\uc6cc\ud06c\ub97c \ucd94\uac00\ud574\uc11c \ub77c\uc6b0\ud305, […]<\/p>\n","protected":false},"author":1,"featured_media":0,"comment_status":"closed","ping_status":"closed","sticky":false,"template":"","format":"standard","meta":{"footnotes":""},"categories":[49],"tags":[],"class_list":["post-1681","post","type-post","status-publish","format-standard","hentry","category-server"],"_links":{"self":[{"href":"https:\/\/wayhope.kro.kr\/index.php?rest_route=\/wp\/v2\/posts\/1681","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/wayhope.kro.kr\/index.php?rest_route=\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/wayhope.kro.kr\/index.php?rest_route=\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/wayhope.kro.kr\/index.php?rest_route=\/wp\/v2\/users\/1"}],"replies":[{"embeddable":true,"href":"https:\/\/wayhope.kro.kr\/index.php?rest_route=%2Fwp%2Fv2%2Fcomments&post=1681"}],"version-history":[{"count":3,"href":"https:\/\/wayhope.kro.kr\/index.php?rest_route=\/wp\/v2\/posts\/1681\/revisions"}],"predecessor-version":[{"id":1968,"href":"https:\/\/wayhope.kro.kr\/index.php?rest_route=\/wp\/v2\/posts\/1681\/revisions\/1968"}],"wp:attachment":[{"href":"https:\/\/wayhope.kro.kr\/index.php?rest_route=%2Fwp%2Fv2%2Fmedia&parent=1681"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/wayhope.kro.kr\/index.php?rest_route=%2Fwp%2Fv2%2Fcategories&post=1681"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/wayhope.kro.kr\/index.php?rest_route=%2Fwp%2Fv2%2Ftags&post=1681"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}