[작성자:] root

Express 개발 강좌, Express.js의 인기 있는 미들웨어 소개 (Helmet, Morgan 등)

Express.js는 가장 인기 있는 웹 애플리케이션 프레임워크 중 하나로, Node.js 환경에서 강력하고 유연한 백엔드 서버를 구축하는 데 적합합니다. Express는 미들웨어를 통해 다양한 기능을 손쉽게 확장할 수 있으며, 이를 활용하여 보안, 성능 모니터링, 로깅 등을 구현할 수 있습니다. 이번 강좌에서는 Express.js에서 자주 사용되는 미들웨어인 Helmet과 Morgan에 대해 자세히 알아보겠습니다.

1. Express.js 미들웨어란?

미들웨어는 요청(req) 및 응답(res) 객체를 수정하거나 제어하여 추가적인 처리를 제공하는 함수입니다. Express 애플리케이션에서는 여러 단계의 미들웨어를 사용할 수 있습니다. 각 미들웨어는 요청이 들어올 때 실행되며, 필요한 경우 다음 미들웨어로 제어를 넘길 수 있습니다. 기본적으로 미들웨어는 다음과 같은 기능을 수행할 수 있습니다:

  • 요청 본문 해석
  • 로그 기록
  • 보안 설정
  • 세션 관리
  • 오류 처리

2. Helmet

Helmet은 Express 애플리케이션에서 HTTP 헤더를 설정하여 보안을 강화하는 미들웨어입니다. 기본적으로 Helmet은 여러 가지 기본 보안 설정을 제공합니다. 웹 애플리케이션에서 자주 발생하는 보안 취약점을 미리 차단할 수 있도록 도와줍니다.

2.1 Helmet 설치

Helmet을 설치하려면 npm을 사용하여 간단히 다음 명령어를 입력하면 됩니다:

npm install helmet

2.2 Helmet 사용법

Helmet을 애플리케이션에 사용하려면, Express 앱에 Helmet을 미들웨어로 추가하면 됩니다. 아래의 예제를 통해 Helmet의 기본 설정을 적용하는 방법을 살펴보겠습니다.


    const express = require('express');
    const helmet = require('helmet');

    const app = express();
    
    // Helmet 미들웨어 사용
    app.use(helmet());

    app.get('/', (req, res) => {
        res.send('Hello, World!');
    });

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

2.3 Helmet의 다양한 기능

Helmet은 다양한 모듈을 포함하고 있으며, 각 모듈은 특정 HTTP 헤더를 설정합니다. 예를 들어:

  • helmet.contentSecurityPolicy(): 콘텐츠 보안 정책을 정의하여 XSS 공격을 방지합니다.
  • helmet.referrerPolicy(): 리퍼러 정보를 제어하여 개인정보 보호를 강화합니다.
  • helmet.xssFilter(): XSS 필터를 활성화하여 스크립트 공격을 방지합니다.

2.4 Helmet 설정 예제

Helmet을 사용하여 특정 설정을 조정하는 방법은 다음과 같습니다:


    app.use(helmet({
        contentSecurityPolicy: {
            directives: {
                defaultSrc: ["'self'"],
                scriptSrc: ["'self'", "https://trusted-script.com"]
            }
        },
        referrerPolicy: { policy: 'no-referrer' },
    }));

3. Morgan

Morgan은 HTTP 요청 로깅을 위한 미들웨어로, 주로 개발 중이나 프로덕션 환경에서 요청의 세부 정보를 기록하는 데 사용됩니다. Morgan을 사용하면 애플리케이션의 동작 상황을 쉽게 모니터링할 수 있습니다.

3.1 Morgan 설치

Morgan은 npm을 통해 설치할 수 있습니다:

npm install morgan

3.2 Morgan 사용법

Morgan을 애플리케이션에 추가하려면 다음과 같이 설정합니다:


    const morgan = require('morgan');

    app.use(morgan('combined'));  // 다양한 로깅 옵션 중 'combined' 사용

3.3 Morgan의 로깅 옵션

Morgan은 다양한 로깅 형식을 지원합니다. 다음은 몇 가지 예입니다:

  • 'tiny': 요청의 메서드, URL, 응답 시간만을 기록합니다.
  • 'dev': 컬러로 표시된 간단한 형식으로 로그를 출력합니다.
  • 'combined': 클라이언트의 IP, 메서드, URL, HTTP 버전, 응답 상태 코드 등을 포함하여 모든 정보를 기록합니다.

