[Node.js] express (2) - Middleware 미들웨어 💯️

goal

미들웨어에 대한 자세한 설명은 👉️ 공식문서를 참고

미들웨어 💯️

• 다른 사람이 만든(= third party middleware) or 내가 만든 소프트웨어를 공유해서 쓰는 개념

• express 애플리케이션은 본질적으로 (여러개의?) 미들웨어 함수 호출이다.

• 미들웨어 함수 사용은
  npm install <미들웨어 name> --save를 하면 바로 사용할 수 있다.

• 미들웨어 함수는

  1. 요청오브젝트(req)
  2. 응답오브젝트(res)
  3. 애플리케이션의 요청-응답 cycle에서 그 다음의 미들웨어 함수에 대한 액세스 권한을 갖는 함수이다. (usually 변수명은 next로 표기한다.)

미들웨어가 하는 일 (task)

1. 모든 코드를 실행
2. 요청/응답 오브젝트에 대한 변경을 실행
3. 요청/응답 주기를 종료
4. 스택 내의 그 다음 미들웨어함수(next)를 호출
   • (현재의 미들웨어 함수가 요청-응답 주기를 종료하지 않는 경우에는 next()를 호출하여 그 다음 미들웨어 함수에 제어를 전달해야 한다. 그렇지 않으면 해당 요청은 정지된 채로 방치된다.)

다양한 유형의 미들웨어

1. 애플리케이션 레벨 ➡️ 선택적인 마운트 경로를 통해 로드
2. 라우터 레벨 ➡️ 선택적인 마운트 경로를 통해 로드
3. 오류 처리
4. 기본 제공
5. third party ➡️ third party 미들웨어는 여기를 참고 (매우 유용)

• 미들웨어의 로드 순서는 중요하며, 먼저 로드되는 미들웨어 함수가 먼저 실행된다.

---

미들웨어 작성과 예

// index.js

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

var myLogger = function (req, res, next) {
  console.log('LOGGED');
  next();
};
// 👇️
// myLogger는 미들웨어 함수
// -> 앱에 대한 요청이 해당 함수를 거쳐 전달될 때 단순히 “LOGGED”를 인쇄 (in terminal)

app.use(myLogger);
// 👇️
// 미들웨어 함수를 로드하려면 (미들웨어 함수를 지정하여) ⭐️app.use()를 호출⭐️해야 한다.
// 앱이 요청을 수신할 때마다, 앱은 “LOGGED”라는 메시지를 터미널에 인쇄한다.
// ⭐️미들웨어의 로드 순서는 중요하며, 먼저 로드되는 미들웨어 함수가 먼저 실행된다.⭐️
// 미들웨어 함수 myLogger는 단순히 메시지를 인쇄한 후 ⭐️next() 함수를 호출⭐️하여 스택 내의 그 다음 미들웨어 함수에 요청을 전달한다.

app.get('/', function (req, res) {
  res.send('Hello 222World!');
});
// if) app.use(myLogger); -> 여기에 위치한다면, 
// 👇️
// 루트 경로에 대한 라우팅 이후에 myLogger가 로드되면, 루트 경로의 라우트 핸들러가 요청-응답 주기를 종료하므로 요청은 절대로 myLogger에 도달하지 못하며 앱은 “LOGGED”를 인쇄하지 않는다.

app.listen(3000);

---

다양한 유형의 미들웨어

1. 애플리케이션 레벨 ➡️ 선택적인 마운트 경로를 통해 로드
2. 라우터 레벨 ➡️ 선택적인 마운트 경로를 통해 로드
3. 오류 처리
4. 기본 제공
5. third party

• 1번과 5번 먼저 알아보자

1. 애플리케이션 레벨

// 💕️ body-parser 미들웨어

app.use(bodyParser.urlencoded({ extended: false }))
// 👇️
// bodyParser.urlencoded({ extended: false })
// 이 코드는 실행되면서, 결과로 미들웨어가 들어오게 된다.
// 바디파서가 만드는 미들웨어를 표현하는 표현식
// main.js가 실행될 때마다 위의 코드가 실행된다.
// 내부적으로는, 사용자가 전송한 body부분을 바꿔준다.
  // let body = '';
  // req.on('data', (data) => body += data)

// 💕️ compression 파일의 크기를 압축해주는 미들웨어
app.use(compression())

-------------------------------------------------------

// 💕️ 나만의 미들웨어 만들기 💕️

app.use((req, res, next) => { //next에 , req/res 다음에 처리되어야 할 미들웨어가 담겨있다.
  fs.readdir("./data", (error, filelist) => {
    req.list = filelist
    next() // req/res 뒤에 next를 호출한다.
  })
})

// 👇️ 만들었던 미들웨어를 (*)모든 get요청일 때로 라우팅 
app.get("*", (req, res, next) => { //next에 , req/res 다음에 처리되어야 할 미들웨어가 담겨있다.
  fs.readdir("./data", (error, filelist) => {
    req.list = filelist
    next() // req/res 뒤에 next를 호출한다.
  })
})

--------------------------------------------------------

// 💕️ 미들웨어 사용법

app.use('/user/:id', function(req, res, next) {
  console.log('Request URL:', req.originalUrl);
  next(); // next를 호출하는 것은 👇️ 아래의 함수를 호출한 것과 같음
}, function (req, res, next) {
  console.log('Request Type:', req.method);
  next();
});

//! but! 

app.get('/user/:id', function (req, res, next) {
  console.log('ID:', req.params.id);
  next();
}, function (req, res, next) {
  res.send('User Info'); // 이렇게 send해버리면 다음 미들웨어👇️는 호출되지 않는다.
});

app.get('/user/:id', function (req, res, next) {
  res.end(req.params.id);
});

//! or~

app.get('/user/:id', function (req, res, next) {
  if (req.params.id == 0) next('route'); // 이런식으로 미들웨어를 if문으로 다시 실행여부를 결정할 수 있다.
  else next(); //
}, function (req, res, next) {
  res.render('regular');
});

app.get('/user/:id', function (req, res, next) {
  res.render('special');
});

---

출처 : 생활코딩 https://www.youtube.com/watch?v=LX4MHFRiMhk&list=PLuHgQVnccGMAGOQu8CBDO9hn-FXFmm4Wp&index=15 / express 공식문서 https://expressjs.com/ko/guide/using-middleware.html