5. HTTP 메서드 활용

 

본 포스팅은 우아한 형제들, 김영한 님의 '모든 개발자를 위한 HTTP 웹 기본 지식' 강의를 수강 후 정리한 글입니다.

 

 

 

1. 클라이언트 -> 서버로 데이터 전송

-> 데이터 전송 방식은 크게 2가지:

• 쿼리 파라미터를 통한 데이터 전송
• 메시지 바디를 통한 데이터 전송

-> 데이터 전송 상황은 크게 4가지

• 정적 데이터 조회: 이미지, 정적 텍스트 문서
• 동적 데이터 조회: 주로 검색, 게시판 목록에서 정렬 필터(검색어)
• HTML Form 통한 데이터 전송: 회원가입, 상품 주문, 데이터 변경
• HTTP API 통한 데이터 전송: 회원가입, 상품 주문, 데이터 변경 + 서버to서버, 앱 클라이언트, 웹 클라이언트

2. 정적 데이터 조회

-> 쿼리 파라미터 미사용 ( 그렇다고 메시지 바디를 사용하지도 않아 -> 조회는 GET 메서드이기 때문)

=> 단순 URI(경로) 만으로 조회 가능한 경우에 해당

 

3. 동적 데이터 조회 (GET메서드 사용)

-> 쿼리 파라미터 사용. 아래와 같은 URI를 통해 접속: 서버로 HTTP message 던진다.

 

-> 주로 검색, 게시판 목록에서 정렬필터 (검색어)

-> 조회 조건을 줄여주는 필터, 조회 결과를 정렬하는 정렬 조건에 주로 사용

 

 

4. HTML Form 통한 데이터 전송 (POST 메서드)

메시지 바디 통해 전송

-> html form 태그 내부에 값을 입력하여 저장까지 할 경우: 메시지 바디를 통해 전송

-> POST 메서드로 접근하여 값을 서버에 전송한다. -> 이 경우 kim, 20값은 서버에 저장된다.

 

-> Content-Type: applications/x-www-form-urlencoded 사용

• form의 내용을 메시지 바디를 통해 전송 (쿼리 파라미터 형식)
• 전송 데이터를 url encoding 처리

5. HTML Form 통한 데이터 전송 (POST 메서드) + multipart/form-data

• 텍스트 데이터 뿐만 아니라 파일 업로드 필요한 경우, form태그 내부에 선언해준다.

<form enctype = 'multipart/form-data'>
...
</form>

• 다른 종류의 여러 파일과 폼의 내용을 함께 전송 가능 (multipart)

 

6. HTML Form 통한 데이터 전송 (GET 메서드)

-> 단순 조회의 경우, form 태그를 사용하여 입력한 값을 조회할 수 있다.

-> 단, POST 메서드 처럼 값을 서버에 저장할 순 없다 (GET은 리소스 변경(생성)이 발생하는 곳에서 사용할 수 없기 때문)

 

7. 즉, HTML form 전송은 GET, POST만 지원

 

8. HTTP API 데이터 전송

 

 

HTTP API 설계 예시

9. EX) 회원 관리 시스템 - POST 기반 등록

• 클라이언트는 등록될 리소스(회원)의 URI를 모른다.
• 즉, 서버가 새로 등록된 리소스 URI를 생성해준다. (ex /members/100 <- 이 100이라는 리소스는 서버에 의해 생성된 것)
• 이를 컬렉션이라 부르며, 서버가 관리하는 리소스 디렉토리를 뜻한다. (여기서 컬렉션은 /members)

10. ex) 파일 관리 시스템 - PUT 기반 등록

-> 클라이언트가 리소스 URI를 알고 있어야 한다 (POST처럼 서버가 URI를 생성해주지 않는다, 클라이언트가 직접 URI 지정).

• 파일 등록 /files/{filename} -> PUT
• PUT /files/jpa.jpg  (클라이언트가 어떤 파일을 등록하는 것이기에 당연히 URI를 직접 지정할 수 있어야한다)
• 컬렉션과 대응되는 개념으로 스토어(store)를 사용 -> 클라이언트가 관리하는 리소스 저장소를 뜻한다

11. ex) HTML FORM 사용

-> GET, POST 메소드만 지원한다 

-> GET, POST 메소드만 사용하기에 '삭제'의 경우 URI를 /members/{id}/delete 처럼 작성해야 한다 (한계)

-> 이러한 한계를 해결하기 위해 컨트롤 URI 도입

 

12. 컨트롤 URI

-> POST, GET으로는 해결하기 어려운 부분은 동사를 직접 사용하여 URI 설계

-> POST의 /new, /edit, /delete 가 컨트롤 URI에 해당

 

13. 정리

-> 개발할 때 대부분의 경우는 컬렉션 기반의 URI로 설계

-> 아래 참고 문서에서 해당 내용을 더 공부할 수 있다.

 

참고: restfulapi.net/resource-naming/