📁 Route, Controller, Service 구조란?

Route, Controller, Service 구조

1. Routes

역할

• 클라이언트(FE)의 요청을 받아서 해당 요청을 처리할 Controller 에게 전달하며 웹 애플리케이션의 진입점(entry point)로 동작함

• 특정 HTTP 메서드(GET, POST, PUT, DELETE 등)와 API의 URL 경로를 매핑하며, 이를 기반으로 적절한 Controller 메서드를 호출함

• app.get('/users', <컨트롤러 메서드 불러오기>) 같은 방식으로 정의됨

비유

• 라우트는 식당의 메뉴와 같음. 각 메뉴는 클라이언트가 요청할 수 있는 특정 기능(엔드포인트)을 나타냄.

예제 코드

• 예제에서는 간단한 요청이므로 controller를 불러오는 대신 간단히 아래와 같이 처리했지만, 실제 코드에서는 주로 controller를 불러와서 코드를 분리해 사용함

(req, res) => {
    res.send('GET 요청 처리: 모든 사용자 조회');
}

import express from 'express';

const app = express();

// GET 요청 처리
app.get('/users', (req, res) => {
    res.send('GET 요청 처리: 모든 사용자 조회');
});

// POST 요청 처리
app.post('/users', (req, res) => {
    res.send('POST 요청 처리: 새로운 사용자 생성');
});

// 서버 실행
app.listen(3000, () => {
    console.log('Server is listening on port 3000');
});

2. Controllers

역할

• Routes 에서 전달받은 클라이언트의 요청 데이터를 받아서 처리하고, 적절한 응답을 반환함

• 이 때, 처리 과정에서 Service 계층(컨트롤러 ↔ 데이터베이스를 연결)을 호출해 비즈니스 로직을 실행 후 서비스에서 반환된 결과를 클라이언트가 이해할 수 있는 형식(JSON 등)으로 변환 후 반환함
  

비유

• Controllers는 식당의 웨이터와 같음. 웨이터는 고객(클라이언트)의 주문(요청)을 받아 주방(서비스)에 전달하고, 준비된 음식을 다시 고객에게 가져옴.

예제 코드

import { UserService } from './services/UserService';
import express from 'express';

export class UserController {
    constructor(private userService: UserService) {
        this.userService = userService;
    }

    // 모든 사용자 조회
    getAllUsers = async (req: express.Request, res: express.Response) => {
        try {
            const users = await this.userService.getAllUsers();
            res.json(users); // 서비스에서 반환된 데이터를 응답으로 전송
        } catch (err) {
            res.status(500).json({ message: err.message });
        }
    };

    // 사용자 생성
    createUser = async (req: express.Request, res: express.Response) => {
        try {
            const newUser = req.body; // 요청 데이터에서 새 사용자 정보 가져옴
            const user = await this.userService.createUser(newUser);
            res.status(201).json(user);
        } catch (err) {
            res.status(500).json({ message: err.message });
        }
    };

    // 사용자 업데이트
    updateUser = async (req: express.Request, res: express.Response) => {
        try {
            const updatedUser = req.body;
            const user = await this.userService.updateUser(updatedUser);
            res.json(user);
        } catch (err) {
            res.status(500).json({ message: err.message });
        }
    };
}

3. Services

역할

• 데이터를 조회하거나 수정하는 작업을 정의하며 비즈니스 로직을 처리함

• 데이터베이스와의 상호작용을 수행함

• 서비스는 컨트롤러와 데이터베이스(리포지토리) 간의 중간 계층으로 작동.
  비즈니스 로직을 서비스에 집중시켜 재사용성을 높이고, 코드 테스트를 용이하게 만듦.

비유

• 서비스는 식당의 주방과 같음. 웨이터(컨트롤러)가 전달한 주문을 받고, 음식(응답)을 준비.

예제 코드

import { UserRepository } from '../repositories/UserRepository';
import { User } from '../models/User';

export class UserService {
    constructor(private userRepository: UserRepository) {
        this.userRepository = userRepository;
    }

    // 모든 사용자 조회
    async getAllUsers(): Promise<User[]> {
        return await this.userRepository.getAllUsers();
    }

    // 새 사용자 생성
    async createUser(user: User): Promise<User> {
        return await this.userRepository.createUser(user);
    }

    // 사용자 업데이트
    async updateUser(user: User): Promise<User> {
        return await this.userRepository.updateUser(user);
    }
}

4. Repositories (저장소)

• 역할: 서비스와 데이터 접근 계층(DAL) 사이에서 추상화 레이어 역할을 수행하며, 데이터베이스와 직접 통신.
• 장점: 데이터베이스 변경 시 애플리케이션의 유지보수성과 확장성을 높임.
• 비유: 저장소는 레시피와 같아서, 서비스(셰프)가 데이터베이스(식자재 창고)에서 필요한 데이터를 가져오거나 조합하는 방법을 알려줌.

➡️ 비유로 이해하기

• 라우트: 식당의 메뉴 → 어떤 기능을 요청할 수 있는지 정의.
• 컨트롤러: 웨이터 → 요청을 받아 서비스로 전달하고, 응답을 클라이언트에 반환.
• 서비스: 주방 → 비즈니스 로직을 처리하고 필요한 데이터를 조합해 결과 반환.