HTTP #5 요청 메서드

# HTTP URI를 이용하여 데이터를 받아와보자

단순하게 생각하면 아래와 같이 만들 수 있다. 이것이 과연 좋은 URI 설계일까?

 

 

# Resource의 의미를 담아야한다.

URI는 리소스를 대표하는 식별자 (Uniform Resource Identifier)이다.

• 우리가 필요한 건 Member라는 리소스이다.
• 위와 같이 설계하면 update, read, delete에 따라 같은 리소스를 조회하는데 다른 URI를 사용해야한다.
• 이는 사용하는데에도, API 서버를 개발하는데에도 설계하기 어려워진다.

 

하지만 모든 요청을 [/member] 라고만 전달하게 된다면, 어떻게 의미를 구분해서 전달할 수 있을까?

➡ HTTP 메서드를 사용하자. 리소스와 행위를 분리하자. 

 

---

# HTTP 메서드의 종류

우리는 앞의 글에서 HTTP 요청 메시지의 시작라인에 메서드의 종류를 함께 보낸다고 배웠다.

HTTP 스펙에서 제공하는 메서드는 다음과 같다.

CORS(크로스 오리진 리소스 쉐어링)은 보안을 위해 현재 URI 출처:[Protocal, Host, Port]가 다른 요청을 막아주는 브라우저의 기능이다.

 

---

# GET과 POST의 차이

기억하자. GET은 리소스 요청을, POST는 리소스 처리를 의미한다.

➡ [POST == 단순히 등록, 갱신을 위한 기능]이 아니다! 더 넓은 의미로 사용된다.

• @GET - HTTP Header(=URI)에 필요한 파라미터, 요청 데이터를 적어서 보내는 방식이다.

• @POST - 요청 데이터를 Body에 넣어 보내는 방식이다. 요청 데이터를 숨길 수 있다. 

 

 

@ POST가 데이터를 처리한다는게 무슨말이죠?

• 새로운 리소스 생성, 등록
• 컨트롤 URI, 요청 데이터 처리 (결제 -> 배달시작 -> 배달완료) 처럼 서비스의 프로세스의 상태가 변경되는 경우
• 다른 메서드로 대체하기 애매한 경우 :: POST 사용
  ➡ ex1) JSON으로 요청 데이터를 넘겨야하는데, GET으로 처리할 수 없는 경우
  ➡ ex2) PATCH를 사용해야 하는데 서버에서 지원해주지 않는 경우

 

---

# PUT, PATCH, DELETE

• @PUT 은 리소스를 통으로 대체한다. 즉 있으면 대체하고 없으면 생성한다.
  ➡ 자바의 map.put(key,value)와 같은 의미다.

즉 PUT은 기존 리소스를 삭제하고 넣는거라, 리소스의 일부만 전달하면 안된다.

 

그 외 부분적으로 변경하고 싶다면 @PATCH를, 리소스를 제거하고 싶다면 @DELETE를 사용한다.

 

@ POST와 PUT의 차이

PUT은 클라이언트가 리소스를 식별한다. 특정 리소스를 대체하는 메소드이기 때문이다.

POST는 요청만 했을 뿐, 특정 리소스를 식별해서 지정한 것은 아니다. (POST는 리소스 위치를 모른다.)

 

---

# HTTP 메서드의 속성 Safe, Idempotent, Cacheable

그냥 POST로 모든 요청을 다 처리해도 상관없을 것 같은데, 이렇게 나눈데에는 이유가 있다.

각 메서드별로 특징이 다르기 때문이다.

 

 

@ 메서드의 안전 (Safe)

호출해도 리소스가 변경되지 않는 안전성을 의미한다.

GET은 안전하다. 하지만 변경이 일어나는 POST, PUT, DELETE 같은 메서드는 안전하지 않다.

➡ 다만 GET도 미친듯이 호출해서 서버 장애를 일으킬 수 있지만, 여기서 안전은 '리소스의 안전'을 의미한다.

 

 

@ 메서드의 멱등 (Idempotent, 여러번 호출해도 결과가 같은가?)

멱등이라는 어려운 말은 $ f(f(x)) = f(x) $ 라는 수학적인 용어에서 나왔다.

즉 GET, PUT, DELETE 처럼 한 사용자가 몇 번을 호출하더라도 결과가 같은 메서드를 의미한다.

➡ 물론 재요청하는 중간에 다른 곳에서 리소스가 변경되어 멱등이 깨질 수 있지만, 이는 외부요인이니 제외한다.

 

 

@ 메서드의 캐시가능 (Cacheable)

응답 결과를 매번 새로 받아오지 않고, 중간에서 캐시해서 재사용할 수 있는가?

➡ 보통 GET만 캐시기능을 만들어 사용한다.