[ Node.js 입문주차2 (2-0)] Express 미들웨어

 

Express 미들웨어

 

Express에서 미들웨어는 애플리케이션의 기능을 확장하기 위해 사용됩니다. 예를 들면, 로깅, 인증, 세션 관리, 오류 처리 등의 기능을 구현할 수 있습니다. 구성하는 특정 기능 스타일 원하는 코드를 실행할 있지만 대게는 들어오는 요청 처리, 응답 전송 및 오류 처리를 담당한다. 

 

Express 공식 홈페이지에서 확인 가능한 미들웨어의 유형

Application-level middleware

Router-level middleware

Error-handling middleware

Built-in middleware

Third-party middleware

 

미들웨어는 유연하다. Express에게 서로 다른 경로에 대해 동일한 미들웨어 기능을 실행하도록 지시하여 서로 다른 API 엔드포인트에서 공통 검사를 수행하는 등의 작업을 수행할 수 있다.

자신만의 미들웨어 기능을 작성하는 것 외에도 타사 미들웨어를 설치하여 애플리케이션에서 사용할 수도 있습니다. Express 문서에는 자주 사용이되는 모듈들이 나열되어 있다.

 

---

 

익스프레스 공식 홈페이지(https://expressjs.com/)

Express - Node.js web application framework

 

익스프레스 공식 홈페이지 접속 > Guide > Using middleware > Third-party middleware 항목 타사 미들웨어에 대한 정보를 살펴 볼 수 있다.

---

 

YOUTUBE -생활코딩 [ 미들웨어의 실행순서 ]

상단의 생활코딩 YOUTUBE를 참고하여 공부한 내용을 아래에 몇 가지 참고하여 추가로 더 기재해 보았다.

 

Application-level middleware (가장 많이 사용되는 Type) 

- app이라는 변수는  Application이라는 객체가 담겨있는데 객체에 get, use, post 방식을 통해 미들웨어를 등록할 수 있다. 

이러한 방법을 Application-level middleware 라고 한다.

 

미들웨어 함수는 app.use() 또는 app.METHOD() 메소드를 사용하여 등록

app.use() 메소드를 사용하면 모든 HTTP 요청에서 미들웨어 함수가 실행

app.METHOD() 메소드를 사용하면 특정 HTTP 요청에서만 미들웨어 함수가 실행

예를 들면, app.get() 메서드를 사용하면 GET 요청에서만 미들웨어 함수가 실행

미들웨어 함수는 다음과 같은 인수를 가질 수 있다.

req: HTTP 요청 객체
res: HTTP 응답 객체
next: 다음 미들웨어 함수로 제어를 전달하는 함수

 

미들웨어 함수는 다음 미들웨어 함수로 제어를 전달하기 위해 next() 함수를 호출해야 한다.

그렇지 않으면 클라이언트에게 응답이 전송되지 않는다.

 

---

Application-level middleware  몇 가지 사용법을 알아보자!

 

1) 경로가 없는 미들웨어 기능을 보여준다. 이 함수는 앱이 요청을 받을 때마다 실행된다.

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

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

2)  app.use 에 (/user/:id) 경로를 주는 것을 통해, 특정경로에만 미들웨어만 동작되게 할 수 있다.

app.use('/user/:id', (req, res, next) => {
  console.log('Request Type:', req.method)
  next()
})

3. get을 통해서 메서드가 get방식일때만 동작하도록 할 수 있다.

app.get('/user/:id', (req, res, next) => {
  res.send('USER')
})

 

4. 인자로 함수를 연속적으로 주는 것을 통해 미들웨어를 여러 개 사용할 수 있다.

 함수가 처음에 실행이 되고, 함수 안에서 next를 호출하면 순서대로 실행이 가능하다.

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

5. 조건문을 통해서 다음 미들웨어 실행을 시킬지 지정이 가능하다.

만약,  req.params.id 값이 '0'이라면, next('route')를 실행해야 한다. 즉 다음 route를 실행해야 하므로 res.send('special')을 실행시킨다. 만약 '0'이 아니라면, next()가 실행되며 next의 값이 실행된다.

app.get('/user/:id', (req, res, next) => {
  // if the user ID is 0, skip to the next route
  if (req.params.id === '0') next('route')
  // otherwise pass the control to the next middleware function in this stack
  else next()
}, (req, res, next) => {
  // send a regular response
  res.send('regular')
})

// handler for the /user/:id path, which sends a special response
app.get('/user/:id', (req, res, next) => {
  res.send('special')
})

 

---

 

참고하면 좋을 사이트 : 

https://simonplend.com/how-does-middleware-work-in-express/

How does middleware work in Express?