REST API와 라우팅

REST API

서버에 요청을 보낼 때는 주소를 통해 요청의 내용을 표현

• /index.html이면 index.html을 보내달라는 뜻
• 항상 html을 요구할 필요는 없음
• 서버가 이해하기 쉬운 주소가 좋음

REST API(Representational State Transfer)

• 서버의 자원을 정의하고 자원에 대한 주소를 지정하는 방법
• /user이면 사용자 정보에 관한 정보를 요청하는 것
• /post면 게시글에 관련된 자원을 요청하는 것
• 단, 너무 예측가능할 경우 보안에 취약해 질 수 있음

HTTP 요청 메서드

• GET: 서버 자원을 가져오려고 할 때 사용
• POST: 서버에 자원을 새로 등록하고자 할 때 사용(또는 뭘 써야할 지 애매할 때)
• PUT: 서버의 자원을 요청에 들어있는 자원으로 치환하고자할 때 사용
• PATCH: 서버 자원의 일부만 수정하고자 할 때 사용
• DELETE: 서버의 자원을 삭제하고자할 때 사용

 

HTTP 프로토콜

 

클라이언트가 누구든 서버와 HTTP 프로토콜로 소통 가능

• iOS, 안드로이드, 웹이 모두 같은 주소로 요청 보낼 수 있음
• 서버와 클라이언트의 분리

 

 

 

RESTful

• REST API를 사용한 주소 체계를 이용하는 서버
• GET /user는 사용자를 조회하는 요청, POST /user는 사용자를 등록하는 요청

예시 코드

const http = require('http');
const fs = require('fs').promises;

const users = {}; // 데이터 저장용

// req -> 요청 res -> 응답
http.createServer(async (req, res) => {
  try {
    if (req.method === 'GET') {
      if (req.url === '/') {
        const data = await fs.readFile('./restFront.html');
        res.writeHead(200, { 'Content-Type': 'text/html; charset=utf-8' }); //성공적으로 응답
        return res.end(data);
      } else if (req.url === '/about') {
        const data = await fs.readFile('./about.html');
        res.writeHead(200, { 'Content-Type': 'text/html; charset=utf-8' });
        return res.end(data);
      } else if (req.url === '/users') {
        res.writeHead(200, { 'Content-Type': 'application/json; charset=utf-8' });
        return res.end(JSON.stringify(users));
      }
      // /도 /about도 /users도 아니면
      try {
        const data = await fs.readFile(`.${req.url}`);
        return res.end(data);
      } catch (err) {
        // 주소에 해당하는 라우트를 못 찾았다는 404 Not Found error 발생
      }
    } else if (req.method === 'POST') {	// post에서는 데이터가 넘어옴
      if (req.url === '/user') {
        let body = '';
        // 요청의 body를 stream 형식으로 받음
        req.on('data', (data) => {
          body += data;
        });
        // 요청의 body를 다 받은 후 실행됨
        return req.on('end', () => {
          console.log('POST 본문(Body):', body);
          const { name } = JSON.parse(body);
          const id = Date.now();
          users[id] = name;
          res.writeHead(201, { 'Content-Type': 'text/plain; charset=utf-8' });
          res.end('ok');
        });
      }
    } else if (req.method === 'PUT') {
      if (req.url.startsWith('/user/')) {
        const key = req.url.split('/')[2];
        let body = '';
        req.on('data', (data) => {
          body += data;
        });
        return req.on('end', () => {
          console.log('PUT 본문(Body):', body);
          users[key] = JSON.parse(body).name;
          res.writeHead(200, { 'Content-Type': 'text/plain; charset=utf-8' });
          return res.end('ok');
        });
      }
    } else if (req.method === 'DELETE') {
      if (req.url.startsWith('/user/')) {
        const key = req.url.split('/')[2];
        delete users[key];
        res.writeHead(200, { 'Content-Type': 'text/plain; charset=utf-8' });
        return res.end('ok');
      }
    }
    res.writeHead(404);
    return res.end('NOT FOUND');
  } catch (err) {
    console.error(err);
    res.writeHead(500, { 'Content-Type': 'text/plain; charset=utf-8' });
    res.end(err.message);
  }
})
  .listen(8082, () => {
    console.log('8082번 포트에서 서버 대기 중입니다');
  });