이론 : Rest, Json, Annotation이 무엇인가

실습 : 두 수를 더하는 API 작성 ex) “http://localhost:8080/add/3/4” 7이 나오도록 작성

REST란 무엇인가

• Representational state Transfer의 약자

• API 작동 방식에 대한 조건을 부과하는 소프트웨어 아키텍처

• 자원을 이름으로 구분하여 해당 자원의 상태(정보)를 주고 받는 모든 것을 의미함.

  → 자원의 표현에 의한 상태 전달

• HTTP URI(Uniform Resource Identifier)를 통해 자원을 명시하고, HTTP Method(POST, GET, PUT, DELETE)를 통해 해당 자원에 대한 CRUD를 적용하는 것을 의미

  • CRUD Operation Create : 생성(POST) Read : 조회(GET) Update : 수정(PUT) Delete : 삭제(DELETE) HEAD: header 정보 조회(HEAD)

1-1. REST 아키텍처 스타일의 원칙들

• 균일한 인터페이스

  • 서버가 표준 형식으로 정보를 전송함을 나타냄.
  • 형식이 지정된 리소스를 REST에서 ‘표현’이라 부름

  (번외: 균일한 인터페이스를 위한 4가지 아키텍처 제약 조건)

  1. 요청은 리소스를 식별해야 함. 이를 위해 균일한 리소스 식별자를 사용함

  2. 클라이언트는 원하는 경우 리소스를 수정하거나 삭제하기에 충분한 정보를 리소스 표현에서 가지고 있음. 서버는 리소스를 자세히 설명하는 메타 데이터를 전송해 이 조건을 충족함.

  3. 클라이언트는 표현을 추가로 처리하는 방법에 대한 정보를 수신함. 이를 위해 서버는 클라이언트가 리소스를 적절하게 사용할 수 있는 방법에 대한 메타 데이터가 표함된 명확한 메시지를 전송함.

  4. 클라이언트는 작업을 완료하는 데 필요한 다른 모든 관련 리소스에 대한 정보를 수신함. 이를 위해 서버는 클라이언트가 더 많은 리소스를 동적으로 검색할 수 있도록 표현에 하이퍼링크를 넣어 전송함.

• 무상태

  • 서버가 이전의 모든요펑과 독립적으로 모든 클라이언트 요청을 완료하는 통신 방법
  • 서버가 매번 요청을 완전히 이해해서 이행할 수 있음을 의미

• 계층화 시스템

  • 계층화된 시스템 아키텍처에서 클라이언트는 클라이언트와 서버 사이의 다른 승인된 중개자에게 연결 할 수 있고, 서버로부터도 응답을 받음.

• 캐시 가능성

  • 서버 응답 시간을 개선하기 위해 클라이언트 또는 중개자에 일부 응답을 저장하는 캐싱을 지원함

• 온디맨드 코드

  • 서버는 소프트웨어 프로그래밍 코드를 클라이언트에 전송하여 클라이언트 기능을 일시적으로 확장하거나 사용자 지정 가

1-2. REST 구성요소

• 자원 : URI
  • 모든 자원에 고유한 ID가 존재하고, 이 자원은 서버에 존재함
  • 자원을 구별하는 ID는 HTTP URI이다
• 행위 : HTTP Method
  • HTTP 프로토콜은 GET,POST,PUT,DELETE와 같은 메서드를 제공함
• 표현 : Representation of Resource
  • 클라이언트가 자원의 상태에 대한 조작을 요청하면 서버는 이에 적절한 응답을 보냄
  • RESET 에서 하나의 자원은 JSON, XML, TEXT, RSS등 여러 형태의 표현으로 나타낼 수 있음
  • JSON, XML 을 통해 데이터를 주고 받는게 일반적