Express.js와 REST API

1. Express.js 의 Middleware

: HTTP 요청과 응답 사이에서 단계별 동작을 수행하는 함수

HTTP 요청이 들어오는 순간 시작. HTTP 응답이 마무리 될 때까지 미들웨어 동작 사이클이 실행 된다.

Middleware 는 Request, Response 객체를 처리하거나 다음 미들웨어를 실행한다.

 

2. Middleware 작성

① ( req, res, next ) 를 인자로 받으면 middleware 로 작동할 수 있다.

req : Reauest 객체를 받아 처리

res : Response 객체를 받아 처리

next : 다음 middleware를 실행

② next() 함수를 호출해야 미들웨어 사이클이 멈추지 않는다.

 

적용되는 위치에 따른 미들웨어 종류

1. 어플리케이션 미들웨어 : use 나 http method 함수에 미들웨어를 인자로 준다.

모든 요청에 공통적으로 적용한다.

http 요청이 들어온 순간부터, 적용된 순서대로 동작한다.

 

** 미들웨어 서브스택 : use, http method 함수에 여러개의 미들웨어를 동시에 적용

한개의 경로에 여러 미들웨어를 적용할 때 사용한다.

전달된 인자의 순서 순으로 동작한다.

 

2. 라우터 미들웨어 : router 객체에 미들웨어가 적용된다.

특정 경로의 라우팅에만 미들웨어를 적용한다.

app 객체에 라우터가 적용된 이후, 순서대로 동작한다.

 

3. 오류처리 미들웨어 : err, req, res, next 네가지 인자를 가진다.

일반적으로 가장 마지막에 위치한다.

앞선 미들웨어에서 next 함수에 인자가 전달되면, 다른 미들웨어를 건너뛰고 실행된다.

 

함수형 미들웨어 : 

미들웨어 하나로 인자나 작동모드, 설정 값에 따라 사용하고 싶을 때 사용한다.

 

** npm 으로 미들웨어를 추가하여 사용할 수 있다.

 

---

3. REST API url 작성법

① url 의 자원은 복수형으로 표현해야 한다.   ex) /posts

② 하나의 자원은 복수형 + 아이디로 접근한다.    ex) /posts/3

③ url 로 자원을 계층적으로 표현한다.     ex) /users/2/posts    2번 user의 게시글

 

4. JSON

: 웹 API는 기본적으로 데이터를 문자열로 전송하는데, 객체를 웹 API 를 통해서 문자열로 전달하기 위해서 사용.

 

5. Express.js 로 REST API 구현하기

** MVC 패턴 : 웹 서비스의 가장 대표적인 프로젝트 구성 패턴, 프로젝트의 기능들을 어떻게 분리할지에 대한 하나의 구성방법.

MVC = Model - View - Controller

① Model : 데이터, 데이터에 접근하는 기능

데이터의 읽기, 쓰기는 model 을 통해서만 이루어져야 한다.

② View : 데이터를 표현하는 기능

Controller 를 통해 데이터를 전달받고, 받은 데이터를 화면에 표시하는 기능을 한다.

③ Controller : Model을 통해 데이터에 접근하여, 처리결과를 View 로 전달하는 기능.

웹서비스에서 라우팅 함수가 주로 Controller 기능을 한다.

 

** express.js는 HTTP body의 JSON 데이터 처리하지 못한다.
-> express에서 기본 제공하는 express.json() 미들웨어를 사용해야 JSON 데이터를 사용할 수 있다.

app.use(express.json())

 

★ async request handler : request handler를 async function 으로 작성.

const asyncHandler = (requestHandler) => {
    return async (req, res, next) => {
        try{
            await requestHandler(req, res)
        } catch (err) {
            next(err)
        }
    }
}


//
router.get('/', asyncHandler(async (req,res) => {
    const posts = await Posts.find({})
    if (posts.length < 1) {
        thorw new Error('Not Found')
    }
    res.render('posts/list', {posts})
}))