[네트워크]HTTP 메소드(중요!)

📝HTTP API 만들어보기 

회원 정보 관리 API를 만들어보자

• 회원 목록 조회
• 회원 조회
• 회원 등록
• 회원 수정 
• 회원 삭제

이런 기능을 만들건데 과거의 나는 어떻게 했을까?

물론 나는 타임리프 매핑으로 해서 좀 다를 수 있으나 문제가 많다..

• @GetMapping("/addMember")
• @PostMapping("/member/idValidation")
• @PostMapping("/member/nameValidation")

이거처럼 지멋대로 하였다. 크아아악!!!!

URI 리소스 식별 설계법 

리소스의 의미를 담아야한다. 

• 회원의 리소스는 member 
• 개념 자체가 리소스이다.

리소스를 어떻게 식별해야하는가?

• 회원 등록, 수정, 조회에 대한 것을 모두 제외하고
• 리소스만 매핑하여 따로 처리한다. 

 

• 회원 목록 조회 /members
• 회원 조회 /members/{id}
• 회원 등록 /members/{id}
• 회원 수정 /members/{id}
• 회원 삭제 /members/{id}

중요한 것은 리소스와 행위를 분리
행위 구분은 HTTP 메소드로 대신한다.

 

📝HTTP 메소드 - GET, POST, PUT, PATCH, DELETE 

GET

리소스 조회에 사용되는 메소드이다. 

GET /search?q=hello&hl=ko HTTP/1.1
Host: www.google.com

• 서버에 전달하고 싶은 데이터는 쿼리를 통해 전달한다.
• 메시지 바디를 사용해서 데이터를 전달할 수 있으나 보통 쿼리 파라미터로 전달한다.
• 주로 쿼리 파라미터를 통해 데이터베이스에서 특정 데이터를 가져온다. 

 

POST

요청 데이터를 처리한다.

POST /members HTTP/1.1
Content-Type: application/json

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

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

예시

• HTML 양식에 입력 된 필드와 같은 데이터 블록을 데이터 처리 프로세스에 제공
  • HTML 폼에 입력한 정보로 회원가입, 주문 
• 게시판, 뉴스 그룹, 메일링 리스트, 블로그 또는 유사한 기사 그룹에 메시지 게시
  • 게시판 글쓰기, 댓글 달기
• 서버가 아직 식별하지 않은 새 리소스 생성 등등 

PUT

리소스를 대체하는 것 

• 리소스가 있으면 대체
• 리소스가 없으면 생성
• 쉽게 이야기해서 덮어쓰기

중요한 것은 클라이언트가 리소스를 식별한다. 

• 클라이언트가 리소스 위치를 알고 URI 지정
• POST와 차이점이다. 

PUT /members/100 HTTP/1.1        //100번의 URI 위치를 알고 있음
Content-Type: application/json

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

• 쉽게 말해서 Update에 사용된다고 보면 된다. 

PATCH

PUT은 다른 형태의 데이터를 보내면 완전히 덮어써버리기 때문에 문제가 생긴다.

• PATCH는 데이터의 일부분만 변경시킬 수 있다.
• 걍 쓰지말자 

DELETE 

리소스 제거 

DELETE /members/100 HTTP/1.1
Host: www.google.com

 

 

📝HTTP 메소드의 속성

속성 : 안전(Safe)

• 호출해도 리소스를 변경하지 않는다.
• 변경이 일어나지 않는 것 
• GET, HEAD만 해당한다.

속성 : 멱등(Idempotent)

• 한 번 호출하든 두 번 호출하든 100번 호출하든 결과가 똑같다.
• GET, PUT, DELETE 만 해당, POST는 여러번 호출 시 중복발생 
  • 자동 복구 매커니즘에 사용/ 항상 결과가 같기때문에 오류 발생 시 한번 더 실행하면 된다.
• 멱등은 외부 요인으로 중간에 리소스가 변경되는 것은 고려하지 않는다. 

속성 : 캐시가능(Cacheable)

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