Node.js로 사용자 정의 백엔드 구축: 단계별 가이드-JS 튜토리얼-php.cn

Building a Custom Backend with Node.js: A Step-by-Step Guide

Node.js에서 사용자 정의 백엔드를 생성하려면 Node.js 환경 설정부터 API 구축 및 배포까지 여러 단계가 필요합니다. 다음은 Node.js를 사용하여 사용자 정의 백엔드를 생성하는 방법에 대한 자세한 단계별 가이드입니다.

1단계: 개발 환경 설정

코딩을 시작하기 전에 컴퓨터에 다음을 설치해야 합니다.

Node.js: 서버 측에서 JavaScript를 실행하기 위한 런타임입니다. nodejs.org에서 다운로드할 수 있습니다.
NPM(노드 패키지 관리자): Node.js와 함께 번들로 제공됩니다. 라이브러리를 설치하고 관리하는 데 사용됩니다.

Node.js와 NPM이 설치되어 있는지 확인하려면 다음을 실행하세요.

node -v
npm -v

로그인 후 복사

설치된 경우 버전 번호가 표시됩니다. 그렇지 않다면 Node.js를 설치하세요.

2단계: 새 프로젝트 만들기

프로젝트 폴더 만들기:

mkdir my-custom-backend
cd my-custom-backend

로그인 후 복사

package.json 파일 초기화:

npm init -y

로그인 후 복사

이 명령은 종속성을 관리하는 기본 package.json 파일을 생성합니다.

3단계: 필수 패키지 설치

백엔드를 구축하려면 일부 패키지를 설치해야 합니다.

Express: 웹 및 모바일 애플리케이션 구축을 위한 강력한 기능 세트를 제공하는 최소한의 유연한 Node.js 웹 애플리케이션 프레임워크입니다.
Nodemon: 디렉토리의 파일 변경이 감지되면 서버를 자동으로 다시 시작하여 Node.js 애플리케이션 개발을 돕는 도구입니다.
Body-parser: JSON 및 URL 인코딩된 양식 데이터를 처리하는 미들웨어입니다.
dotenv: 환경변수를 관리합니다.

다음을 실행하여 이러한 종속성을 설치합니다.

npm install express body-parser dotenv
npm install --save-dev nodemon

로그인 후 복사

express: HTTP 요청을 처리하는 핵심 프레임워크.
body-parser: 핸들러 이전에 미들웨어에서 들어오는 요청을 구문 분석하기 위한 미들웨어로, req.body를 통해 액세스할 수 있습니다.
dotenv: .env 파일의 환경 변수를 process.env로 로드합니다.
nodemon: 코드가 변경되면 자동으로 서버를 다시 시작합니다(개발 목적으로).

4단계: 서버 파일 생성

프로젝트 루트에 server.js라는 파일을 생성합니다. 이 파일은 Express 서버 설정을 처리합니다.

touch server.js

로그인 후 복사

server.js 내부에 다음 코드를 추가합니다.

// Import necessary modules
const express = require('express');
const bodyParser = require('body-parser');
const dotenv = require('dotenv');

// Load environment variables
dotenv.config();

// Initialize the app
const app = express();

// Middleware to parse JSON data
app.use(bodyParser.json());

// Define a basic route
app.get('/', (req, res) => {
  res.send('Welcome to my custom Node.js backend!');
});

// Start the server
const PORT = process.env.PORT || 3000;
app.listen(PORT, () => {
  console.log(`Server running on http://localhost:${PORT}`);
});

로그인 후 복사

이 파일은 요청을 수신하고 간단한 메시지로 응답하는 Express 서버를 설정합니다.

5단계: 서버 실행

서버를 실행하려면 node 명령을 사용할 수 있습니다.

node -v
npm -v

로그인 후 복사

그러나 개발을 위해서는 nodemon을 사용하여 변경 시 자동으로 서버를 다시 시작하는 것이 좋습니다.

mkdir my-custom-backend
cd my-custom-backend

로그인 후 복사

