Router와 Middleware / Postman

❓Routing

🌱
특정 endpoin에 대한 요청에 애플리케이션이 대답하는 방식을 결정하는 것
→ 각 endpoin에 대해 적절한 동작을 수행하여 적절한 응답을 전달

✔️ endpoint = HTTP method + URI

🌱
POST /api/users: HTTP method( 행위 ) + URI( 자원 )

✔️ App routing

• Express 애플리케이션 객체를 직접 사용하는 방식
• get, post, put, delete, all…

✔️ Router level routing

• Express의 Router 함수 사용
• 라우터 객체를 사용하여 라우팅 코드를 분리
  • const usersRouter = Router();
• app 객체의 use 메서드를 사용하여 애플리케이션에 해당 라우터 연결
  

// app.js
app.use('/api/users', usersRouter);

• 첫 번째 인수: 해당 라우터의 기본 경로 전달( 기본 경로 제외하고 작성 )
  

// routes/usersRouter.js
usersRouter.put('/:id', (req, res) => {res.send('edit user')});

• grouping: 관련된 라우트를 하나의 라우터 객체로 묶어 관리, 코드 분리

---

❓ Postman

🌱 GET 요청 이외의 다른 API 도 테스트 가능하도록 함 !

✔️ Path Parameter

🌱 /api/users/:id → :parameter

GET /api/users/:id 

• 동적 라우팅: URI 경로에 매개변수를 집어 넣기
• 조회: req 객체의 params 프로퍼티에서 해당 값 조회 가능
  • const { id } = req.params

✔️ Query String

🌱

/api/users?page=2&size=5 → page: 2, size: 5

GET /api/users?page=2&size=5

• Query String 사용: ? 로 시작하고 각 값은 & 로 연결
  • key = value 형태
  • const { page, size } = req.query

---

❓ Request Handler

🌱 요청을 처리하는 콜백 함수

• req 객체에 포함된 정보를 활용하여 작업 수행
• res 객체를 활용하여 응답의 형태 결정
• res 객체의 메서드( ex. send, render, redirect )를 활용해 최종 응답 보냄

✔️ req

• req.params: Path Parameter에 접근할 수 있는 프로퍼티
• req.queries: Query String에 접근할 수 있는 프로퍼티
• req.body: POST, PUT 요청에 Body에 접근할 수 있는 프로퍼티
• req.get(): 요청의 HTTP Header 값을 조회할 수 있는 프로퍼티
  

/api/users/:id  // -> Path Parmeter: req.params.id
/api/posts?page=2&size=10 // -> req.queries: req.query.page, req.query.size
/req.get('Authorization') // -> req.get()

✔️ res

• res.send(): text 형식의 HTTP 응답 전송
• res.json(): JSON 형식의 HTTP 응답 전송
• res.render(): HTML Template을 사용하여 화면을 전송
• res.set(): 응답의 HTTP Header를 전송
• res.status(): 응답의 HTTP Status Code를 설정
  

res.stauts(404).send('User not found');

---

❓ Middleware( ≑ intercepter )

🌱 요청 → 응답의 과정 사이에서 특정 작업을 수행하는 기능, chaining 형태

• use 메서드를 사용해 미들웨어 연결
  • 미들웨어에서 수행할 작업이 정의된 콜백함수를 인수로 전달
  • app 객체가 아닌 라우터에 연결하여, 특정 라우터에서만 거치는 작업을 정의 가능
    • 라우터를 이용한 그룹화의 장점 !
  • 여러 개의 미들웨어를 동시에 연결 가능
    • 전달된 인수의 순서대로 동작
• ( err, req, res, next )

  app.use((req, res, next) => {
  	req.newProperty = 'Hello World';
  	next();
  });

  • req, res
  • next: 다음 미들웨어로 넘어가기
    • 호출하지 않으면 요청-응답 주기가 종료됨
    • 의도적으로 에러 발생시키기( 유효성 검사, 권한 제어 등 )
      • next 함수의 인수로 Error 객체 전달

        app.use((req, res, next) => {
        	if(!isAdmin(req)) {
        		next(new Error('Not Authorized'));
        		return;
        	}
        	next();
        });

  • err: 4개의 매개변수를 선언하면, 에러 처리 미들웨어로 인식
    • 앞선 미들웨어에서 에러가 발생하는 경우 실행
    • 첫 번째 인수, 에러에 대한 정보가 담긴 err 객체 전달

✔️ Express: 내장 미들웨어

• express.static()
  • 정적 파일을 사용할 수 있게 해주는 미들웨어
  • 정적 파일이 저장될 폴더의 경로를 인수로 전달
    • 정적 파일: 고정된 콘텐츠: HTML, CSS, JavaScript, 이미지 파일 등
  • 기본 패키지 path를 import하고 join메서드를 사용하면 현재 프로젝트 기준 경로 문자열 생성

    import path from 'path';
    app.use(express.static(path.join(__dirname, 'public')));

• express.json()
  • 요청의 Body가 JSON 형태인 경우 기본적으로는 이를 자바스크립트 객체로 파싱하지 않음
    • express.json() 을 연결하여 JSON 형태의 Body를 자동으로 자바스크립트 객체로 파싱
• express.urlencoded()
  • 요청의 Body가 HTML Form인 경우 기본적으로는 이를 자바스크립트 객체로 파싱하지 않음
  • express.urlencoded() 을 연결하여 JSON 형태의 Body를 자동으로 자바스크립트 객체로 파싱

✔️ 미들웨어 라이브러리( express 내장 외 )

• morgan
  • npm i morgan
  • 로깅 라이브러리, 다양한 로그 형식 지원