[Node][Express] 내장 미들웨어 json() / urlencoded() / static()

Express에는 미리 만들어져 있는 내장 미들웨어들이 있습니다.

내장 미들웨어는 모든 경로에 대한 요청과 응답을 대상으로 실행되는 경우가 대부분이기 때문에,

경로를 생략하고 미들웨어를 인자로 넘겨줍니다.

express.json( )

요청의 ContentType 헤더 값이 application/json 이라면, 요청의 body에 담긴 json을 객체로 불러옵니다.

express.json( ) 없이는 요청의 body 값을 다른 미들웨어의 req.body 속성을 통해 불러올 수 없습니다.

때문에 다른 미들웨어들보다 먼저 실행되어야 합니다.

const app = express()

app.use(express.json()) // 다른 미들웨어보다 먼저 실행됩니다.

app.post('/endpoint', (req, res) => {
    // express.json()을 사용하지 않으면 req.body로 요청 body를 읽어올 수 없습니다.
    console.log(req.body)
    res.json({ message: 'post method called' })
})

POST http://localhost:3000/endpoint
Content-Type: application/json

{
    "name": "sample"
    "value": 10
}

express.urlencoded( )

요청의 ContentType 헤더 값이  applicaftion/x-www-form-urlencoded 이라면, 요청 body의 key-value를 불러옵니다.

express.urlencoded( ) 없이는 요청의 body 값을 다른 미들웨어의 req.body 속성을 통해 불러올 수 없습니다.

때문에 다른 미들웨어들보다 먼저 실행되어야 합니다.

※ extended 속성을 true로 할 경우, 더 많은 key-value 값들을 읽어올 수 있습니다.

const app = express()

app.use(express.urlencoded({ extended: true }) // 다른 미들웨어보다 먼저 실행됩니다.

app.post('/endpoint', (req, res) => {
    // express.urlencoded()을 사용하지 않으면 req.body로 요청 body를 읽어올 수 없습니다.
    console.log(req.body)
    res.json({ message: 'post method called' })
})

POST http://localhost:3000/endpoint
Content-Type: application/x-www-form-urlencoded

name=John&age=20

express.static( )

서버의 파일을 서버 외부로 제공합니다.

보내고자 하는 서버의 파일 경로를 인자로 넘겨주면, GET 등의 요청으로 해당 경로의 파일을 불러올 수 있습니다.

use에 특정 경로를 명시한다면, static을 통해 접근할 수 있는 경로를 임의로 설정할 수도 있습니다.

app.use('/files', express.static('public'))

이 경우 만약 public 폴더에 docs.html과 image.png 파일이 있다면,

static은 /files/docs.html과 /files/image.png를 엔드포인트로 하는 새로운 route를 생성합니다.

// 두 파일 모두 public 폴더 아래에 있다고 가정합니다.

GET http://localhost:3000/files/docs.html

GET http://localhost:3000/files/image.png