[라이징캠프] 4주차 학습 정리 1 | Backend Language | HTTP | REST API | Query String/ Path Variable

학습 과정 : 서버(1, 2주차) ➡️ 데이터베이스(3주차) ➡️ Backend Language(4주차, 현재)

 

 

목차

HTTP

REST API

Query String vs Path Variable

RESTful

GET vs POST  PATCH vs PUT

PRACTICE

 

---

 

 

HTTP

- 2주차 서버에서 언급했던 HTTP기억 나시나요?

- HTTP는 컴퓨터간 네트워크 통신을 위한 프로토콜(규정)입니다.

- 전송 단위는 패킷으로 Header 와 Body로 나눠집니다.

- Header는 수신자의 IP 정보를, Body는 전송하려는 데이터를 담고 있습니다.

- 대표적 메소드는 GET/ POST/ PATCH/ PUT/ DELETE 로 CRUD 기반이라고 할 수 있다.

 

REST API

- REST(Representational State Transfer) : 자원을 이름으로 구분하여 그 자원을 주고받는 모든 것을 의미한다. 여기서 자원이 포인트

- API(Application Programming Interface) : 어플리케이션과 서버 프로그램 통신을 연결해주는 인터페이스(연결자, 경계면)

- [예시1] 기상청에는 날씨 정보를 저장하고 있는 데이터베이스가 있을 것이다.

               ㄴ 이 데이터베이스로부터 값을 가져와 날씨를 어플에서 확인할 수 있도록 연결해주는 역할이 바로 API이다!

- [예시2] 대통령이 핵을 발사 할 수 있는 버튼을 가지고 있다고 해보자.

                ㄴ 대통령은 클라이언트, 버튼은 API, 핵은 데이터베이스이다.

                ㄴ 대통령은 버튼을 누르기만 하면(요청) 핵을 발사할 수 있다. 핵을 발사하기 까지 복잡한 일련 과정은 몰라도 된다는 말이다.

 

 

- 결론적으로 REST API는 HTTP를 기반하여 자원 기준으로 데이터를 주고받을 수 있도록 규정한 아키텍처이다.

- 기본적으로 HTTP를 기반하고 있으므로 메소드 GET/ POST 등은 그대로 사용한다.

 

 

Query String / Path variable

- Query String : 물음표(?) 구분자를 사용해서 조회/필터링할 데이터에 대한 제한 사항(매개변수)을 보내는 방법. 여러개의 매개변수를 사용할 때는 앤드(&) 구분자를 이용하여 이어붙인다.

     ex) /users?career=개발&age=25    개발직군의 25살 유저들을 조회하는 End-Point(URL)

 

- Path Variable : URL의 Path 일부를 사용하여 데이터를 식별하기위한 자원을 보내는 방법이다. 앤드(&)연산자가 아닌 Path로 구성되는 것이 특징이다.

     ex) /users/:id  ➡️  /users/355     user id가 355인 유저를 특정하여 조회

 

더욱 자세한 설명은 [라이징캠프] 5주차 정리 글에서 확인하기 바란다

 

RESTful

- REST API 원리를 잘 지켜 작성했다는 의미

- 누군가 공식적으로 발표 된 것이 아니다. 원활한 통신을 위해 암묵적으로 약속한 것들을 잘 지켜 작성하면 Restful하다고 말할 수 있다

- 목적은 이해하기 쉽고 사용하기 쉽게 하기 위함이다.

- 약속들을 간단하게 살펴보자

    ㄴ 자원은 복수형으로 작성한다. ex) /user (x) /users (o)

    ㄴ 행위는 메소드로, URI는 자원을 기준으로 작성한다. ex) GET /user/create (x)  ->  (x) POST /users (o)

    ㄴ URI 구분자는 언더바(_)나 카멜케이스(userId)가 아닌 하이픈(-)으로 한다. ex) /sign-up (o)   /signUp (x)  /sign_up (x)

    ㄴ etc...

 

 

 

GET vs POST     PATCH vs PUT

- GET은 조회, 필터링을 목적으로 사용된다. POST와 가장  큰 차이점은 GET은 캐시와 브라우저 기록에 남지만 POST는 남지 않는다.

POST는 데이터 생성을 위해 사용된다. 이 두 메소드를 구분하여 사용하는 것이 RESTful하다고 할 수 있다.

- GET은 조회가 목적이므로 uri에서 ? 구분자로 받은 매개변수를 이용하는 반면 POST는 Body에 값을 받아서 API가 수행된다.

 

- PATCH와 PUT은 둘 다 정보를 변경할 때 사용되지만 PATCH는 작은 단위의 변경할 때 사용하고, PUT은 전체 정보를 수정할 때 사용된다. 그러므로 데이터값을 바꿀 때 주로 PATCH를 사용하게 된다.

 

 

 

 

 

 

 

---

PRACTICE

https://www.notion.so/softsquared/4-REST-API-SpringBoot-8961f53889d948cbb8ad2e4d09befb8b?pvs=4 

[4주차] REST API 리스트업 하고 구현- SpringBoot

---

 

REFERENCE

https://gmlwjd9405.github.io/2018/09/21/rest-and-restful.html

[Network] REST란? REST API란? RESTful이란? - Heee's Development Blog