3.4 Morgan 설정 예제

아래는 Morgan을 사용하여 로그를 파일로 저장하는 방법을 보여주는 예제입니다:


    const fs = require('fs');
    const path = require('path');
    const morgan = require('morgan');

    // 로그 스트림을 파일로 저장하기 위해 createWriteStream 사용
    const accessLogStream = fs.createWriteStream(path.join(__dirname, 'access.log'), { flags: 'a' });

    app.use(morgan('combined', { stream: accessLogStream }));  // 로그를 파일로 스트리밍

4. 결론

이 강좌에서는 Express.js에서 자주 사용되는 미들웨어인 Helmet과 Morgan에 대해 알아보았습니다. Helmet을 통해 애플리케이션의 보안을 강화하고, Morgan을 통해 HTTP 요청을 효율적으로 기록할 수 있습니다. 이러한 미들웨어들은 Express 애플리케이션을 더욱 견고하고 안전하게 만드는 데 기여합니다. 애플리케이션을 구축할 때 이러한 미들웨어를 적절히 활용하여 최상의 결과를 얻으시길 바랍니다.

5. 참고 자료

더 깊이 있는 내용을 알고 싶다면 아래의 공식 문서를 참고하세요:

이 글은 Express 백앤드 서버 개발에 관한 강좌의 일환으로 작성되었습니다.

Express 개발 강좌, 데이터 모델링 및 스키마 정의

이번 강좌에서는 Node.js의 Express 프레임워크를 사용하여 데이터 모델링 및 스키마 정의에 대해 알아보겠습니다. 데이터 모델링은 애플리케이션이 데이터를 어떻게 구조화할지를 정의하는 과정이며, 스키마는 이 구조를 구체화하는 역할을 합니다. 본 강좌는 MongoDB와 Mongoose를 사용하여 예제 코드를 진행하며, 데이터의 CRUD(Create, Read, Update, Delete) 작업을 포함합니다.

목차

1. 데이터 모델링의 중요성

데이터 모델링은 애플리케이션의 구조를 결정짓는 중요한 과정입니다. 잘 설계된 데이터 모델은 다음과 같은 장점을 제공합니다:

  • 수정 용이성: 데이터 구조가 명확하게 정의되면 수정이 쉬워집니다.
  • 유지보수: 일관된 데이터 구조는 유지보수를 용이하게 합니다.
  • 효율성: 최적화된 데이터 모델은 성능을 개선할 수 있습니다.

2. MongoDB와 Mongoose 소개

MongoDB는 NoSQL 데이터베이스로, 데이터가 JSON 형식으로 저장됩니다. Mongoose는 MongoDB를 Node.js와 연결해주는 ODM(Object Data Modeling) 라이브러리입니다. Mongoose를 통해 데이터 모델을 쉽게 정의하고, CRUD 연산을 수행할 수 있습니다.

Mongoose 설치 및 설정

npm install mongoose

간단한 서버 설정

javascript
const express = require('express');
const mongoose = require('mongoose');

const app = express();
app.use(express.json());

mongoose.connect('mongodb://localhost:27017/mydatabase', {
    useNewUrlParser: true,
    useUnifiedTopology: true,
});

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

3. 데이터 스키마 정의

Mongoose를 사용하면 모델을 정의하고, 각 모델이 어떻게 데이터를 구조화할지를 설정할 수 있습니다. 예를 들어, 블로그 애플리케이션을 설계한다고 가정해보겠습니다.

블로그 게시물 모델 정의하기

javascript
const postSchema = new mongoose.Schema({
    title: {
        type: String,
        required: true,
        trim: true,
    },
    content: {
        type: String,
        required: true,
    },
    author: {
        type: String,
        required: true,
    },
    createdAt: {
        type: Date,
        default: Date.now,
    },
    tags: [String],
});

const Post = mongoose.model('Post', postSchema);

위의 스키마에서 각 필드의 유형과 제약 조건을 정의했습니다. required 속성은 필드가 반드시 필요함을 나타내고, trim 속성은 문자열의 공백을 제거합니다.

4. 기본 CRUD 작업

데이터 모델이 정의되면 CRUD 작업을 통해 데이터를 관리할 수 있습니다. 다음은 각 작업에 대한 예제입니다.

