Express.js의 Middleware

Middleware란?

미들웨어는 Express.js 동작의 핵심! 

HTTP 요청과 응답 사이에서 단계별 동작을 수행해주는 함수이다.

 

Middleware 동작 원리

Express.js의 미들웨어는 HTTP 요청이 들어온 순간부터 시작된다.

미들웨어는 HTTP 요청과 응답 객체를 처리하거나, 다음 미들웨어를 실행할 수 있다.

HTTP 응답이 마무리될 때까지 미들웨어 동작 사이클이 실행된다.

📌 미들웨어는

• 어떠한 코드도 실행 가능하다.
• request, response 객체 수정이 가능하다.
• request-response 사이클을 끝낼 수 있다.
• 다음 미들웨를 호출할 수 있다.

 

Middleware의 작성과 사용

req, res, next를 가진 함수를 작성하면 해당 함수는 미들웨어로 동작할 수 있다.

 

Route Handler도 미들웨어의 한 종류이다.

Route Handler는 라우팅 함수(get, post, put, delete 등)에 적용된 미들웨어이다.

일반적인 미들웨어와는 다르게 path parameter를 사용할 수 있다.

 

작성

const auth = (req, res, next) => {
  if (!isAdmin(req)) {
    next(new Error("Not Authorized"));
    return;
  }
  next();
}

req, res, next를 인자로 갖는 함수를 작성한다.

req, res 객체를 통해 HTTP 요청과 응답을 처리하거나 next 함수를 통해 다음 미들웨어를 호출해야 한다.

만약 next() 함수가 호출되지 않으면 미들웨어 사이클이 멈춘다.

 

사용

미들웨어는 적용되는 위치에 따라서 애플리케이션 미들웨어, 라우터 미들웨어, 오류처리 미들웨어로 분류할 수 있다.

필요한 동작 방식에 따라 미들웨어를 적용할 위치를 결정한다.

 

✔️ 애플리케이션 미들웨어

use나 http method를 사용하여 미들웨어에 연결할 수 있다.

미들웨어를 모든 요청에 공통적으로 적용하기 위한 방법이다.

HTTP 요청이 들어온 순간부터 적용된 순서대로 동작한다.

 

✔️ 라우터 미들웨어

router 객체에 미들웨어가 적용되는 것 외에는 애플리케이션 미들웨어와 사용 방법은 동일하다.

특정 경로의 라우팅에만 미들웨어를 적용하기 위한 방법이다.

app 객체에 라우터가 적용된 이후로 순서대로 동작한다.

미들웨어 서브 스택

use 나 http method 함수에 여러 개의 미들웨어를 동시에 적용할 수 있다.

주로 한 개의 경로에 특정해서 미들웨어를 적용하기 위해 사용한다.

전달된 인자의 순서대로 동작한다.

app.use(middleware1, middleware2, ...);

app.use('/admin', auth, adminRouter);

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

 

✔️ 오류처리 미들웨어

Express에서 요청을 받아 미들웨어나 라우터 핸들러에서 작업을 수행할 때 에러가 발생할 경우 해당 에러를 잡아서 처리해주는 함수이다. 일반적으로 가장 마지막에 위치한다.

다른 미들웨어와는 달리 err, req, res, next 네 가지 인자를 가지고, 앞선 미들웨어에서 next 함수에 인자가 전달되면 실행된다.

이전에 적용된 미들웨어 중 next에 인자를 넘기는 경우 중간 미들웨어들은 뛰어넘고 오류처리 미들웨어가 실행된다.

 

💡 만약 미들웨어 함수가 동기 함수라면 throw 문법으로도 오류처리 미들웨어로 error를 넘길 수 있다. 비동기는 try-catch로 error를 잡아서 next(error)로 전달해야 한다.

 

 

함수형 middleware

하나의 미들웨어를 작성하고, 작동 모드를 선택하면서 사용하고 싶을 경우 미들웨어를 함수형으로 작성하여 사용할 수 있다.

const auth = (memberType) => {
  return (req, res, next) => {
    if (!checkMember(req, memberType)) {
      next(new Error(`member not ${memberType}`));
      return;
    }
    next();
  }
}

app.use('/admin', auth('admin'), adminRouter);

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

auth 함수는 미들웨어 함수를 반환하는 함수이다.

 auth 함수 실행 시 미들웨어의 동작이 결정되는 방식으로 작성된다.

 

일반적으로 동일한 로직에 설정값만 다르게 미들웨어를 사용하고 싶을 경우에 활용된다.