[javascript] Express.js에서의 RESTful API 개발 방법

Express.js는 Node.js의 웹 애플리케이션 프레임워크로써, RESTful API를 개발하기에 매우 유용합니다. 이 글에서는 Express.js를 사용하여 어떻게 RESTful API를 개발할 수 있는지 소개하겠습니다.

1. Express.js 설치

먼저, Express.js를 사용하기 위해 Node.js와 npm(Node Package Manager)을 설치해야 합니다. 설치가 완료되었다면, 다음 명령어로 Express.js를 설치합니다.

npm install express

2. Express 애플리케이션 설정

Express.js 애플리케이션을 생성하기 위해 app.js 파일을 생성하고 다음 코드를 작성합니다.

const express = require('express');
const app = express();
const port = 3000;

app.use(express.json());
app.use(express.urlencoded({ extended: false }));

app.listen(port, () => {
  console.log(`Server is running on port ${port}`);
});

위 코드에서는 Express.js 모듈을 require로 불러오고, app 변수에 Express 인스턴스를 생성합니다. 또한, POST 요청을 처리하기 위해 express.json()express.urlencoded()를 사용합니다.

3. RESTful 라우트 생성

RESTful API를 개발하기 위해 다음과 같이 라우트를 생성합니다.

app.get('/api/users', (req, res) => {
  // 사용자 목록을 가져오는 로직
});

app.post('/api/users', (req, res) => {
  // 새로운 사용자를 생성하는 로직
});

app.get('/api/users/:id', (req, res) => {
  // 특정 사용자 정보를 가져오는 로직
});

app.put('/api/users/:id', (req, res) => {
  // 특정 사용자 정보를 수정하는 로직
});

app.delete('/api/users/:id', (req, res) => {
  // 특정 사용자를 삭제하는 로직
});

위 코드에서는 app.get('/api/users')와 같이 HTTP 메소드와 경로를 지정하여 각각의 엔드포인트에 대한 핸들러 함수를 작성합니다.

4. 핸들러 함수 작성

각각의 라우트에 대한 핸들러 함수에서는 요청(req)과 응답(res) 객체를 사용하여 API의 비즈니스 로직을 작성합니다. 예를 들어, 사용자 목록을 가져오는 핸들러가 다음과 같이 작성될 수 있습니다.

app.get('/api/users', (req, res) => {
  const users = [
    { id: 1, name: 'John' },
    { id: 2, name: 'Jane' },
  ];

  res.json(users);
});

5. RESTful API 테스트

Express.js로 개발한 RESTful API를 테스트하기 위해 Postman과 같은 API 개발 도구를 사용할 수 있습니다. 이를 통해 각각의 엔드포인트로 HTTP 요청을 보내고 응답을 확인할 수 있습니다.

이상으로 Express.js에서의 RESTful API 개발 방법을 간략하게 소개하였습니다. Express.js는 간단하게 RESTful API를 개발할 수 있도록 많은 기능을 제공하기 때문에, 웹 개발에서 많이 사용되고 있습니다.

참고 자료