1) Create: 새로운 블로그 게시물 추가

javascript
app.post('/posts', async (req, res) => {
    try {
        const newPost = new Post(req.body);
        await newPost.save();
        res.status(201).send(newPost);
    } catch (error) {
        res.status(400).send(error);
    }
});

2) Read: 모든 블로그 게시물 조회

javascript
app.get('/posts', async (req, res) => {
    try {
        const posts = await Post.find({});
        res.send(posts);
    } catch (error) {
        res.status(500).send(error);
    }
});

3) Update: 블로그 게시물 수정

javascript
app.patch('/posts/:id', async (req, res) => {
    try {
        const post = await Post.findByIdAndUpdate(req.params.id, req.body, { new: true, runValidators: true });
        if (!post) {
            return res.status(404).send();
        }
        res.send(post);
    } catch (error) {
        res.status(400).send(error);
    }
});

4) Delete: 블로그 게시물 삭제

javascript
app.delete('/posts/:id', async (req, res) => {
    try {
        const post = await Post.findByIdAndDelete(req.params.id);
        if (!post) {
            return res.status(404).send();
        }
        res.send(post);
    } catch (error) {
        res.status(500).send(error);
    }
});

5. 결론

이번 강좌에서는 Express와 Mongoose를 이용한 데이터 모델링 및 스키마 정의에 대해 알아보았습니다. 직관적인 데이터 구조는 애플리케이션의 효율성 및 유지보수성을 높여 줍니다. Mongoose를 활용한 CRUD 작업을 통해 데이터의 생성, 조회, 수정, 삭제를 쉽게 수행할 수 있습니다.

이로써 데이터 모델링의 기본 개념과, Express 애플리케이션에서 이를 구현하는 방법을 배웠습니다. 다음 강좌에서는 더 복잡한 데이터 관계와 고급 Mongoose 기능에 대해 알아보겠습니다.

Express 개발 강좌, 자동 문서화 도구 사용법 및 설정

Express는 Node.js를 위한 경량의 웹 애플리케이션 프레임워크로, RESTful API를 개발하는 데 매우 유용합니다. 이러한 API를 문서화하는 것은 개발자와 사용자, 그리고 팀 간의 소통을 원활하게 해주는 중요한 작업입니다. 이 글에서는 Express 서버를 구축하고, 자동으로 API 문서를 생성해주는 도구인 Swagger를 사용하여 문서화하는 방법을 설명하겠습니다.

1. Express 및 Swagger 소개

Express는 수많은 미들웨어와 함께 사용되어 뛰어난 유연성을 제공합니다. Swagger는 API 명세서를 자동으로 생성해주는 도구로, API 개발 과정에서의 문서화 및 테스트를 매우 간편하게 만들어줍니다.

1.1 Express란?

Express는 서버 사이드 애플리케이션 구축을 위한 간단한 API를 제공하는 웹 프레임워크입니다. 라우터, 미들웨어, HTTP 요청 및 응답 처리 기능이 포함되어 있어 RESTful API 개발에 특히 적합합니다.

1.2 Swagger란?

Swagger는 API를 정의하고 문서화하는 데 도움을 주는 도구입니다. Swagger의 주요 이점은 API 문서를 동적으로 생성하고, 사용자가 API를 테스트할 수 있는 UI를 제공한다는 점입니다.

2. 개발 환경 설정

이제 Express와 Swagger를 설정하는 방법에 대해 알아보겠습니다. 아래의 단계를 따라 해보세요.

2.1 Node.js 및 npm 설치

