[HTTP] HTTP 메서드의 종류

HTTP 메서드의 종류

HTTP 메서드는 같은 URI더라도 메서드를 구분하여 역할을 구분할 수 있다.
RestFull한 API URI를 설계한다면?
-> /members/{id}라는 URI 하나만으로 member중 id를 가진 사람이라는 대략적인 정보, HTTP 메서드로 행위를 정의할 수 있는 장점이 있다.

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

GET

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

POST

• 요청 데이터를 처리한다.
• 메시지 바디를 통해 서버로 요청 데이터를 전달한다.
• 서버는 요청 데이터를 처리하며 메시지 바디를 통해 들어온 데이터를 처리하는 모든 기능을 수행한다.
• 주로 전달된 데이터로 신규 리소스 등록, 프로세스 처리에 사용된다.
• POST로 요청이 오면 서버는 리소스마다 어떻게 처리해야 할지 정의해야 한다.
• PUT, PATCH, DELETE와 같은 메서드가 하는 역할들을 POST로 모두 정의해서 사용할 수 있을 정도로 범용적인 역항을 한다.

PUT

• 리소스를 대체한다.
  • 리소스가 없으면 생성
  • 리소스가 있으면 대체
  • 덮어쓰기!
• 클라이언트가 리소스를 식별한다
  • 클라이언트가 리소스 위치를 알고 URI를 지정한다.
  • 즉, 어떤 리소스에 대하여 PUT행위를 할지 지정해야 한다.

PATCH

• 리소스의 부분을 변경한다.
  • PUT메서드가 아예 덮어쓰기이라면? PATCH는 전송한 정보에 대해서만 업데이트를 한다.

DELETE

• 리소스를 제거한다.
  • 단순하게 생각하면 된다. 지정한 리소스를 삭제하는 역할을 한다.

HTTP 메서드의 속성

• 안전(Safe Methods)
• 멱등(Idempotent Methods)
• 캐시가능(Cachable Methods)

안전(Safe Methods)

• 호출해도 리소스를 변경하지 않는다.
  • GET, HEAD, OPTIONS, TRACE 메서드와 같이 조회하는 경우에 해당한다.

멱등(Idempotent Methods)

• 동일한 요청이라면, 한 번 호출하던 두 번 호출하던 몇 번의 호출에도 결과는 같다.
• 멱등 메서드
  • GET: 한 번 조회하든, 두 번 조회하든 같은 결과가 조회
  • PUT: 결과가 대체된다. 같은 PUT 요청이라면 결과는 똑같다.
  • DELETE: 결과를 삭제한다. 같은 리소스를 여러번 삭제해도 삭제된 상태는 동일하다.

캐시가능(Cachable Methods)

• 응답 결과 리소스를 캐시해서 사용해도 되는가?
• GET, HEAD, POST, PATCH 캐시가능
• 실제로는 GET, HEAD 정도만 캐시로 사용한다.