TIL51. HTTP : HTTP Method

📌 이 포스팅에서는 HTTP의 GET, POST, PUT, PATCH, DELETE 매서드에 대해 정리하였습니다.

🌈 HTTP Method

🔥 HTTP 매서드란?

🔥 GET, POST 매서드

🔥 PUT, PATCH, DELETE 매서드

🔥 HTTP 매서드의 속성

1. HTTP 매서드란?

🤔 HTTP 매서드는 왜 필요할까?

✔️ 자원(resource) 식별하기 위해 URL을 설계할 때, URL은 자원에 해당하는 그 대상에 대해서만 식별하는 것이 권장되고, 자원의 행위에 대해서는 분리해야한다.

✔️ 예를들어, 회원 등록, 회원 조회, 회원 수정, 회원 삭제 URL을 만들 때, 식별해야하는 자원은 회원이다.

✔️ 따라서 등록, 조회, 수정, 삭제는 자원에 대한 행위이기 때문에 HTTP 매서드를 최대한 활용해서 API URL을 설계해야 한다.

✔️ 즉, HTTP 매서드가 필요한 이유는 URL에서 자원의 대상만을 식별하기 때문에 생성, 조회, 수정, 삭제 등이 모두 같은 URL을 가지지 않도록 하기 위해서 HTTP 매서드가 필요한 것이다.

🤔 HTTP 매서드는 무엇이 있을까?

✔️ 주요 HTTP 매서드는 아래와 같다.

✔️ 자원(resource)이란 용어 대신 표상(representation)이란 용어를 사용하겠다. 행위까지 포함하기 때문이다.

• GET : 표상(representation) 조회 👈 READ
• POST : 요청 데이터 처리, 주로 표상(representation) 등록에 사용 👈 CREATE
• PUT : 없으면 표상(representation)을 생성, 있으면 현재 자원(representation)으로 대체 👈 UPDATE
• PATCH : 표상(representation) 부분 변경 👈 UPDATE
• DELETE : 표상(representation) 삭제 👈 DELETE
• HEAD : GET과 동일하지만 메시지 부분을 제외하고, header까지만 반환

2. GET, POST 매서드

🤔 GET 매서드

✔️ GET은 데이터를 조회하기 위해서 사용한다.

✔️ GET 매서드도 Body를 사용할 수 있으나, 일반적으로 Body를 사용하지 않고 데이터를 query를 통해 전달한다.

✔️ GET요청을 받은 서버는 DB를 확인해 데이터를 다시 클라이언트에 아래와 같이 응답한다.

🤔 POST 매서드

✔️ POST는 body 영역에 데이터에 담아 클라이언트에서 서버로 전달하기 위해한다.

✔️ 일반적으로 query에 보여져서는 안되는 중요한 정보는 body에 담아 POST형식으로 요청된다.

✔️ 실제로 POST만으로도 모든 행위에 대해 처리가 가능하다. 다만, POST는 데이터 생성 및 프로세스 처리에 주로 사용하는 것이 권장된다.

✔️ 예를들어 조회할 때, POST를 사용하면 cashing하기 어렵기 때문에 조회에 있어서는 GET이 더 유리하다.

✔️ "/members/" URI의 POST의 요청이 계정 생성으로 미리 약속되어 있다면, 계정을 생성한 뒤 아래와 같이 응답메시지를 클라이언트로 전달한다. location은 자원이 생성된 경로다.

✔️ POST로 클라이언트에서 서버로 요청할 때, path만 지정하고 자원(resource)의 위치는 지정하지 않는다. 클라이언트에서 자원이 생설될 URL(id값)을 모르기 때문이다. 이에 서버가 요청을 받으면 리소스 URL를 생성해서 location값으로 클라이언트에 전달해준다. 이를 컬렉션(Collection)이라 한다.

3. PUT, PATCH, DELETE 매서드

🤔 PUT 매서드

✔️ PUT은 데이터가 있으면 완전히 대체하고 없으면 생성합니다. 마치 폴더에 파일이 없으면 새로 생성하고 있으면 덮어쓰는 것과 같다.

✔️ 단, PUT은 클라이언트에서 서버로 메시지를 전송할 때, 자원(resource) 위치를 이미 식별하고 URI를 지정해주어야 한다. 이 부분이 PUT과 POST는 차이다.

✔️ PUT에서 자원(resource)의 위치를 직접 지정한다는 것은 이미 알고 있는 경우에 가능하다. 즉, 클라이언트에서 자원(resource)의 위치(URL)를 이미 알고 관리하는 개념을 스토어(Store)라 한다.

🤔 PATCH 매서드

✔️ PATCH는 자원(resource)을 부분 변경한다. 당연히 자원의 위치를 명확히 알아야 한다.

✔️ 단, 서버에서 PATCH 허용하지 않는 경우에는 POST를 사용합니다.

🤔 DELETE 매서드

✔️ DELETE는 자원(resource)를 삭제한다. 당연히 자원의 위치를 명확히 알아야 한다.

4. HTTP 매서드의 속성

🤔 안전(Safe Methods)

✔️ 안전이란 매서드 호출이 리소스를 변경을 유발하지 않는다는 의미이다. GET은 조회만하기 때문에 안전하지만, POST, PUT, PATCH, DELETE는 안전하지 않다.

✔️ 단, 안전이란 해당 자원(resource)이 변하냐 변하지 않냐만을 고려한 의미다. 즉, 계속 호출해서 서버에 장애가 발생한다해도 이는 안전이란 특징과는 무관합니다. 자원만 자체에 주는 영향만 고려하기 때문이다.

🤔 멱등(Idempotent Methods)

✔️ 멱등은 한 번 호출하든 두번 호출하던 100번 호출하던 결과가 동일한 신뢰도의 개념이다.

✔️ 즉, 동일한 데이터에 GET, PUT, DELETE를 한번하던 100번하던 조회, 덮어씌우기, 삭제의 결과는 변동이 없다. 이에 GET, PUT, DELETE는 멱등하다.

✔️ 이에 반해 POST는 두 번 호출하면 중복해서 데이터가 생성되는 결과를 발생시키기 때문에 멱등하지 않다고 표현한다.

🤔 캐시 가능(Cacheable Methods)

✔️ 응답 결과를 캐쉬에서 사용할 수 있는지에 대한 여부를 캐쉬 가능이라 한다.
✔️ GET, HEAD, POST, PATCH는 캐시가능하지만, 실제로는 GET, HEAD 정도만 캐시로 사용한다.