Nodejs Middleware

Node.js Middleware 알아보기

👉Middleware란?

미들웨어란 요청(req), 응답(res)의 사이에서 목적에 맞게 구현한 함수를 실행하게 되는 거쳐가는 함수라는 의미이다.
docs에서는 미들웨어를 다음과 같이 정의하고 있다.

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.

쉽게 이해하기 위해 예를 들면 클라이언트의 요청이 들어오면 console을 찍는 함수를 미들웨어로 구현한다고 생각을 해보자
요청이 들어오고 서버는 콘솔을 찍은 후 요청에대한 응답을 다시 클라이언트로 보내줄 것이다. 이것이 중간에서 실행되는 함수 즉 미들웨어의 개념이라고 생각하면 쉽다.

---

👉Middleware 사용법

기본적으로 미들웨어는 app.use와 함께 사용한다고 docs에서는 알려주고 있다. 모든 요청에서 콘솔을 찍는 미들웨어를 작성하여 요청과 응답의 중간에서 실행시켜보자.

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

app.use((req, res, next) => {
  console.log('요청의 중간에서 실행되었습니다.');
  next();
})

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

app.listen(port, () => {
  console.log(`Example app listening at http://localhost:${port}`)
})

console을 기록하는 미들웨어를 작성해주었다. app.use는 모든 요청에서 실행하겠다는 의미이다. 이제 3000포트로 접속시 로그가 남는지 확인을 해보자.

서버에 접속 후 터미널을 확인해보았다.

작성한 로그가 잘 찍힌것을 확인할 수 있다.👍

---

👉next메서드

미들웨어에서는 함수를 살행 후 다음 미들웨어를 실행하기 위해서 next메서드를 필수적으로 호출해야 한다. 이유는 next를 호출하지 않는다면 다음 미들웨어로 넘어가지 않기 때문인데 아까 만들었던 미들웨어에 next를 호출하지 않고 다시 실행을 해보도록 하겠다.

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

app.use((req, res, next) => {
  console.log('요청의 중간에서 실행되었습니다.');
  // next 호출 안함
})

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

app.listen(port, () => {
  console.log(`Example app listening at http://localhost:${port}`)
})

3000포트로 접속을 하면 “Hello World”라는 문구가 화면에 보여져야 하지만 화면이 넘어가지 않는다.

하지만 콘솔을 남기는 미들웨어는 그대로 실행이 된것을 볼 수 있다. 이처럼 미들웨어는 다음미들웨어로 넘어가기 위해서 next 메서드를 필수적으로 호출을 해줘야한다.

---

👉함수로 구현하기

app.use를 활용하여 모든 라우터에서 미들웨어를 실행할 수 있지만 특정 라우터에서만 실행 하고자 하는 미들웨어가 있을 수 있다. 이럴때는 함수로 만들어서 중간에 넣어주는 방법도 있다.
예시를 위해 로그를 남기는 미들웨어를 특정 라우터에서만 실행해보도록 하겠다.

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

const middleware = (req, res, next) => {
  console.log('/mypage 에서만 실행됩니다.');
  next();
}

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

app.get('/mypage', middleware ,(req, res) => {
  res.send('My Page!!');
})

app.listen(port, () => {
  console.log(`Example app listening at http://localhost:${port}`)
})

middleware라는 함수를 만들고 “/mypage”라는 라우터의 중간에 넣어주었다. 이제 로그를 남기는 함수는 “/mypage” 요청의 중간에서 실행 될 것이다.

아무런 로그가 기록되지 않는다. “/mypage”로 요청을 보내보자.

로그를 기록하는 미들웨어가 정상적으로 작동을 했다. 이런식으로 특정 라우터에서만 실행하고자 하는 미들웨어도 작성이 가능하다.

---

👉Middleware가 실행되는 경우

미들웨어가 실행되는 경우
app.use(미들웨어)	모든요청에서 미들웨어 실행
app.use(‘/abc’, 미들웨어)	abc로 시작하는 요청에서 미들웨어 실행
app.post(‘/abc’, 미들웨어)	abc로 시작하는 POST 요청에서 미들웨어 실행
app.get(‘/def’, 미들웨어)	def로 시작하는 GET 요청에서 미들웨어 실행

---