이제 브라우저에서 http://localhost:3000을 방문하세요. 다음을 확인하세요.

npm init -y

로그인 후 복사

6단계: 경로 및 처리기 정의

다음으로 백엔드에 대한 몇 가지 사용자 지정 경로를 추가해야 합니다. 예를 들어, 사용자 정보를 처리하는 API를 만들 수 있습니다.

npm install express body-parser dotenv
npm install --save-dev nodemon

로그인 후 복사

GET /users: 모든 사용자를 가져옵니다.
GET /users/:id: ID로 사용자를 가져옵니다.
POST /users: 새 사용자를 추가합니다.
DELETE /users/:id: ID별로 사용자를 삭제합니다.

7단계: 환경 변수 사용

dotenv 패키지를 사용하여 환경 변수를 구성할 수 있습니다. 루트 디렉터리에 .env 파일을 만듭니다.

touch server.js

로그인 후 복사

.env 내에서 다음과 같은 변수를 정의할 수 있습니다.

// Import necessary modules
const express = require('express');
const bodyParser = require('body-parser');
const dotenv = require('dotenv');

// Load environment variables
dotenv.config();

// Initialize the app
const app = express();

// Middleware to parse JSON data
app.use(bodyParser.json());

// Define a basic route
app.get('/', (req, res) => {
  res.send('Welcome to my custom Node.js backend!');
});

// Start the server
const PORT = process.env.PORT || 3000;
app.listen(PORT, () => {
  console.log(`Server running on http://localhost:${PORT}`);
});

로그인 후 복사

이 변수는 server.js에서 포트를 동적으로 설정하는 데 사용됩니다.

node server.js

로그인 후 복사

8단계: 오류 처리 및 미들웨어 추가

Express의 미들웨어는 애플리케이션의 요청-응답 주기에서 요청 객체(req), 응답 객체(res), 다음 미들웨어 기능에 접근하는 기능입니다.

오류 처리를 위한 사용자 정의 미들웨어를 생성할 수 있습니다.

npx nodemon server.js

로그인 후 복사

애플리케이션에서 처리되지 않은 오류를 포착하고 500 상태 코드로 응답합니다.

9단계: 프로젝트 구성(선택 사항)

지원서가 늘어나면 적절하게 정리하는 것이 좋습니다.

Welcome to my custom Node.js backend!

로그인 후 복사

controllers/: API 경로에 대한 논리를 처리합니다.
routes/: 엔드포인트를 정의하고 이를 컨트롤러에 연결합니다.
models/: 데이터 구조를 처리하며 향후 데이터베이스를 사용할 수도 있습니다.

10단계: 데이터베이스에 연결(선택 사항)

데이터를 유지하려면 백엔드를 데이터베이스에 연결할 수 있습니다. 예:

MongoDB: Mongoose를 사용하여 MongoDB 데이터베이스와 상호작용합니다.
MySQL/PostgreSQL: Sequelize 또는 pg를 사용하여 SQL 데이터베이스와 상호 작용합니다.

MongoDB의 경우 mongoose를 설치합니다.

// Example user data
let users = [
  { id: 1, name: 'John Doe' },
  { id: 2, name: 'Jane Doe' }
];

// Route to get all users
app.get('/users', (req, res) => {
  res.json(users);
});

// Route to get a user by ID
app.get('/users/:id', (req, res) => {
  const userId = parseInt(req.params.id);
  const user = users.find((u) => u.id === userId);

  if (user) {
    res.json(user);
  } else {
    res.status(404).send('User not found');
  }
});

// Route to create a new user
app.post('/users', (req, res) => {
  const newUser = {
    id: users.length + 1,
    name: req.body.name
  };
  users.push(newUser);
  res.status(201).json(newUser);
});

// Route to delete a user by ID
app.delete('/users/:id', (req, res) => {
  const userId = parseInt(req.params.id);
  users = users.filter((u) => u.id !== userId);
  res.status(204).send();
});

로그인 후 복사

server.js에서: