{"id":41094,"date":"2024-11-06T02:46:33","date_gmt":"2024-11-06T02:46:33","guid":{"rendered":"https:\/\/atmokpo.com\/w\/?p=41094"},"modified":"2024-11-26T06:37:37","modified_gmt":"2024-11-26T06:37:37","slug":"29-%ec%9d%b4%eb%af%b8%ec%a7%80-%ec%97%85%eb%a1%9c%eb%93%9c-%eb%b0%8f-%eb%af%b8%eb%94%94%ec%96%b4-%ea%b4%80%eb%a6%ac-nest-js%ec%97%90%ec%84%9c-%ed%8c%8c%ec%9d%bc-%ec%97%85%eb%a1%9c%eb%93%9c-api","status":"publish","type":"post","link":"https:\/\/atmokpo.com\/w\/41094\/","title":{"rendered":"29.\uc774\ubbf8\uc9c0 \uc5c5\ub85c\ub4dc \ubc0f \ubbf8\ub514\uc5b4 \uad00\ub9ac, Nest.js\uc5d0\uc11c \ud30c\uc77c \uc5c5\ub85c\ub4dc API \uad6c\ucd95"},"content":{"rendered":"
\n
\n

\uc774 \uae00\uc5d0\uc11c\ub294 Nest.js \ud504\ub808\uc784\uc6cc\ud06c\ub97c \uc0ac\uc6a9\ud558\uc5ec \uc774\ubbf8\uc9c0 \uc5c5\ub85c\ub4dc \ubc0f \ubbf8\ub514\uc5b4 \uad00\ub9ac \uae30\ub2a5\uc744 \uac16\ucd98 API\ub97c \uad6c\ucd95\ud558\ub294 \ubc29\ubc95\uc5d0 \ub300\ud574 \ub2e8\uacc4\ubcc4\ub85c \uc124\uba85\ud558\uaca0\uc2b5\ub2c8\ub2e4. \ub610\ud55c, \ud30c\uc77c \uc5c5\ub85c\ub4dc\uc640 \uad00\ub828\ub41c \uc5ec\ub7ec \uac00\uc9c0 \uc774\ub860\uc801 \ubc30\uacbd\uacfc \uc774\ub97c \uad6c\ud604\ud558\uae30 \uc704\ud55c \ucf54\ub4dc\ub97c \ud3ec\ud568\ud558\uaca0\uc2b5\ub2c8\ub2e4.<\/p>\n<\/header>\n

\n

1. Nest.js \uc18c\uac1c<\/h2>\n

Nest.js\ub294 \ubaa8\ub358 JavaScript\uc640 TypeScript \uae30\ubc18\uc758 \uc6f9 \uc560\ud50c\ub9ac\ucf00\uc774\uc158 \ud504\ub808\uc784\uc6cc\ud06c\uc785\ub2c8\ub2e4. \uc5d4\ud130\ud504\ub77c\uc774\uc988 \uc560\ud50c\ub9ac\ucf00\uc774\uc158\uc744 \uad6c\ucd95\ud558\uae30 \uc704\ud574 \ud544\uc694\ud55c \uae30\ub2a5\uc744 \uac16\ucd94\uace0 \uc788\uc73c\uba70, \ud6a8\uc728\uc801\uc778 \ubaa8\ub4c8\ud654\uc640 \ud14c\uc2a4\ud2b8 \uc6a9\uc774\uc131\uc744 \uc81c\uacf5\ud569\ub2c8\ub2e4. \uae30\uc874\uc758 Express.js\uc5d0 \uae30\ubc18\ud558\uace0 \uc788\uc9c0\ub9cc, \ub354 \ub9ce\uc740 \uae30\ub2a5\uacfc \uad6c\uc870\ub97c \uc81c\uacf5\ud569\ub2c8\ub2e4.<\/p>\n<\/section>\n

\n

2. \ud30c\uc77c \uc5c5\ub85c\ub4dc API \uad6c\ucd95\uc758 \ud544\uc694\uc131<\/h2>\n

\ud30c\uc77c \uc5c5\ub85c\ub4dc\ub294 \uc6f9 \uc560\ud50c\ub9ac\ucf00\uc774\uc158\uc5d0\uc11c \ud754\ud788 \ud544\uc694\ud55c \uae30\ub2a5 \uc911 \ud558\ub098\uc785\ub2c8\ub2e4. \uc0ac\uc6a9\uc790\uc5d0\uac8c \ud30c\uc77c\uc744 \uc5c5\ub85c\ub4dc\ud560 \uc218 \uc788\ub294 \uae30\ub2a5\uc744 \uc81c\uacf5\ud568\uc73c\ub85c\uc368 \ub2e4\uc591\ud55c \uc11c\ube44\uc2a4\u2014\uc0ac\uc9c4 \uacf5\uc720, \ubb38\uc11c \ucca8\ubd80, \ubbf8\ub514\uc5b4 \uad00\ub9ac\u2014\ub97c \uac00\ub2a5\ud558\uac8c \ud569\ub2c8\ub2e4. \uc774\ub7ec\ud55c API\ub97c \ud1b5\ud574 \uc0ac\uc6a9\uc790\ub294 \uc0ac\uc6a9\uc790\uc758 \ub370\uc774\ud130\ub97c \uc11c\ubc84\uc5d0 \uc548\uc804\ud558\uac8c \uc800\uc7a5\ud560 \uc218 \uc788\uc2b5\ub2c8\ub2e4.<\/p>\n<\/section>\n

\n

3. Nest.js \ud504\ub85c\uc81d\ud2b8 \uc124\uc815\ud558\uae30<\/h2>\n

\uba3c\uc800 Nest.js \ud504\ub85c\uc81d\ud2b8\ub97c \uc124\uc815\ud574\uc57c \ud569\ub2c8\ub2e4. \uc544\ub798 \uba85\ub839\uc5b4\ub97c \uc0ac\uc6a9\ud558\uc5ec \ud504\ub85c\uc81d\ud2b8\ub97c \uc0dd\uc131\ud569\ub2c8\ub2e4.<\/p>\n

npm i -g @nestjs\/cli\nnest new media-upload<\/code><\/pre>\n
\ud504\ub85c\uc81d\ud2b8\ub97c \uc0dd\uc131\ud55c \ud6c4, \ud544\uc694\ud55c \ubaa8\ub4c8\uc744 \uc124\uce58\ud569\ub2c8\ub2e4. \uc8fc\uc694 \ubaa8\ub4c8\ub85c\ub294 multer<\/strong>\uc640 @nestjs\/platform-express<\/strong>\uac00 \uc788\uc2b5\ub2c8\ub2e4.<\/p>\n
npm install --save multer @nestjs\/platform-express<\/code><\/pre>\n<\/section>\n
\n
4. \uc774\ubbf8\uc9c0 \uc5c5\ub85c\ub4dc\ub97c \uc704\ud55c DTO \uc124\uacc4<\/h2>\n
\uc774\ubbf8\uc9c0 \uc5c5\ub85c\ub4dc\ub97c \ucc98\ub9ac\ud558\uae30 \uc704\ud55c \ub370\uc774\ud130 \uc804\uc1a1 \uac1d\uccb4(DTO)\ub97c \uc124\uacc4\ud569\ub2c8\ub2e4. DTO\ub294 \ud074\ub77c\uc774\uc5b8\ud2b8\uc640 \uc11c\ubc84 \uac04\uc5d0 \ub370\uc774\ud130\uac00 \uc804\uc1a1\ub420 \ub54c\uc758 \uad6c\uc870\ub97c \uc815\uc758\ud569\ub2c8\ub2e4. \uc544\ub798\ub294 \ud30c\uc77c \uc5c5\ub85c\ub4dc\ub97c \uc704\ud55c \uac04\ub2e8\ud55c DTO \uc608\uc2dc\uc785\ub2c8\ub2e4.<\/p>\n
import { IsNotEmpty } from 'class-validator';\n        \n        export class UploadImageDto {\n            @IsNotEmpty()\n            readonly image: Express.Multer.File;\n        }<\/code><\/pre>\n<\/section>\n
\n
5. \ud30c\uc77c \uc5c5\ub85c\ub4dc\ub97c \uc704\ud55c \uc11c\ube44\uc2a4 \uad6c\ud604<\/h2>\n
\uc774\uc81c \ud30c\uc77c \uc5c5\ub85c\ub4dc\ub97c \ucc98\ub9ac\ud560 \uc11c\ube44\uc2a4\ub97c \uad6c\ud604\ud574\uc57c \ud569\ub2c8\ub2e4.  \uc774\ub97c \uc704\ud574, ‘upload.service.ts’ \ud30c\uc77c\uc744 \uc0dd\uc131\ud558\uace0 \ub2e4\uc74c\uc758 \ub0b4\uc6a9\uc744 \uad6c\ud604\ud569\ub2c8\ub2e4.<\/p>\n
import { Injectable } from '@nestjs\/common';\n        import { join } from 'path';\n        import { v4 as uuid } from 'uuid';\n        \n        @Injectable()\n        export class UploadService {\n            async uploadFile(file: Express.Multer.File): Promise {\n                const fileName = `${uuid()}-${file.originalname}`;\n                const filePath = join(__dirname, '..', '..', 'uploads', fileName);\n                \/\/ file system API \ub4f1\uc744 \uc0ac\uc6a9\ud574 \ud30c\uc77c\uc744 \uc800\uc7a5\n                return filePath;\n            }\n        }<\/string><\/code><\/pre>\n
\uc704\uc758 \uc11c\ube44\uc2a4\uc5d0\uc11c\ub294 UUID\ub97c \uc0ac\uc6a9\ud558\uc5ec \ud30c\uc77c \uc774\ub984\uc744 \uc0dd\uc131\ud558\uace0, \ud30c\uc77c\uc774 \uc5c5\ub85c\ub4dc\ub420 \uacbd\ub85c\ub97c \uc815\uc758\ud569\ub2c8\ub2e4. \uc774\ud6c4 \ud30c\uc77c \uc2dc\uc2a4\ud15c API\ub97c \uc0ac\uc6a9\ud558\uc5ec \ud30c\uc77c\uc744 \uc800\uc7a5\ud569\ub2c8\ub2e4.<\/p>\n<\/section>\n
\n
6. \ud30c\uc77c \uc5c5\ub85c\ub4dc\ub97c \uc704\ud55c \ucee8\ud2b8\ub864\ub7ec \uad6c\ud604<\/h2>\n
\uc774\uc81c \uc0ac\uc6a9\uc790\uac00 \ud30c\uc77c\uc744 \uc5c5\ub85c\ub4dc\ud560 \uc218 \uc788\ub3c4\ub85d \uc81c\uc5b4\ud558\ub294 \ucee8\ud2b8\ub864\ub7ec\ub97c \uc791\uc131\ud569\ub2c8\ub2e4. \uc544\ub798\ub294 ‘upload.controller.ts’\uc758 \uc608\uc2dc\uc785\ub2c8\ub2e4.<\/p>\n
import { Controller, Post, UseInterceptors, UploadedFile, Body } from '@nestjs\/common';\n        import { FileInterceptor } from '@nestjs\/platform-express';\n        import { UploadService } from '.\/upload.service';\n        import { UploadImageDto } from '.\/dto\/upload-image.dto';\n        \n        @Controller('uploads')\n        export class UploadController {\n            constructor(private readonly uploadService: UploadService) {}\n        \n            @Post('image')\n            @UseInterceptors(FileInterceptor('image'))\n            async uploadImage(@UploadedFile() file: Express.Multer.File, @Body() uploadImageDto: UploadImageDto) {\n                const filePath = await this.uploadService.uploadFile(file);\n                return { url: filePath };\n            }\n        }<\/code><\/pre>\n
\uc704\uc758 \ucee8\ud2b8\ub864\ub7ec\uc5d0\uc11c\ub294 HTTP POST \uc694\uccad\uc744 \ucc98\ub9ac\ud558\uc5ec \uc0ac\uc6a9\uc790\uac00 \uc5c5\ub85c\ub4dc\ud55c \uc774\ubbf8\uc9c0 \ud30c\uc77c\uc744 \ubc1b\uc544 \ucc98\ub9ac\ud569\ub2c8\ub2e4. ‘FileInterceptor’\ub97c \uc0ac\uc6a9\ud558\uc5ec \ud30c\uc77c \uc5c5\ub85c\ub4dc\ub97c \uac04\ud3b8\ud558\uac8c \ucc98\ub9ac\ud560 \uc218 \uc788\uc2b5\ub2c8\ub2e4.<\/p>\n<\/section>\n
\n
7. \uc5c5\ub85c\ub4dc \uacbd\ub85c \uc124\uc815\ud558\uae30<\/h2>\n
\ud30c\uc77c\uc774 \uc5c5\ub85c\ub4dc\ub420 \uacbd\ub85c\ub97c \uc124\uc815\ud558\ub294 \ubc29\ubc95\uc785\ub2c8\ub2e4. Nest.js\uc5d0\uc11c\ub294 multer\ub97c \uc0ac\uc6a9\ud558\uc5ec \ud30c\uc77c \uc5c5\ub85c\ub4dc\ub97c \uc27d\uac8c \ucc98\ub9ac\ud560 \uc218 \uc788\uc2b5\ub2c8\ub2e4. \uae30\ubcf8\uc801\uc73c\ub85c multer\uc758 \uc800\uc7a5 \uc635\uc158\uc744 \uc0ac\uc6a9\ud558\uac70\ub098, \uc0ac\uc6a9\uc790\uac00 \uc6d0\ud558\ub294 \uacbd\ub85c\ub97c \uc9c0\uc815\ud560 \uc218 \uc788\uc2b5\ub2c8\ub2e4.<\/p>\n
import { multerOptions } from '.\/multer.options';\n\n        export const multerOptions = {\n            storage: multer.diskStorage({\n                destination: (req, file, cb) => {\n                    cb(null, 'uploads\/');\n                },\n                filename: (req, file, cb) => {\n                    cb(null, `${uuid()}-${file.originalname}`);\n                },\n            }),\n        };\n        <\/code><\/pre>\n<\/section>\n
\n
8. \ubbf8\ub514\uc5b4 \uad00\ub9ac API \uad6c\ucd95<\/h2>\n
\uc774\ubbf8\uc9c0 \uc5c5\ub85c\ub4dc API \uc678\uc5d0\ub3c4 \ubbf8\ub514\uc5b4 \uad00\ub9ac\ub97c \uc704\ud55c API\ub97c \uad6c\ucd95\ud558\ub294 \ubc29\ubc95\ub3c4 \uc124\uba85\ud558\uaca0\uc2b5\ub2c8\ub2e4. \uc0ac\uc6a9\uc790\ub294 \uc5c5\ub85c\ub4dc\ud55c \ubbf8\ub514\uc5b4 \ud30c\uc77c\uc744 \uc870\ud68c, \uc0ad\uc81c\ud560 \uc218 \uc788\uc5b4\uc57c \ud569\ub2c8\ub2e4. \uc774\ub97c \uc704\ud55c \uac04\ub2e8\ud55c API\ub97c \uc791\uc131\ud574\ubcf4\uaca0\uc2b5\ub2c8\ub2e4.<\/p>\n
import { Controller, Get, Delete, Param } from '@nestjs\/common';\n\n        @Controller('media')\n        export class MediaController {\n            @Get()\n            findAll() {\n                \/\/ DB\uc5d0\uc11c \ubaa8\ub4e0 \ubbf8\ub514\uc5b4 \ud30c\uc77c \uc870\ud68c\n                return mediaList;\n            }\n\n            @Delete(':id')\n            remove(@Param('id') id: string) {\n                \/\/ \ud2b9\uc815 \ubbf8\ub514\uc5b4 \ud30c\uc77c \uc0ad\uc81c \ucc98\ub9ac\n                return { message: 'File removed' };\n            }\n        }<\/code><\/pre>\n<\/section>\n
\n
9. \ud14c\uc2a4\ud2b8 \ubc0f \ub514\ubc84\uae45<\/h2>\n
\uc774\uc81c \ubaa8\ub4e0 \ucef4\ud3ec\ub10c\ud2b8\uac00 \uc900\ube44\ub418\uc5c8\uc73c\ubbc0\ub85c, API\ub97c \ud14c\uc2a4\ud2b8\ud558\uace0 \ub514\ubc84\uae45\ud558\ub294 \ub2e8\uacc4\uc785\ub2c8\ub2e4. Postman \ub610\ub294 Insomnia\uc640 \uac19\uc740 \ub3c4\uad6c\ub97c \uc0ac\uc6a9\ud558\uc5ec API\ub97c \ud638\ucd9c\ud558\uace0, \uc815\uc0c1\uc801\uc73c\ub85c \uc791\ub3d9\ud558\ub294\uc9c0 \ud655\uc778\ud569\ub2c8\ub2e4.<\/p>\n<\/section>\n
\n
10. \ub9c8\uce58\uba70<\/h2>\n
\uc774\ubc88 \ud3ec\uc2a4\ud2b8\uc5d0\uc11c\ub294 Nest.js\ub97c \uc0ac\uc6a9\ud558\uc5ec \uc774\ubbf8\uc9c0 \uc5c5\ub85c\ub4dc \ubc0f \ubbf8\ub514\uc5b4 \uad00\ub9ac API\ub97c \uad6c\ucd95\ud558\ub294 \ubc29\ubc95\uc5d0 \ub300\ud574 \uc54c\uc544\ubcf4\uc558\uc2b5\ub2c8\ub2e4. Nest.js\ub294 TS \uae30\ubc18 \ud504\ub808\uc784\uc6cc\ud06c\ub85c, \uba40\ud2f0\ubbf8\ub514\uc5b4 \ud30c\uc77c \ucc98\ub9ac\ub97c \ud6a8\uc728\uc801\uc73c\ub85c \ud560 \uc218 \uc788\ub3c4\ub85d \ub3c4\uc640\uc90d\ub2c8\ub2e4. \uc774\uc640 \uac19\uc740 \uae30\ub2a5\uc740 \uc6f9 \uc560\ud50c\ub9ac\ucf00\uc774\uc158 \uac1c\ubc1c\uc758 \ud544\uc218\uc801\uc778 \uc694\uc18c\ub85c, \uc774\ub97c \ud1b5\ud574 \uc0ac\uc6a9\uc790\uc5d0\uac8c \ub354 \ub098\uc740 \uacbd\ud5d8\uc744 \uc81c\uacf5\ud560 \uc218 \uc788\uc2b5\ub2c8\ub2e4. \ucd94\uac00\uc801\uc73c\ub85c, \uc5ec\ub7ec \uac00\uc9c0 \ubcf4\uc548 \ub610\ub294 \uad00\ub9ac \uae30\ub2a5\uc744 \ucd94\uac00\ud558\uc5ec \uc11c\ube44\uc2a4\ub97c \ub354\uc6b1 \uc548\uc804\ud558\uac8c \uc0ac\uc6a9\ud560 \uc218 \uc788\ub3c4\ub85d \ud560 \uc218 \uc788\uc2b5\ub2c8\ub2e4.<\/p>\n<\/section>\n