Unit10 - [Web Server] 기초_2

🔥 Refactor Express

Express : Node.js 환경에서 웹 서버, API 서버를 제작하기 위해 사용되는 프레임워크

• Express로 구현한 서버가 Node.js HTTP랑 다른 점
  - 미들웨어를 추가할 수 있다.
  - 라우터를 제공한다.

1. Express 시작하기

1) npm install express 명령으로 express를 설치한다.

2) 간단한 웹 서버 만들기

const express = require('express')
const app = express()
// 3000번 포트 연결
const port = 3000 

app.get('/', (req, res) => {
  res.send('Hi')
})

app.listen(port, () => {
  console.log(`Open port ${port}`)
})

3) 라우팅 : 메서드와 url에 따라 분기(Routing)하기

라우팅(Routing) : 특정 메서드와 url( /lower, /upper ... )로 분기점을 만드는 것

클라이언트는 특정한 HTTP 요청 메서드(GET, POST ...)와 함께 서버의 특정 URI(또는 경로)로 HTTP 요청을 보낸다. 라우팅은 클라리언트 요청에 해당하는 Endpoint에 따라 서버가 응답하는 방법을 결정하는 것이다.

const router = express.Router()

router.get('/lower', (req, res) => {
  res.send(data);
})

router.post('/lower', (rea, res) => {
  // ... 생략
})

=> Express는 프레임워크 자체에서 라우터 기능을 제공한다.

---

2. Middleware

미들웨어(Middleware) : 프로세스 중간에 관여하여 특정 역할을 수행한다.

- 미들웨어의 구성

아래 그림은 endpoint가 /이면서, 클라이언트로부터 GET 요청을 받았을 때 적용되는 미들웨어이다.

미들웨어 작성시 파라미터 순서에 유의해야 한다. (req, res, next)
req : 요청(request) , res : 응답(response) , next : 다음 미들웨어를 실행하는 역할

---

자주 사용하는 미들웨어
1) POST 요청 등에 포함된 body(payload)를 구조화할 때(쉽게 얻어내고자 할 때)
2) 모든 요청/응담에 CORS 헤더를 붙여야 할 때
3) 모든 요청에 대해 url이나 메서드를 확일할 때
4) 요청 헤더에 사용자 인증 정보가 담겨있는지 확인할 때

case 1: POST 요청 등에 포함된 body(payload)를 구조화할 때

Node.js로 HTTP body(payload)를 받을 때는 Buffer를 조합해서 body를 얻을 수 있다.
(네트워크 상의 chunk를 합치고, buffer를 문자열로 변환하는 작업이 필요하다.)

let body = [];
request.on('data', (chunk) => {
  body.push(chunk);
}).on('end', () => {
  body = Buffer.concat(body).toString();
});

=> body-parser 미들웨어를 사용하면 위 과정을 간단하게 처리할 수 있다.

const bodyParser = require('body-parser');
const jsonParser = bodyParser.json();

// ... 생략
app.post('/users', jsonParser, function (req, res) {
  
})

=> Express v4.16.0 부터는 body-parser를 따로 설치 x, Express 내장 미들웨어인 express.json() 사용

const jsonParser = express.json({strict: false});

// ... 생략
app.post('/api/users', jsonParser, function (req, res) {

})

• express.json([옵션])
  - express.json({strict: false})
  : 배열과 객체만 허용하는 것을 비활성화(false)한다. 비활성화되면 JSON.parse가 허용하는 모든 항목들을 수용한다.

case 2: 모든 요청/응답에 CORS 헤더를 붙일 때

Node.js HTTP 모듈을 이용한 코드에 CORS 헤더를 붙이려면, writeHead 메서드를 이용하여 라우팅마다 헤더를 매번 넣어주어야 하며, OPTIONS 메서드에 대한 라우팅도 따로 구현해야한다.
그러나 cors 미들웨어를 사용하면 이 과정을 간단하게 처리할 수 있다.

const cors = require('cors');

// ... 생략

// 모든 요청에 대해 CORS 허용
app.use(cors());

// 특정 요청에 대해 CORS 허용
app.get('/products/:id', cors(), function (req, res, next) {
  res.json({msg: 'This is CORS-enabled for a Single Route'})
})

case 3: 모든 요청에 대해 url이나 메서드를 확인할 때

로거(logger) : 디버깅이나, 서버 관리에 도움이 되기 위해 console.log로 적절한 데이터나 정보 출력

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

const myLogger = function (req, res, next) {
  console.log('Logged');
  next();
};

// 특정 endpoint가 아닌, 모든 요청에 동일한 미들웨어 적용하려면 app.use 사용
app.use(myLogger);

app.get('/', function (req, res) {
  res.send('Hi');
});

app.listen(3000);

case 4: 요청 헤더에 사용자 인증 정보가 담겨있는지 확인할 때

app.use((req, res, next) => {
  // 토큰이 있는지 확인, 없으면 받아줄 수 없다.
  if(req.headers.token) {
    req.isLoggedIn = true;
    next();
  } else {
    res.status(400).send('invalid user')
  }
})

위 코드는 HTTP 요청에서 토큰을 통해 로그인 여부를 확인하는 미들웨어 예시이다.