[데브코스] Express 라우터 모듈화와 userId를 활용한 API 구조 개선

어제에 이어 router을 사용하여 코드 개선 작업을 진행하였다. 기존에 구현했던 API를 모듈화하고, 구조화하면서 더 효율적인 코드 관리 방법을 배웠다

---

⭐서버와 라우터

이전에도 정리했지만 한 번 더 간단하게 정리하고 넘어가기

서버

클라이언트로부터 HTTP 요청을 받아 처리하는 주체

Express에서 app 객체가 서버의 역할을 담당하며, 모든 요청은 이 서버를 통해 처리된다.

const express = require("express");
const app = express();

app.listen(7773);

 

라우터

클라이언트의 요청 URL에 따라 적절한 경로로 요청을 전달하는 역할.

쉽게 말해, 요청이 들어왔을 때 "어떤 함수가 이 요청을 처리할지" 결정한다!

const userRouter = require("./routes/user-demo");
const channelRouter = require("./routes/channel-demo");

app.use("/", userRouter);
app.use("/channels", channelRouter);

• app.user("/", userRouter)는 루트 경로로 시작하는 모든 요청을 userRouter가 처리하도록 설정한다.
• 마찬가지로 /channels로 시작하는 모든 요청은 channelRouter가 처리한다.

⭐라우팅
요청이 날아왔을 때 해당 요청의 URL과 HTTP 메서드에 따라 적절한 코드나 콜백 함수로 연결하는 과정

---

🔀라우터 모듈화

Express의 강력한 기능 중 하나는 express.Router() 클래스를 통해 라우터를 모듈화 할 수 있다는 점이다. 코드의 가독성이 향상되고 유지보수하기 쉬워진다.

 

프로젝트 구조

/
├── app.js               // 애플리케이션의 메인 파일
└── routes/
    ├── user-demo.js     // 사용자 관련 라우터
    └── channel-demo.js  // 채널 관련 라우터

여기서 routes 폴더는 모든 라우터 파일을 관리하는 디렉토리이다. 각 라우터 파일은 관련 리소스(사용자, 채널)에 대한 엔드포인트를 정의한다.

 

app.js

서버 설정 및 라우터 등록

const express = require("express");
const app = express();

app.listen(7773);

const userRouter = require("./routes/user-demo");
const channelRouter = require("./routes/channel-demo");

app.use("/", userRouter);
app.use("/channels", channelRouter);

app.js는 Express 애플리케이션의 진입점으로, 서버를 설정하고 필요한 라우터를 등록한다. 현재, 두 개 라우터를 사용한다.

• userRouter: 루트 경로에 등록되어 사용자 관련 API 처리
• channelRouter: /channels 경로에 등록되어 채널 관련 API를 처리

 

코드 개선사항

1. app->router로 변경
기존 코드에서는 모든 라우트를 app 객체에 직접 등록했지만, 리팩토링된 코드에서는 Express Router를 사용하여 모듈화하였다.

//변경 전
app.post("/login", function (req, res) { /* ... */ });
app.post("/signup", function (req, res) { /* ... */ });

//변경 후
const router = express.Router();

router.post("/login", function (req, res) { /* ... */ });
router.post("/signup", function (req, res) { /* ... */ });

module.exports = router;

 

2. userId를 Key로 사용
기존에는 순차적인 id를 key로 사용햇지만, userId를 key로 사용하도록 변경하였다.

//변경 전
let db = new Map();
var id = 1;

app.post("/signup", function (req, res) {
  if (req.body !== undefined && req.body.userId) {
    db.set(id++, req.body);
    // ...
  }
});

//변경 후
let db = new Map();
// var id = 1; // 더 이상 필요하지 않음 - userId를 키로 사용

router.post("/signup", function (req, res) {
  if (req.body !== undefined && req.body.userId) {
    const userId = req.body.userId;

    // 이미 존재하는 아이디인지 확인
    if (db.has(userId)) {
      return res.status(409).json({ message: "이미 존재하는 아이디입니다." });
    }

    db.set(userId, req.body);
    // ...
  }
});

