HTTP/HTTP 메서드 활용

• 클라이언트 -> 서버 데이터 전달 방식

-쿼리 파라미터를 통한 데이터 전송: GET(정적, 동적 데이터 조회)

-메시지 바디를 통한 데이터 전송: POST,PUT,PATCH(HTML Form, API 등을 통한 데이터 전송)

 

*HTML Form 전송은 GET,POST만 지원하며, 일반적으로 많이 쓰이는 것은 POST 메서드이다. HTML Form submit시 POST 메서드로 HTTP 요청 메시지가 전송이 된다. Content-Type으로는 주로 application/x-www-form-urlencoded을 사용한다.

*HTTP API 전송은 POST,PUT,PATCH의 경우에는 HTTP 메시지 바디를 통해  데이터를 전송하고, GET의 경우에는 조회, 쿼리 파라미터로 데이터를 전달한다. Content-Type으로는 주로 application/json을 사용한다.

 

• API 설계

 

POST 기반 등록

 

-회원 목록 /members -> GET

-회원 등록 /members -> POST

-회원 조회 /members/{id} -> GET

-회원 수정 /members/{id} -> PATCH, PUT, POST

-회원 삭제 /members/{id} -> DELETE 

 

*클라이언트가 POST 기반으로 등록을 요청할 때 등록될 리소스의 URI를 모른다. 서버가 새로 등록된 리소스 URI를 생성해준다.

HTTP/1.1 201

Created Location: /members/100<- 이런 식으로 생성함.

*서버가 관리하는 리소스 디렉토리를 컬렉션이라고 한다. 서버는 리소스의 URI를 생성하고 관리한다. 여기서 컬렉션은 /members이다.

 

 

PUT 기반 등록

 

-파일 목록 /files -> GET

-파일 조회 /files/{filename} -> GET

-파일 등록 /files/{filename} -> PUT

-파일 삭제 /files/{filename} -> DELETE

-파일 대량 등록 /files -> POST 

 

*클라이언트가 PUT 기반으로 등록을 요청할 때 리소스 URI를 알고 있어야 한다. 클라이언트가 직접 리소스의 URI를 지정한다. Store는 클라이언트가 관리하는 리소스 저장소이며, 클라이언트가 리소스의 URI를 알고 관리해야 함. 여기서 스토어는 /files

 

• HTML FORM 사용

-HTML FORM은 GET, POST만 지원

-AJAX 같은 기술을 사용해서 해결 가능 -> 회원 API 참고

-여기서는 순수 HTML, HTML FORM 이야기

 

-회원 목록 /members -> GET

-회원 등록 폼 /members/new -> GET

-회원 등록 /members/new, /members -> POST

-회원 조회 /members/{id} -> GET

-회원 수정 폼 /members/{id}/edit -> GET

-회원 수정 /members/{id}/edit, /members/{id} -> POST

-회원 삭제 /members/{id}/delete -> POST 

 

• 컨트롤 URI

-GET, POST만 지원하므로 제약이 있음

-이런 제약을 해결하기 위해 동사로 된 리소스 경로 사용

-POST의 /new, /edit, /delete가 컨트롤 URI

-HTTP 메서드로 해결하기 애매한 경우 사용(HTTP API 포함)