🌟 HTTP 메서드 GET, POST 정리

HTTP 메서드 목차

(1) HTTP API를 만들어보자
(2) HTTP 메서드 - GET, POST
(3) HTTP 메서드 - PUT, PATCH, DELETE
(4) HTTP 메서드의 속성

💫 1. HTTP API를 만들어보자

문제: 회원 정보 관리 API를 만들어라

API URI 설계를 합니다.

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

이것은 좋은 URI 설계일까요 ?

가장 중요한 것은 리소스 식별입니다.

🙄 API URI 고민

1. 리소스의 의미는 뭘까?

• 회원을 등록하고 수정하고 조회하는게 리소스가 아니다!
  예) 미네랄을 캐라 -> 라고 한다면 여기서 '미네랄'이 리소스다. (명사)
• 회원이라는 개념 자체가 바로 리소스다.

2. 리소스를 어떻게 식별하는게 좋을까요?

• 회원을 등록하고 수정하고 조회하는 것을 모두 배제
• 회원이라는 리소스만 식별하면 된다. -> 회원 리소스를 URI에 매핑

그러므로

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

이 API URI는 좋은 리소스가 아닙니다. 회원이라는 명사가 리소스이기 때문에 이렇게 짜는 것이 바람직 합니다.

• 회원 목록 조회 /memebers -> 회원이니까 멤버s
• 회원 조회 /memebers/{id}
• 회원 등록 /members/{id}
• 회원 수정 /members/{id}
• 회원 삭제 /members/{id}

여기서 리소스는 '회원' 이니까 members로 리소스를 만들었다.
하지만 그 뒤에 조회, 등록, 수정, 삭제는 어떻게 구분해 줘야할지 알아보자 🙂

리소스와 행위를 분리
가장 중요한 것은 리소스를 식별하는 것이다.

• URI는 리소스만 식별! "미네랄을 캐라" -> "미네랄"
• 리소스와 해당 리소스를 대상으로 하는 행위를 분리한다.
  (리소스 : 회원 / 행위 : 조회, 등록, 삭제, 변경)
• 리소스는 명사, 행위는 동사 (미네랄을 캐라)
• 행위(메서드)는 어떻게 구분할까 ?

💫 2. HTTP 메서드 종류 (주요 메서드)

• GET : 리소스 조회
• POST : 요청 데이터 처리, 주로 등록에 사용
• PUT : 리소스를 대체, 해당 리소스가 없으면 생성
• PATCH : 리소스 부분 변경
• DELETE : 리소스 삭제
• HEAD : GET과 동일하지만 메시지 부분을 제외하고, 상태 줄과 헤더만 반환한다.
• OPTIONS : 대상 리소스에 대한 통신 가능 옵션(메서드)을 설명(주로 cors에서 사용한다)
• CONNECT : 대상 자원으로 식별되는 서버에 대한 터널을 설정 (거의 사용 X)
• TRACE : 대상 리소스에 대한 경로를 따라 메시지 루프백 테스트를 수행 (거의 사용 X)

GET

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

POST

• 요청 데이터 처리
• 메시지 바디를 통해 서버로 요청 데이터 전달
• 서버는 요청 데이터를 처리
• 메시지 바디를 통해 들어온 데이터를 처리하는 모든 기능을 수행한다.
• 주로 전달된 데이터로 신규 리소스 등록, 프로세스 처리에 사용
• 신규 리소스 생성

[응답 데이터]

클라이언트 쪽에서 아래 내용의 데이터들을
HTTP/1.1 201 Created
Content-Type:application/json
Content-Length: 34
Location : /members/100

{
"username":"young",
"age":20
}

이렇게 보내주면 서버에서는 클라이언트 데이터 내용들이 입력되서
/members/100 멤버중 100번 째를 응답한다. (Response)

🌟 요청 데이터를 어떻게 처리한다는 뜻일까 ?

예시)

• 스펙 : POST 메서드는 대상 리소스가 리소스의 고유 한 의미 체계에 따라 요청에 포함 된 표현을 처리하도록 요청합니다.
• 예를 들어 POST는 다음과 같은 기능에 사용됩니다.

1. HTML 양식에 입력 된 필드와 같은 데이터 블록을 데이터 처리 프로세스에 제공
(HTML폼에 입력한 정보로 회원 가입, 주문 등에서 사용)
2. 게시판, 뉴스 그룹, 메일링 리스트, 블로그 또는 유사한 기사 그룹에 메시지 게시
(게시판 글쓰기, 댓글 달기)
3. 서버가 아직 식별하지 않은 새 리소스 생성
(신규 주문 생성)
4. 기존 자원에 데이터를 추가한다.
(한 문서 끝에 내용 추가하기)

정리 : 이 리소스 URI에 POST 요청이 오면 요청 데이터를 어떻게 처리할지 리소스마다 따로 정해야 한다.

🌟 POST 정리

1. 새 리소스 생성(등록)

• 서버가 아직 식별하지 않은 새 리소스 생성

2. 요청 데이터 처리

• 단순히 데이터를 생성하거나, 변경하는 것을 넘어서 프로세스를 처리해야 하는 경우
  예) 주문에서 결제완료 -> 배달시작 -> 배달완료 처럼 단순히 값 변경을 넘어 프로세스의 상태가 변경되는 경우
• POST의 결과로 새로운 리소스가 생성되지 않을 수도 있음
  텍스트예) POST /orders/{orderId}/start-delivery (컨트롤 URI)

3. 다른 메서드로 처리하기 애매한 경우

예 ) 조회할 때는 최대한 GET으로 하는게 유리하다. 하지만, 변경되거나 프로세스가 진행되는 경우 정말 어쩔 수 없는 경우에는 POST를 쓰면 좋다.