Node.js가 설치되어 있지 않은 경우 [Node.js 공식 웹사이트](https://nodejs.org/)에서 설치합니다. 설치가 완료되면, 다음 명령어로 Node.js와 npm이 정상적으로 설치되었는지 확인합니다:

node -v
npm -v

2.2 프로젝트 폴더 생성 및 초기화

프로젝트를 진행할 폴더를 생성하고 npm을 사용하여 초기화합니다:

mkdir express-swagger-example
cd express-swagger-example
npm init -y

2.3 Express 설치

다음 명령어로 Express를 설치합니다:

npm install express

2.4 Swagger 관련 패키지 설치

Swagger UI와 Swagger-jsdoc을 설치합니다. Swagger UI는 API 문서를 시각화하여 보여주는 역할을 하고, Swagger-jsdoc은 JSDoc 스타일로 API 문서를 작성할 수 있게 해줍니다:

npm install swagger-ui-express swagger-jsdoc

3. Express 애플리케이션 설정

이제 기본적인 Express 애플리케이션을 설정해 보겠습니다. index.js 파일을 생성하고 아래의 코드를 입력하세요:

const express = require('express');
const swaggerJsDoc = require('swagger-jsdoc');
const swaggerUi = require('swagger-ui-express');

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

// Swagger 설정
const swaggerOptions = {
    swaggerDefinition: {
        openapi: '3.0.0',
        info: {
            title: 'Express API Documentation',
            version: '1.0.0',
            description: '자동화된 문서화 API 예제',
        },
        servers: [
            {
                url: `http://localhost:${port}`,
            },
        ],
    },
    apis: ['./routes/*.js'], // API 문서화할 경로
};

const swaggerDocs = swaggerJsDoc(swaggerOptions);
app.use('/api-docs', swaggerUi.serve, swaggerUi.setup(swaggerDocs));

// 기본 라우트 예제
app.get('/', (req, res) => {
    res.send('Hello World!');
});

// 서버 시작
app.listen(port, () => {
    console.log(`Server is running on http://localhost:${port}`);
});

3.1 Swagger 설정 설명

위 코드에서 swaggerDefinition 객체는 API 문서의 정보를 정의합니다. 여기에는 API의 이름, 버전, 설명 및 서버 정보를 설정합니다. apis 배열은 Swagger가 문서화할 API 파일의 경로를 지정합니다.

3.2 기본 라우트 추가

예제에서는 / 경로에 대한 GET 요청을 처리하는 기본 라우트를 추가했습니다. 이 라우트에 대한 Swagger 문서화도 추가해보겠습니다.

4. API 경로 문서화

다음으로, API 경로를 문서화할 파일인 routes/index.js 파일을 생성하고 아래의 코드를 입력해 보세요:

/**
 * @swagger
 * /:
 *   get:
 *     summary: Hello World를 응답합니다.
 *     responses:
 *       200:
 *         description: 성공적으로 응답
 */
app.get('/', (req, res) => {
    res.send('Hello World!');
});

5. 서버 실행 및 Swagger UI 확인

모든 설정이 완료되었으면, 서버를 실행합니다:

node index.js

브라우저에서 http://localhost:3000/api-docs를 열면 Swagger UI가 표시됩니다. 이 UI를 통해 API 문서와 함께 `Hello World!` 응답을 확인할 수 있습니다.

6. 다양한 API 문서화하기

위의 예제를 바탕으로, 보다 복잡한 API를 문서화할 수 있습니다. 예를 들어, 사용자의 CRUD(Create, Read, Update, Delete) 작업을 지원하는 API를 문서화해 보겠습니다.

6.1 CRUD API 설정

아래의 코드를 routes/user.js 파일에 추가합니다:

const express = require('express');
const router = express.Router();

/**
 * @swagger
 * /users:
 *   get:
 *     summary: 사용자 목록을 가져옵니다.
 *     responses:
 *       200:
 *         description: 성공적으로 사용자 목록을 반환합니다.
 */
router.get('/', (req, res) => {
    res.send('사용자 목록');
});

/**
 * @swagger
 * /users:
 *   post:
 *     summary: 새 사용자를 생성합니다.
 *     requestBody:
 *       required: true
 *       content:
 *         application/json:
 *           schema:
 *             type: object
 *             properties:
 *               name:
 *                 type: string
 *               age:
 *                 type: integer
 *     responses:
 *       201:
 *         description: 성공적으로 사용자 생성
 */
router.post('/', (req, res) => {
    res.status(201).send('사용자 생성됨');
});

/**
 * @swagger
 * /users/{id}:
 *   get:
 *     summary: 특정 사용자의 정보를 가져옵니다.
 *     parameters:
 *       - in: path
 *         name: id
 *         required: true
 *         description: 사용자 ID
 *         schema:
 *           type: integer
 *     responses:
 *       200:
 *         description: 사용자 정보 반환
 */
router.get('/:id', (req, res) => {
    res.send(`사용자 ID: ${req.params.id}`);
});

/**
 * @swagger
 * /users/{id}:
 *   put:
 *     summary: 특정 사용자의 정보를 업데이트합니다.
 *     parameters:
 *       - in: path
 *         name: id
 *         required: true
 *         description: 사용자 ID
 *         schema:
 *           type: integer
 *     responses:
 *       200:
 *         description: 사용자 정보 업데이트 성공
 */
router.put('/:id', (req, res) => {
    res.send(`사용자 ID: ${req.params.id} 정보 업데이트됨`);
});

/**
 * @swagger
 * /users/{id}:
 *   delete:
 *     summary: 특정 사용자를 삭제합니다.
 *     parameters:
 *       - in: path
 *         name: id
 *         required: true
 *         description: 사용자 ID
 *         schema:
 *           type: integer
 *     responses:
 *       204:
 *         description: 사용자 삭제 성공
 */
router.delete('/:id', (req, res) => {
    res.status(204).send();
});

module.exports = router;

6.2 라우터에 사용자 라우트 추가

위에서 생성한 사용자 라우트를 메인 애플리케이션에 추가해야 합니다. index.js 파일을 수정하고 사용자 라우터를 등록합니다:

const userRouter = require('./routes/user');
app.use('/users', userRouter);

7. API 문서 확인

서버를 다시 실행한 다음, Swagger UI를 방문하여 /users에 대한 다양한 API에 대한 문서를 확인합니다. 이를 통해 사용자 목록 조회, 생성, 조회, 업데이트 및 삭제와 같은 기능을 확인할 수 있습니다.

8. 보안 및 기타 설정

생성한 API를 운영할 때는 보안 방법론 또한 고려해야 합니다. JWT(Json Web Token) 인증 방식을 통해 사용자를 인증하고 API에 접근할 수 있도록 설정할 수 있습니다. 또한, Express의 미들웨어를 통해 요청을 로깅하거나 에러 핸들링을 추가하는 것도 좋은 방법입니다.

9. 마무리

이번 글에서는 Express 서버를 설정하고 Swagger를 활용하여 자동으로 API 문서를 생성하는 방법에 대해 알아보았습니다. 문서화는 개발의 중요한 부분 중 하나이며, Swagger와 같은 도구를 활용하여 이를 쉽게 처리할 수 있습니다. 이러한 도구를 적극 활용하여 더 나은 API 개발 환경을 만들어 보시기 바랍니다.

추가적으로, Swagger를 사용하여 만들어진 UI는 API 소비자에게 유용한 정보를 제공하며, 테스트를 직접 해볼 수 있는 기능도 제공합니다. 또한, API 도메인에 포함된 모든 엔드포인트를 쉽게 탐색할 수 있습니다.

10. 참고 자료

지금까지 Express와 Swagger를 활용한 API 문서화에 대한 소개를 마칩니다. 질문이나 의견이 있으시면 언제든지 댓글로 남겨주세요!

Express 개발 강좌, 기본 미들웨어 사용 (body-parser, cookie-parser 등)

이번 강좌에서는 Node.js의 유명한 웹 프레임워크인 Express를 사용하여 기본적인 미들웨어를 활용하는 방법을 알아보겠습니다. Express는 RESTful API 서버 및 웹 어플리케이션을 구축하는 데 매우 적합한 프레임워크이며, 강력한 미들웨어 시스템을 갖추고 있습니다. 미들웨어는 요청과 응답 객체를 처리하는 함수로, 다양한 기능들을 제공해 줍니다.

1. 미들웨어란?

미들웨어는 클라이언트의 요청(request)과 서버의 응답(response) 사이에서 중개 역할을 수행하는 함수입니다. 미들웨어는 여러 가지 용도로 사용될 수 있는데, 여기에는 요청 데이터의 처리, 사용자 인증 및 보안 체크, 로그 기록 및 오류 처리 등이 포함됩니다.

2. Express에서 미들웨어 사용하기

Express는 app.use() 메서드를 통해 미들웨어를 등록합니다. 이 메서드는 요청이 들어올 때마다 실행되며, 순차적으로 등록된 미들웨어가 실행됩니다.

3. 기본 미들웨어 설치 및 설정

Express의 기본 미들웨어 중 두 가지인 body-parser와 cookie-parser를 설치하고 설정하는 방법을 알아보겠습니다.

3.1 body-parser

body-parser 미들웨어는 HTTP 요청 본문을 구문 분석하여 자바스크립트 객체로 변환해주는 기능을 합니다. 일반적으로 JSON 형태의 데이터를 쉽게 처리할 수 있도록 돕습니다.

npm install body-parser

3.1.1 body-parser 설정 예제

다음은 body-parser를 사용하는 간단한 설정 예제입니다.

const express = require('express');
const bodyParser = require('body-parser');

const app = express();
const PORT = 3000;

// body-parser 미들웨어 사용
app.use(bodyParser.json()); // JSON 형태의 데이터 파싱
app.use(bodyParser.urlencoded({ extended: true })); // URL 인코딩 데이터 파싱

app.post('/api/data', (req, res) => {
    console.log(req.body); // 파싱된 데이터 로그 출력
    res.send('데이터 수신 완료');
});

app.listen(PORT, () => {
    console.log(`서버가 http://localhost:${PORT} 에서 시작되었습니다.`);
});

위 예제에서 bodyParser.json() 메서드는 클라이언트가 보내는 JSON 형태의 요청 본문을 파싱하고, bodyParser.urlencoded() 메서드는 URL 인코딩된 데이터를 파싱합니다.

3.2 cookie-parser

cookie-parser 미들웨어는 클라이언트의 요청에서 쿠키를 파싱하여 req.cookies 객체에 저장하는 기능을 합니다. 이 기능은 사용자의 상태를 저장하고 관리하는 데 유용합니다.

npm install cookie-parser

3.2.1 cookie-parser 설정 예제

다음은 cookie-parser를 사용하는 간단한 설정 예제입니다.

const express = require('express');
const cookieParser = require('cookie-parser');

const app = express();
const PORT = 3000;

// cookie-parser 미들웨어 사용
app.use(cookieParser());

app.get('/set-cookie', (req, res) => {
    res.cookie('myCookie', 'testValue', { maxAge: 900000, httpOnly: true });
    res.send('쿠키가 설정되었습니다.');
});

app.get('/get-cookie', (req, res) => {
    console.log(req.cookies); // 저장된 쿠키 로그 출력
    res.send('쿠키 값을 확인하였습니다.');
});

app.listen(PORT, () => {
    console.log(`서버가 http://localhost:${PORT} 에서 시작되었습니다.`);
});

위 예제에서 res.cookie() 메서드를 사용하여 쿠키를 설정하고, req.cookies를 통해 요청에 포함된 쿠키 값을 확인합니다. 쿠키는 사용자의 세션 정보를 저장하거나, 개인화된 사용자 경험을 제공하는 데 자주 사용됩니다.

4. 실습 예제: 미들웨어 통합하기

이제 body-parser와 cookie-parser를 모두 사용하는 예제를 만들어 보겠습니다. 이 예제는 사용자로부터 데이터를 받아와 쿠키에 저장하고, 후에 그 데이터를 읽어오는 API를 제공합니다.

const express = require('express');
const bodyParser = require('body-parser');
const cookieParser = require('cookie-parser');

const app = express();
const PORT = 3000;

app.use(bodyParser.json());
app.use(bodyParser.urlencoded({ extended: true }));
app.use(cookieParser());

app.post('/submit', (req, res) => {
    const { username } = req.body; // 요청 본문에서 username 추출
    res.cookie('username', username, { maxAge: 900000, httpOnly: true });
    res.send('사용자 이름이 쿠키에 저장되었습니다.');
});

app.get('/welcome', (req, res) => {
    const username = req.cookies.username; // 쿠키에서 사용자 이름 추출
    if (username) {
        res.send(`환영합니다, ${username}님!`);
    } else {
        res.send('쿠키에 저장된 사용자 이름이 없습니다.');
    }
});

app.listen(PORT, () => {
    console.log(`서버가 http://localhost:${PORT} 에서 시작되었습니다.`);
});

위 예제에서 클라이언트가 /submit 경로로 POST 요청을 하면, 사용자 이름을 쿠키에 저장하고, /welcome 경로로 GET 요청을 하면 저장된 사용자 이름을 응답으로 돌려줍니다.

5. 미들웨어 체이닝

Express에서는 여러 개의 미들웨어를 체이닝하여 사용할 수 있습니다. 체이닝을 통해 요청을 효율적으로 처리하고, 코드의 가독성을 높일 수 있습니다. 아래는 미들웨어 체이닝의 예입니다.

const express = require('express');

const app = express();
const PORT = 3000;

const logRequest = (req, res, next) => {
    console.log(`${req.method} ${req.url}`);
    next(); // 다음 미들웨어로 이동
};

app.use(logRequest);

app.get('/', (req, res) => {
    res.send('홈페이지');
});

app.listen(PORT, () => {
    console.log(`서버가 http://localhost:${PORT} 에서 시작되었습니다.`);
});

위 예제에서 logRequest 미들웨어는 모든 요청에 대해 요청 메서드와 URL을 로그로 출력합니다. next() 호출 없이 미들웨어가 종료된다면, 이후의 미들웨어나 라우터가 실행되지 않으므로, 항상 next()를 호출해 주어야 합니다.

6. 에러 처리 미들웨어

Express에서는 에러 처리를 위한 특별한 미들웨어를 제공합니다. 에러 처리 미들웨어는 항상 네 개의 인자를 가집니다: (err, req, res, next). 예를 들어, 다음은 기본적인 에러 처리 미들웨어의 예입니다.

const express = require('express');

const app = express();
const PORT = 3000;

app.get('/', (req, res) => {
    throw new Error('에러 발생!'); // 강제로 오류 발생
});

// 에러 처리 미들웨어
app.use((err, req, res, next) => {
    console.error(err.stack);
    res.status(500).send('무언가 잘못되었습니다!');
});

app.listen(PORT, () => {
    console.log(`서버가 http://localhost:${PORT} 에서 시작되었습니다.`);
});

위 예제에서는 / 경로에서 의도적으로 오류를 발생시켜, 이후에 정의된 에러 처리 미들웨어가 호출되도록 하였습니다. 에러 처리 미들웨어는 콘솔에 오류 스택을 출력하고, 클라이언트에게 500 상태 코드를 응답으로 돌려줍니다.

7. 마치며

이번 강좌에서는 Express의 기본 미들웨어 사용법에 대해 알아보았습니다. body-parser와 cookie-parser를 통해 요청 본문 및 쿠키를 처리하는 방법을 배웠으며, 미들웨어 체이닝 및 에러 처리 미들웨어의 중요성도 확인하였습니다. Express 미들웨어는 웹 애플리케이션의 요청 처리에서 매우 중요한 역할을 하므로, 제대로 이해하고 활용하는 것이 중요합니다.

더 나아가, 자신만의 미들웨어를 만들어보거나, 다양한 미들웨어를 활용하여 Express 애플리케이션을 확장해 나가길 추천합니다. 감사합나다!

Express 개발 강좌, 기본 Express 서버 설정 및 실행

Express.js는 Node.js를 위한 빠르고 불어친 웹 애플리케이션 프레임워크로서, 웹 서버의 기본 구조를 쉽게 구축할 수 있도록 도와줍니다. 이 강좌에서는 Express 서버를 설정하고 실행하는 방법에 대해 상세히 설명하겠습니다.

1. Express.js란?

Express.js는 대규모 애플리케이션 구축을 위한 유연하고 모듈화된 웹 프레임워크입니다. RESTful API, 웹사이트 및 기타 서버측 응용 프로그램을 구축하는 데 적합합니다. Express는 미들웨어(layer)를 이용해 요청(request)과 응답(response)을 처리할 수 있으며, 라우팅(라우트 설정), 오류 처리, 요청 본문(movie) 분석 등을 효율적으로 수행할 수 있습니다.

2. 개발 환경 설정

Express 서버를 설정하기 위해서는 Node.js와 npm(Node Package Manager)이 필요합니다. 아래는 개발 환경 설정을 위한 단계를 소개합니다.

2.1 Node.js 설치

Node.js는 Express의 기반이 되는 JavaScript 런타임입니다. Node.js를 설치하려면 다음 링크를 방문해 운영 체제에 맞는 설치 파일을 다운로드하고 설치하세요: Node.js 공식 사이트.

2.2 npm 확인 및 설치

Node.js를 설치하면 npm도 같이 설치됩니다. 터미널 또는 명령 프롬프트를 열고 다음 명령어를 입력하여 npm이 정상적으로 설치되었는지 확인합니다.

node -v
npm -v

3. Express 프로젝트 생성

이제 Express 프로젝트를 생성해 보겠습니다. 프로젝트 디렉토리를 만들고, 그 디렉토리로 이동합니다.

mkdir express-server-example
cd express-server-example

3.1 npm 초기화

다음으로 npm init 명령어를 입력하여 프로젝트의 package.json 파일을 생성합니다. 이 과정에서 프로젝트에 대한 정보들을 입력하게 됩니다. 필요한 내용을 입력한 후, 생성된 package.json 파일은 프로젝트의 메타데이터를 포함합니다.

npm init -y

3.2 Express 설치

이제 Express 패키지를 설치합니다. 다음 명령어를 실행하여 Express를 설치합니다.

npm install express

4. 기본 Express 서버 설정

Express가 설치되었으니, 이제 기본적인 서버를 설정해 보겠습니다. 프로젝트 디렉토리 내에 app.js라는 파일을 생성합니다.

touch app.js

4.1 Express 서버 구성

app.js 파일을 열고 아래와 같은 기본 코드를 작성합니다:

const express = require('express');
const app = express();
const PORT = process.env.PORT || 3000;

// 기본 경로 설정
app.get('/', (req, res) => {
    res.send('안녕하세요, Express 서버가 실행 중입니다!');
});

// 서버 실행
app.listen(PORT, () => {
    console.log(`서버가 http://localhost:${PORT}에서 실행 중입니다.`);
});

4.2 코드 설명

  • require('express'): Express 모듈을 불러옵니다.
  • const app = express(): Express 인스턴스를 생성합니다.
  • app.get('/', ...): 클라이언트의 GET 요청을 처리하여 기본 경로에 대한 응답을 설정합니다.
  • app.listen(PORT, ...): 서버가 지정된 포트에서 실행되도록 설정합니다.

5. 서버 실행

이제 서버를 실행해 볼까요? 터미널에서 다음 명령어를 실행합니다:

node app.js

서버가 정상적으로 실행되면, 아래와 같은 메시지가 표시됩니다:

서버가 http://localhost:3000에서 실행 중입니다.

6. 서버 테스트

웹 브라우저를 열고 http://localhost:3000에 접속해 보세요. “안녕하세요, Express 서버가 실행 중입니다!”라는 메시지가 표시되는 것을 확인할 수 있습니다.

7. 다양한 라우팅 처리

Express는 GET, POST, PUT, DELETE 등 다양한 HTTP 요청을 처리할 수 있습니다. 아래는 여러 가지 라우팅 처리 예시입니다.

7.1 다양한 HTTP 메서드 예제

app.post('/submit', (req, res) => {
    res.send('폼 제출이 완료되었습니다!');
});

app.put('/update', (req, res) => {
    res.send('데이터가 업데이트되었습니다!');
});

app.delete('/delete', (req, res) => {
    res.send('데이터가 삭제되었습니다!');
});

7.2 라우팅 그룹화

Express는 라우트를 그룹화하는 것도 지원합니다. 다음은 그룹화된 라우트 예제입니다:

const userRouter = express.Router();

userRouter.get('/', (req, res) => {
    res.send('사용자 목록');
});

userRouter.get('/:id', (req, res) => {
    res.send(`사용자 ID: ${req.params.id}`);
});

app.use('/users', userRouter);

8. 미들웨어 활용

Express에서는 미들웨어를 통해 요청과 응답을 처리하는 로직을 추가할 수 있습니다. 다음은 요청 본문을 JSON 형식으로 파싱하는 미들웨어를 추가하는 방법입니다:

app.use(express.json());

9. 에러 처리

Express는 오류 처리를 위한 미들웨어를 제공하며, 다음과 같이 설정할 수 있습니다:

app.use((err, req, res, next) => {
    console.error(err.stack);
    res.status(500).send('서버 오류!');
});

10. 결론

이 강좌를 통해 Express 서버를 설정하고 실행하는 기본적인 방법에 대해 알아보았습니다. Express는 쉽고 직관적인 API를 제공하여 빠르게 웹 애플리케이션을 개발할 수 있도록 도와줍니다. 다양한 기능을 활용하여 복잡한 애플리케이션도 손쉽게 구축할 수 있습니다. 앞으로는 데이터베이스 연결, 사용자 인증, 프론트엔드와의 연동 등 더 많은 기술을 배우고 활용해 보겠습니다.

이제 여러분도 Express를 사용하여 기본 웹 서버를 구현할 수 있습니다. 궁금한 점이나 피드백이 있다면 댓글로 남겨주세요!