미들웨어

Middleware

 

미들웨어는 Express.js 동작의 핵심이며 HTTP 요청과 응답 사이에서 단계별 동작을 수행해주는 함수이다.

 

Express.js의 미들웨어는 HTTP 요청이 들어온 순간부터 순차적으로 시작이 되며 HTTP 요청과 응답 객체를 처리하거나, 다음 미들웨어를 실행할 수 있다. HTTP 응답이 마무리될 때까지 미들웨어 동작 사이클이 실행된다.

 

 

 Route Handler

• Route Handler도 미들웨어의 한 종류이다. 라우팅 함수(get, post, put, delete 등)에 적용된 미들웨어이다.
• 일반적인 미들웨어와는 다르게 path parameter를 사용할 수 있다.

 

 

미들웨어의 작성법

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

• req : HTTP 요청을 처리하는 객체
• res : HTTP 응답을 처리하는 객체
• next : 다음 미들웨어를 실행하는 함수

const logger = (req, res, next) => {
  console.log(`Request ${req.path}`);
  next();
};
 
const auth = (req, res, next) => {
  if (!isAdmin(req)) {
    next(new Error("Not Authorized"));
    return;
  }
  next();
};

req, res, next를 인자로 갖는 함수를 작성하면 미들웨어가 되며 req, res 객체를 통해 HTTP 요청과 응답을 처리하거나 next 함수를 통해 다음 미들웨어를 호출해야 한다. next() 함수가 호출되지 않으면 미들웨어 사이클이 멈추기 때문에 주의해야 된다.미들웨어는 적용되는 위치에 따라서 애플리케이션 미들웨어, 라우터 미들웨어, 오류처리 미들웨어로 분류가 가능하며 필요한 동작 방식에 따라 미들웨어를 적용할 위치를 결정해야 된다.

 

 

 

애플리케이션 미들웨어

app.use((req, res, next) => {
  console.log(`Request ${req.path}`);
  next(); // 1
});
 
app.use(auth); // 2
 
app.get("/", (req, res, next) => {
  res.send("Hello Express"); // 3
});

• use나 http method 함수를 사용하여 미들웨어를 연결할 수 있다.
• 미들웨어를 모든 요청에 공통적으로 적용하기 위한 방법이다.
• http 요청이 들어온 순간부터 적용된 순서대로 동작한다.

 

라우터 미들웨어

router.use(auth); // 3
 
router.get("/", (req, res, next) => {
  res.send("Hello Router");
}); // 4
 
//-----------------------------------------
app.use((req, res, next) => {
  console.log(`Request ${req.path}`);
  next(); // 1
});
 
app.use("/admin", router); // 2

• router 객체에 미들웨어가 적용되는 것 외에는 애플리케이션 미들웨어와 사용 방법은 동일하다.
• 특정 경로의 라우팅에만 미들웨어를 적용하기 위한 방법이다.
• app 객체에 라우터가 적용된 이후로 순서대로 동작한다.

 

미들웨어 서브스택

app.use(middleware1, middlware2, ...);
 
app.use("/admin", auth, adminRouter);
 
app.get("/", logger, (req, res, next) => {
  res.send("Hello Express");
});

• 여러 개의 미들웨어를 동시에 적용할 수 있다.
• 주로 한 개의 경로에 특정해서 미들웨어를 적용하기 위해 사용한다.
• 전달된 인자의 순서 순으로 동작한다.

 

오류처리 미들웨어

app.use((req, res, next) => {
  if (!isAdmin(req)) {
    next(new Error("Not Authorized")); // 1 중간은 건너뛰고 마지막 오류처리 미들웨어로 실행된다.
    return;
  }
  next();
});
 
app.get("/", (req, res, next) => {
  res.send("Hello Express");
});
 
app.use((err, req, res, next) => { // 2, err 인자
  res.send("Error Occurred");
});

 

일반적으로 마지막에 위치하며 err, req, res, next 네 가지 인자를 가지며, 앞선 미들웨어에서 next 함수에 인자가 전달되면 실행된다.

• next(new Error());
• 가장 아래 적용된 err, req, res, next를 인자로 갖는 함수가 오류처리 미들웨어이다.
• 이전에 적용된 미들웨어 중 next에 인자를 넘기는 경우 중간 미들웨어들은 뛰어넘고 오류처리 미들웨어가 바로 실행된다.

 

함수형 미들웨어

• 하나의 미들웨어를 작성하고, 작동 모드를 선택하면서 사용하고 싶을 경우 미들웨어를 함수형으로 작성하여 사용할 수 있다.
• Ex) API별로 사용자의 권한을 다르게 제한하고 싶은 경우. 사용자 권한을 제한하는 미들웨어를 1개만 작성하고 사용자의 권한을 미들웨어의 인자로 넘기면서 체크할 수 있도록 작성할 수 있다.

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 함수 실행 시 미들웨어의 동작이 결정되는 방식이다.
• 일반적으로 동일한 로직에 설정값만 다르게 미들웨어를 사용하고 싶을 경우에 활용된다.