4. HTTP 메서드

인프런의 모든개발자를 위한 HTTP 웹 기본 지식 강의를 들은 내용을 정리하는 포스트입니다. 

---

HTTP API를 만들어보자

아래의 기능을 지원하는 회원 정보 관리 API URI를 만드는 상황을 생각해보자

• 회원 목록 조회 => /read-member-list
• 회원 조회 => /read-member-by-id
• 회원 등록 => /create-member
• 회원 수정 => /update-member
• 회원 삭제 => /delete-membe

이렇게 동사를 활용해서 URI를 만드는 것이 맞는걸까??? 

URI = Uniform Resource Identifier 이다. 이때 Resource는 회원 그 자체를 의미하는거지 등록, 조회 수정 등의 행위는 해당하지 않는다. 따라서 회원이라는 단어에 집중하여 아래처럼 수정해보자.

• 회원 목록 조회 => /members
• 회원 조회 => /members/{id}
• 회원 등록 => /members/{id}
• 회원 수정 => /members/{id}
• 회원 삭제 => /members/{id}
• 참고: 계층 구조상 상위를 컬렉션으로 보고 복수단어 사용 권장(member -> members)

그런데 이제 문제는 조회, 등록, 수정, 삭제 등은 어떻게 구분하는지이다. 

=> 행위는 HTTP 메서드(GET, POST PUT...)을 이용한다. 

URI는 리소스만 식별해야하며 행위와는 분리 되어야 한다는 점을 잘 기억해두자.
(실무에서는 어쩔수 없이 동사를 써야 할 때도 있다.. 컨트롤 URI)

---

GET

• 리소스 조회에 사용
• 서버에 전달하고 싶은 데이터는 query(쿼리 파라미터, 쿼리 스트링)를 통해서 전달
• 메시지 바디를 사용해서 데이터를 전달할 수 있지만, 지원하지 않는 곳이 많아서 권장하지 않음 => POST를 이용하기도 함

1.클라이언트가 서버에게 GET 요청을 보내면

2. 서버가 응답 데이터를 보내준다.

---

POST

• 요청 데이터 처리 (POST는 등록의 기능만 하는 것이 아님)
• 메시지 바디를 통해 서버로 요청 데이터 전달
• 서버는 요청 데이터를 처리
• 메시지 바디를 통해 들어온 데이터를 처리하는 모든 기능을 수행한다.
• 주로 전달된 데이터로 신규 리소스 등록, 프로세스 처리에 사용
• 리소스 URI에 POST 요청이 오면 요청 데이터를 어떻게 처리할지 리소스마다 따로 정해야 함 -> 정해진 것이 없음
->그래서 다른 메서드로 처리하기 애매하면 POST를 쓴다. 

1. 리소스를 등록해달라고 클라이언트가 POST 메세지를 보냄.

2.메세지를 받은 서버가 등록처리를 수행

3. 처리 완료후 서버가 클라이언트에게 응답 메세지 전송.

---

PUT

 

• 리소스를 대체하는 메서드다. (요청메세지에 있는 내용으로 덮어버림)
• 중요! 클라이언트가 리소스를 식별 (클라이언트가 리소스위치(/members/100) 를 알고 URI를 지정함 + POST와 차이점)

---

PATCH

• 리소스를 부분 변경하는 메서드다

---

DELETE

• 리소스를 제거하는 메서드다.

---

HTTP 메서드의 속성

안전(Safe Methods)
• 호출해도 리소스를 변경하지 않는다.
• Q: 그래도 계속 호출해서, 로그 같은게 쌓여서 장애가 발생하면요?
• A: 안전은 해당 리소스만 고려한다. 그런 부분까지 고려하지 않는다.

멱등(Idempotent Methods)
• 한 번 호출하든 두 번 호출하든 100번 호출하든 결과가 똑같다.
• 멱등 메서드
- GET: 한 번 조회하든, 두 번 조회하든 같은 결과가 조회된다.
- PUT: 결과를 대체한다. 따라서 같은 요청을 여러번 해도 최종 결과는 같다.
- DELETE: 결과를 삭제한다. 같은 요청을 여러번 해도 삭제된 결과는 똑같다.
- POST: 멱등이 아니다! 두 번 호출하면 같은 결제가 중복해서 발생할 수 있다.
• 서버가 TIMEOUT 등으로 정상 응답을 못주었을 때, 클라이언트가 같은 요청을 다시 해 도 되는가? 판단 근거 등으로 활용

캐시가능(Cacheable Methods)
• 응답 결과 리소스를 캐시해서 사용해도 되는가?
• GET, HEAD, POST, PATCH 캐시가능
• 실제로는 GET, HEAD 정도만 캐시로 사용
• POST, PATCH는 본문 내용까지 캐시 키로 고려해야 하는데, 구현이 쉽지 않음