📙 REST API란?

REST API는 Representational State Transfer(REST) 아키텍처 스타일을 따르는 API로, 클라이언트와 서버 간에 HTTP 프로토콜을 이용하여 데이터를 주고받는 방식입니다.

• REST API는 HTTP 기반의 CRUD 수행을 위한 규칙을 따르는 API
• RESTful하게 설계하려면 일관된 URL과 HTTP 메서드를 활용
• Spring Boot에서 @RestController, @RequestMapping, @ExceptionHandler 등을 활용하여 REST API 구현 가능

✏️ 1. REST API의 기본 원칙

1. 클라이언트-서버 구조

   • 클라이언트(프론트엔드)와 서버(백엔드)가 명확히 분리됨.

2. 무상태(Stateless)

   • 서버는 클라이언트의 상태를 저장하지 않으며, 요청마다 필요한 모든 정보를 포함해야 함.

3. 캐시 가능(Cacheable)

   • GET 요청의 경우, 응답을 캐시하여 성능을 향상시킬 수 있음.

4. 계층화된 시스템(Layered System)

   • API 요청은 여러 계층을 거칠 수 있으며, 보안, 로드 밸런싱 등을 적용할 수 있음.

5. 일관된 인터페이스(Uniform Interface)

   • API의 리소스 명명 규칙을 지켜야 함 (/users, /products 등).

✏️ 2. REST API의 HTTP 메서드

HTTP 메서드	설명
GET	리소스 조회 (/users/1 → ID가 1인 사용자 조회)
POST	리소스 생성 (/users → 새로운 사용자 생성)
PUT	리소스 전체 수정 (/users/1 → ID가 1인 사용자 전체 수정)
PATCH	리소스 일부 수정 (/users/1 → ID가 1인 사용자 일부 수정)
DELETE	리소스 삭제 (/users/1 → ID가 1인 사용자 삭제)

✏️ 3. Rest 관련 어노테이션

Annotation	Description
@RestController	Controller가 REST 방식을 처리하기 위한 것임을 명시
@ResponseBody	JSP 같은 뷰로 전달되는 것이 아니라 데이터 자체를 전달
@PathVariable	URL 경로에 있는 값을 파라미터로 추출
@CrossOrigin	Ajax의 크로스 도메인 문제를 해결
@RequestBody	JSON 데이터를 원하는 타입으로 바인딩
@RequestParam	쿼리 파라미터로 값을 받을 때 사용
@RequestHeader	HTTP 요청 헤더 값을 가져올 때 사용
ResponseEntity	HTTP 응답 코드, 헤더, 바디를 세밀하게 제어할 때 사용