• userId로 사용자를 바로 찾을 수 있어 조회 성능 향상
• 중복 아이디 확인이 db.has(userId)로 간단해짐
• 별도의 id 변수 관리 불필요

 

3. 예외처리 개선
코드 전반에 걸쳐 예외 처리를 더 강화하였다.

 

로그인 시 예외처리

router.post("/login", function (req, res) {
  // userId나 password가 없는 경우 예외 처리
  if (!req.body || !req.body.userId || !req.body.password) {
    return res
      .status(400)
      .json({ message: "아이디와 비밀번호를 모두 입력해주세요." });
  }

  // ...userId를 직접 키로 사용하여 사용자 조회
  const loginUser = db.get(userId);

  if (!loginUser) {
    return res.status(401).json({ message: "존재하지 않는 아이디입니다" });
  }

  // ...
});

 

채널 API에서 예외처리

// 채널을 찾지 못했을 때 공통 응답 함수
function notFoundChannel(res) {
  return res.status(404).json({ message: "채널을 찾을 수 없습니다." });
}

// 사용 예
router.get("/user/:userId", (req, res) => {
  // ...

  if (db.size === 0) {
    return notFoundChannel(res);
  }

  // ...

  if (userChannels.length === 0) {
    return notFoundChannel(res);
  }

  // ...
});

• notFoundChannel 같은 공통 함수를 사용하여 중복 코드를 감소
• return을 활용한 early exit 패턴으로 코드 가독성 향상

 

채널 API 추가 기능

// 특정 사용자가 생성한 채널 목록 조회
router.get("/user/:userId", (req, res) => {
  const { userId } = req.params;

  if (db.size === 0) {
    return notFoundChannel(res);
  }

  const userChannels = [];

  db.forEach((channel, key) => {
    if (channel.userId === userId) {
      userChannels.push({ ...channel, id: key });
    }
  });

  if (userChannels.length === 0) {
    return notFoundChannel(res);
  }

  res.status(200).json({
    message: "사용자 채널 조회 성공",
    channels: userChannels,
  });
});

//채널 생성 시 userId 필드
let channel = {
  channelName: req.body.channelName,
  userId: req.body.userId,  // 사용자 ID 추가
  createdAt: new Date().toISOString(),
};   

채널 생성시 userId 필드를 추가하여 어떤 사용자가 채널을 생성했는지 추적할 수 있게 되었다. 이제, 특정 사용자가 생성한 모든 채널을 조회하는 API가 추가되었다.

 

❌약간의 보안이슈

userId 같은 값은 원래 헤더에 실어보내는 값인데, 우선 바디에 포함하도록 구성했다. 실제 프로덕션 환경에서는 사용자 인증을 위해 JWT 같은 토큰을 사용하고, 이 토큰은 보통 HTTP 헤더의 Authorization 필드에 포함된다.

// 토큰 인증 방식 맛보기
router.get("/users/me", authenticateToken, (req, res) => {
  // req.user는 authenticateToken 미들웨어를 통해 설정된 값
  const user = db.get(req.user.userId);
  res.json(user);
});

function authenticateToken(req, res, next) {
  const authHeader = req.headers['authorization'];
  const token = authHeader && authHeader.split(' ')[1];

  if (token == null) return res.sendStatus(401);

  // 토큰 검증 로직...
}

이것도 차차 배울 내용...!

---

코드 개선 작업을 통해 Express 애플리케이션의 구조화와 모듈화, 그리고 더 나은 예외처리 방법을 알 수 있었다. 하나하나 배울수록 어떻게 하면 더 구조적으로 API를 만들 수 있을지 생각이 점점 많아지는 것 같다.

이제는 진짜 기능도 다양한데, 슬슬 데이터 연동을 해보지 않으려나. 오늘 강의 중 ERD 파트도 있던데 슬슬 DB 연동도 하지 않을까 기대중입니다.