[250115] REST 와 RESTful 에 대한 전반적인 개념정리~

REST란? 💆🏻‍♀️

1. REST 정의

REST(REpresentational State Transfer)는 네트워크 상에서 자원을 관리하고 사용하는 아키텍처 스타일이다.

REST는 웹의 기본 프로토콜인 HTTP를 활용하여 클라이언트와 서버 간의 데이터 교환을 단순화하고 일관성 있게 설계한다.

---

REST의 핵심 구성 요소

1. 자원(Resource)
   • 자원은 URL을 통해 식별된다.
   • 모든 자원은 고유한 URI(Uniform Resoource Identifier)를 가진다.
   • 예: `/users/1`은 `id=1`인 사용자를 나타내는 자원임.
2. 표현(Representation)
   • 자원은 여러 형태로 표현될 수있다.
     • 예: (JSON, XML, HTML 등)
   • 클라이언트는 표현을 요청하고, 서버는 해당 데이터를 반환한다.
3. 상태전이(State Transfer)
   • 클라이언트는 요청(Request)을 통해 서버의 상태를 변경하거나 조회한다.

---

2. REST의 특징

클라이언트-서버 분리(Client-Server Separation)

• 클라이언트와 서버는 독립적으로 개발이 가능하다.
• 클라이언트는 UI를 담당하고, 서버는 데이터와 비즈니스 로직을 처리한다.

무상태성(Stateless)

• 각 요청은 독립적이고, 서버는 클라이언트의 상태를 저장하지 않는다.
• 요청에 필요한 모든 정보는 자체적으로 포함된다.

캐시 가능(Cacheable)

• HTTP 응답에 캐싱 정보를 포함하여 클라이언트가 응답을 캐시 가능함.

계층화 시스템(Layered System)

• 클라이언트는 중간 계층(프록시, 게이트위에)을 통해서도 서버와 통신이 가능하다.

통합 인터페이스(Uniform Interface)

• 자원 식별, 요청 방식, 응답 형식 등이 일관된 방식으로 설계됨.

---

3. RESTful API란?

REST 원칙을 준수하여 설계된 API를 RESTful API라고 한다.

클라이언트는 HTTP 메서드와 URL 구조를 통해 자원을 관리한다.

1) RESTful이란?

쉽게 말하자면,

어떤 것을 말하면 그 자원의 상태를 알 수 있는 것이다.

RESTful은 `자원의 상태를 전달하는 것` 이 핵심임.

2) API란?

Application Programming Interface의 준말로,,,

소프트웨어의 구성 요소간 서로 통신을 하기 위한 메서드이다.

---

4. HTTP 메서드와 REST

RESTful API는 HTTP 메서드를 자원 관리에 활용한다.

HTTP 메서드	의미	동작	예시
`GET`	데이터 조회	자원의 정보를 가져온다	`/users` (사용자 목록 조회)
`POST`	데이터 생성	자원을 새로 만듦	`/users` (새 사용자 생성)
`PUT`	데이터 전체 수정	자원의 모든 속성을 업데이트함	`/users/1` (사용자 전체 수정)
`PATCH`	데이터 일부 수정	자원의 일부 속성만 업데이트	`/users/1` (일부만 수정)
`DELETE`	데이터 삭제	자원을 삭제한다	`/users/1` (사용자 삭제)

`PUT`과 `PATCH`의 좀 더 간략한 설명:

• `PUT` : '안녕하세요.' 문자열 전체를 '감사하세요.' 로 수정. '안녕하세요.' >> '감사하세요.'
• `PATCH` : '안녕하세요.' 문자열에서 '안녕' 만 '감사' 로 수정. '안녕'하세요. ?? '감사'하세요.

---

5. RESTful URI 설계

RESTful URI는 자원을 명확히 식별하며, 간결하고 일관된 구조로 설계된다.

URI 설계 규칙

1. 명사 사용: 자원은 명사로 표현된다.
   • 예: `/users`, `/products`, `orders`
2. 동작표현 없음: 동작은 HTTP 메서드로 표현됨.
   • 잘못된 예: `/getUser`, `/createUser`
3. 계층적 구조: 관계를 표현하기 위해 계층적으로 설계된다.
   • 예: `/users/1/orders`
4. 소문자 사용: URI는 소문자를 사용한다.
   • 잘못된 예: `/Users`
5. 복수형 사용: 자원은 복수형으로 표기한다.
   • 예: `/users`(모든 사용자)

URI 예제

• 모든 사용자 가져오기: `GET /users`
• 특정 사용자 가져오기: `GET /users/1`
• 사용자 생성: `POST /users`
• 사용자 수정: `PUT /users/1`
• 사용자 삭제: `DELETE /users/1`

---

6. RESTful 응답 상태 코드

RESTful API는  HTTP 상태 코드를 통해 요청 결과를 전달한다.

상태 코드	의미	설명
`200 OK`	성공	요청이 성공적으로 처리됨
`201 Created`	자원 생성 성공	새 자원이 성공적으로 생성됨
`204 No Content`	성공이지만 데이터 없음	요청은 성공했으나, 반환할 데이터가 없음
`400 Bad Request`	잘못된 요청	클라이언트의 요청이 잘못됨
`401 Unauthorized`	인증 실패	인증이 필요하거나 인증에 실패함
`403 Forbidden`	권한 없음	권한 부족으로 접근 불가
`404 Not Found`	자원 없음	요청한 자원이 존재하지 않음
`500 Internal Server Error`	서버 오류	서버에서 요청을 처리 중에 에러가 발생함

---

7. RESTful 설계의 장점

1. 표준화: HTTP 표준을 기반으로 설계되므로 이해와 구현이 쉽다.
2. 유연성: 클라이언트와 서버의 독립성으로 유지보수가 용이하다.
3. 확장성: 구조화 된 URI로 새로운 자원과 동작을 추가하는 것이 가능함.
4. 호환성: 다양한 언어와 플랫폼에서 사용이 가능하다.

---

8. RESTful 설계의 한계

1. 복잡한 관계 처리의 어려움: 트랜잭션 등 복잡한 작업은 구현이 까다롭다.
2. HTTP 제약: HTTP 메서드와 상태 코드 외 추가 확장이 필요함.
3. 무상태성의 제약: 클라이언트 상태를 서버에서 유지할 수 없다.
4. 실시간성 부족: WebSocket과 같은 양방향 통신이 필요할 때 부적합하다.

---

9. RESTful과 다른 API의 스타일 비교

특징	RESTful	GraphQL	gRPC
데이터 구조	자원 중심	클라이언트 요청 중심	메서드 중심
요청/응답 구조	HTTP + JSON	HTTP + JSON	HTTP/2 + Protobuf
실시간 통신	제한적 (SSE)	Subscription 지원	실시간 양방향 스트리밍 지원
사용성	간단하고 직관적	복잡한 쿼리 처리 가능	고성능, 이진 데이터 전송

---

정리 🧹

RESTful은 간결하고 일관된 방식으로 클라이언트와 서버 간의 데이터 교환을 가능하게 한다.

• RESTful 설계의 핵심은 자원(Resource) 중심의 URI와 HTTP 메서드 활용이다.
• 표준화된 응답 상태 코드와 JSON 같은 포맷을 통해 클라이언트와 서버 간의 통신을 간소화하였다.
• 단순한 구조와 확장성이 장점이나, 복잡한 관계 처리와 실시간 데이터 처리에는 한계가 있다.