[WebDev][Node.js] Node.js, Express, NoSQL(MongoDB)로 CRUD API 구축하기

2025.01.30 - [개발 Code/웹개발 WebDev] - [WebDev][Node.js] Node.js환경 설정 및 Express.js를 활용한 서버 만들기

2025.01.31 - [개발 Code/웹개발 WebDev] - [WebDev][Node.js] Node.js로 REST API 개발하기 (CRUD)

---

1. 개요

---

• 이 글에서는 Node.js와 Express를 사용하여 NoSQL 데이터베이스인 MongoDB와 연동하여 CRUD(Create, Read, Update, Delete) 기능을 구현하는 방법을 다룬다.
• 실습을 통해 REST API를 구축하고 데이터를 관리하는 과정을 학습할 수 있다.

---

2. 프로젝트 설정

---

2.1. 필수 패키지 설치

• 새로운 프로젝트 폴더를 생성하고 VSCode에서 해당 폴더를 엶:

mkdir my-mongo-api 
cd my-mongo-api

• npm을 사용하여 프로젝트를 초기화함:

npm init -y

• 필요한 패키지를 설치함:

npm install express mongoose body-parser cors dotenv

---

3. MongoDB 설정

---

3.1. MongoDB Atlas를 이용한 클라우드 데이터베이스 생성

• MongoDB Atlas에서 무료 계정을 생성하고 클러스터를 설정함
• 데이터베이스 연결 문자열을 복사하여 .env 파일을 생성하고 다음과 같이 저장함:

MONGO_URI=your_mongodb_connection_string 
PORT=5000

3.2. Mongoose를 활용한 MongoDB 연결

• server.js 파일을 생성하고 다음과 같이 Express 서버를 설정함:

require('dotenv').config();
const express = require('express');
const mongoose = require('mongoose');
const bodyParser = require('body-parser');
const cors = require('cors');

const app = express();
const PORT = process.env.PORT || 5000;

app.use(cors());
app.use(bodyParser.json());

mongoose.connect(process.env.MONGO_URI, {
    useNewUrlParser: true,
    useUnifiedTopology: true
}).then(() => console.log('MongoDB connected'))
.catch(err => console.log(err));

app.listen(PORT, () => {
    console.log(`Server is running on http://localhost:${PORT}`);
});

---

4. CRUD API 구현

---

4.1. 데이터 모델 생성

• models/User.js 파일을 생성하고 다음과 같이 User 모델을 정의함:

const mongoose = require('mongoose');

const UserSchema = new mongoose.Schema({
    name: String,
    email: String,
    age: Number
});

module.exports = mongoose.model('User', UserSchema);

4.2. 라우터 생성

• routes/userRoutes.js 파일을 생성하고 CRUD 기능을 구현함:

const express = require('express');
const router = express.Router();
const User = require('../models/User');

// 사용자 목록 조회 (Read)
router.get('/users', async (req, res) => {
    const users = await User.find();
    res.json(users);
});

// 새로운 사용자 추가 (Create)
router.post('/users', async (req, res) => {
    const newUser = new User(req.body);
    await newUser.save();
    res.status(201).json(newUser);
});

// 사용자 정보 수정 (Update)
router.put('/users/:id', async (req, res) => {
    const updatedUser = await User.findByIdAndUpdate(req.params.id, req.body, { new: true });
    res.json(updatedUser);
});

// 사용자 삭제 (Delete)
router.delete('/users/:id', async (req, res) => {
    await User.findByIdAndDelete(req.params.id);
    res.json({ message: 'User deleted' });
});

module.exports = router;

4.3. 라우터를 서버에 연결

• server.js 파일을 수정하여 라우터를 등록함:

const userRoutes = require('./routes/userRoutes');
app.use('/api', userRoutes);

---

5. Postman을 이용한 API 테스트

---

5.1. 서버 실행

• .env 파일이 있는 프로젝트 루트에서 다음 명령어 실행:

node server.js // nodemon server.js

5.2. API 테스트

• GET 요청 (사용자 목록 조회):
  • GET http://localhost:5000/api/users 요청을 보냄
• POST 요청 (새로운 사용자 추가):
  • POST http://localhost:5000/api/users
  • Body에 JSON 데이터 입력:

{
	"name": "5hr1rnp",
	"email": "5hr1rnp@money.com",
	"age": 30
}

• PUT 요청 (사용자 정보 수정):
  • PUT http://localhost:5000/api/users/{id}
  • 수정할 데이터를 JSON 형식으로 입력 후 전송
• DELETE 요청 (사용자 삭제):
  • DELETE http://localhost:5000/api/users/{id} 요청을 보냄
• MongoDB Cluster에 접속하여 생성된 데이터를 직접 확인해본다