node.js express 5. middleware란? 미들웨어 정의, 미들웨어 유형

이전 포스트 : http://psyhm.tistory.com/7?category=654716

저번 포스트에서는 route paths와 parameters에 대해 조금 더 살펴보았다.

이번엔 대망의 middleware에 대해서 살펴 보도록 하겠다.

Middleware

docs를 보면 middleware에 대한 설명이 나와있다.

"Middleware functions are functions that have access to the request object (req), the response object (res), and the next function in the application’s request-response cycle."

미들웨어 함수는 req(요청) 객체, res(응답) 객체, 그리고 어플리케이션 요청-응답 사이클 도중 그 다음의 미들웨어 함수에 대한 엑세스 권한을 갖는 함수이다.

미들웨어란 간단하게 말하면 클라이언트에게 요청이 오고 그 요청을 보내기 위해 응답하려는 중간(미들)에 목적에 맞게 처리를 하는, 말하자면 거쳐가는 함수들이라고 보면 되겠다.

예를 들어서 요청-응답 도중에 시간을 콘솔 창에 남기고 싶으면 미들웨어 함수를 중간에 넣어서 표시를 한 뒤에 계속해서 다음 미들웨어들을 처리할 수 있도록 하는 것이다.

다음 미들웨어 함수에 대한 엑세스는 next 함수를 이용해서 다음 미들웨어로 현재 요청을 넘길 수 있다.

next라는 말에서 알 수 있듯이 next를 통해 미들웨어는 순차적으로 처리된다. (따라서 순서가 중요하다!!)

다음 예시에 미들웨어 함수 호출의 요소가 표시되어 있다.

HTTP 메서드

미들웨어가 작동할 path

미들웨어 함수

다음 미들웨어로의 액세스 함수

HTTP response 객체

HTTP request 객체

1차때 만들었던 프로젝트의 app.js 파일을 보자.

app.use 안에 있는 모든 함수들은 모두 미들웨어이며 요청이 올때마다 이 미들웨어를 거치며 클라이언트에게 응답하게 된다.

이 미들웨어들을 어떨 때 사용하면 편리하냐면 페이지를 렌더링할 때 사용자 인증을 앞서 거친 후에 렌더링하고 싶을 때 사용자 인증 미들웨어를 작성하고 앞에 삽입하게 되면 편리하다.

혹은 로그를 먼저 남기고 싶을때도 로그를 남기는 미들웨어를 작성하고 앞서 삽입하면 편리하다.

미들웨어의 특징을 간략히 정리하자면 다음과 같다.

• 모든 코드를 실행
• 다음 미들웨어 호출(미들웨어가 순차적으로 실행)
• res, req 객체 변경 가능
• 요청-응답 주기를 종료(response methods를 이용)

다음 미들웨어를 호출한다는 의미는 다음 코드를 보면 알 수 있다.

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

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

app.use(myLogger);

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

app.listen(3000);

클라이언트가 루트 경로(ex. http:/localhost:3000/)로 요청을 보냈을 때

 myLogger를 먼저 거치고 myLogger는 다음 미들웨어 호출(next())함수를 지정하여 res.send("Hello World"); 코드가 담긴 미들웨어로 넘어가게 된다는 의미이다.

res, req 객체 변경 가능이라는 의미는 다음 코드를 보면 알 수 있다.

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

var requestTime = function (req, res, next) {
  req.requestTime = Date.now();
  next();
};

app.use(requestTime);

app.get('/', function (req, res) {
  var responseText = 'Hello World!';
  responseText += 'Requested at: ' + req.requestTime + '';
  res.send(responseText);
});

app.listen(3000);

requestTime 미들웨어는 req 객체 안에 requestTime라는 프로퍼티를 만들었고 다음 미들웨어에서 프로퍼티 값을 가져올 수 있다.

요청-응답 주기를 종료(res methods)한다는 의미는 앞서 배웠던 response의 method를 이용하여 클라이언트에게 응답을 전송한다는 의미이다. (응답 전송시 종료)

위의 코드는 res.send(responseText);가 주기를 종료한다는 의미이다.

Middleware 유형

express는 다음과 같은 middleware 유형이 존재한다.

• 어플리케이션 레벨 미들웨어
• 라우터 레벨 미들웨어
• 오류 처리 미들웨어
• 써드파티 미들웨어

1) 어플리케이션 레벨 미들웨어

app.use() 및 app.METHOD() 함수(*method: get, post 등등)를 이용해 app 오브젝트의 인스턴스에 바인드 시킨다.

미들웨어를 어플리케이션 영역에서 지정한 path대로 처리 가능하게 하도록 한다.

var app = express();

app.use(function (req, res, next) {
  console.log('Time:', Date.now());
  next();
});

다음과 같이 특정 경로나 http methods 에 대해서만 적용할 수도 있다.

이 함수들은 /user/:id 경로에 대해 미들웨어들이 실행된다.

// 모든 /user/:id 요청에 대해 작동
app.use('/user/:id', function (req, res, next) {
  console.log('Request Type:', req.method);
  next();
});

// /user/:id인 GET 요청에 대해서만 응답
app.get('/user/:id', function (req, res, next) {
  res.send('USER');
});

다음은 하나의 경로를 통해 일련의 미들웨어 함수를 하나의 마운트 위치에 로드하는 예가 표시되어있습니다. 위의 미들웨어가 먼저 실행 된 뒤에 다음, 미들웨어가 이어 받습니다.

app.use('/user/:id', function(req, res, next) {
  console.log('Request URL:', req.originalUrl);
  next();
}, function (req, res, next) {
  console.log('Request Type:', req.method);
  next();
});

2) 라우터 레벨 미들웨어

라우터 레벨 미들웨어는 express.Router() 인스턴스에 바인드된다는 점을 제외하면 어플리케이션 레벨 미들웨어와 동일한 방식으로 작동한다.

Router객체를 이용해 router.use() 및 router.METHOD() 함수를 사용하여 라우터 레벨 미들웨어를 로드할 수 있다.

Router 객체는 그 자체가 미들웨어처럼 움직이므로 app.use()의 인수(argument)로 사용될 수 있고 또한 다른 router의 use() 메서드에서 사용될 수 있다.

var router = express.Router()로 Router 객체를 생성한 뒤에 app.use()를 사용해 마운트 시켜야지만 사용가능하다.

app.use()에서 지정한 경로와 같은 것이 들어온다면 모두 적용시켜버리기 때문에 중복이 될 가능성이 있다. 

예를 들어 app.use('/apple', ...) 이 있다면 /apple, /apple/images, /apple/images/news 등에 모두 적용시켜 버린다

router를 사용하는 이유는 특정 root url을 기점으로 기능이나 로직별로 라우팅을 나눠서 관리할 수 있다는 점이다.

user 라우터에는 다른 라우터에는 필요없는 인증 미들웨어를 따로 추가하는 등의 작업을 할 수 있다.

3) 에러 핸들링 미들웨어

에러 핸들링을 하는 미들웨어는 4개의 인자를 사용해서 정의하도록 한다. (err, req, res, next)

단순히 에러 핸들링 미들웨어는 에러를 다루기 위한 미들웨어이다.

다음 포스팅때 좀 더 다루기로 한다.

4) 서드 파티 미들웨어

기능적으로 express app에 미들웨어를 추가하기 위해 서드 파티 미들웨어 사용을 권고한다. 

Node.js 모듈을 사용하고 싶다면 application 레벨이든 router 레벨이든 로드해서 사용하면 된다.

npm에서 install 가능하다.

다음 포스팅에서는 에러 핸들링에 대해서 간단히 보도록 하겠다.