HTTP 메서드 활용

Single Ko·2023년 4월 3일

http

목록 보기

6/15

본 자료는 김영한님의 강의 모든 개발자를 위한 HTTP에서 내용을 정리한것입니다.

클라이언트에서 서버로 데이터 전송

쿼리 파라미터를 통한 데이터 전송 : GET , 주로 정렬 필터(검색어)
메시지 바디를 통한 데이터 전송 : POST PUT PATCH , 회원 가입, 상품 주문, 리소스 등록, 리소스 변경

1)정적 데이터 조회

이미지, 정적 텍스트 문서 , 단순 경로만으로 조회 가능.

2)동적 데이터 조회 -> 쿼리 파라미터 사용.

?key=value&key=value 식으로… 쿼리 파라미터를 기반으로 정렬 필터해서 결과를 동적 생성.
주로 검색, 게시판 목록에서 정렬필터.
조회는 GET => GET은 쿼리 파라미터를 사용해서 전달.

3)HTML Form 데이터 전송 -(POST, GET만 지원)

웹 브라우저가 Form의 데이터를 읽어서 HTTP 메시지 생성.
전송 데이터를 url encoding 처리해서 보냄. ex)abc김 -> abc%EA%B9%80

  POST /save HTTP/1.1
  HOST: localhost:8080
  Content-Type : application/x-www-form-urlencoded
  
  username=kim&age=20

GET /members?username=kim&age=20 HTTP/1.1
HOST: localhost:8080

multipart/form-data : 파일 업로드 같은 바이너리 데이터 전송시 사용.
다른 종류의 여러 파일과 폼의 내용 함께 전송 가능.

HTTP API 데이터 전송

형식

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

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

어디서 사용 하나?

서버 to 서버 : 백엔드 시스템 통신
앱 클라이언트 : 아이폰, 안드로이드
웹 클라이언트 : HTML에서 Form 전송 대신 Js를 통한 통신에 사용(AJAX) ex) React, VueJs같은 웹 클라이언트와 API 통신
POST,PUT,PATCH : 메시지 바디를 통해 데이터 전송
GET : 조회, 쿼리 파라미터로 데이터 전달
Content-Type : application/json을 주로 사용. (사실상 표준) TEXT, XML, JSON등...

HTTP API 설계 예시

HTTP API - 컬렉션 (post기반 등록)
HTTP API - 스토어 (put 기반 등록)
HTML FORM 사용 - (get, post만 지원)

API 설계 예제 - 회원 관리 시스템

API 설계 - POST 기반 등록

 회원 목록 /members -> GET
 회원 등록 /members -> POST
 회원 조회 /members/{id} -> GET
 회원 수정 /members/{id} -> PATCH(개념적으로 좋다.), PUT(완전히 덮어 쓰는 상황일때. 게시판 글 수정등..), POST(애매할때)
 회원 삭제 /members/{id} -> DELETE

POST - 신규 자원 등록 특징

클라이언트는 등록될 리소스의 URI를 모른다
서버가 새로 등록된 리소스 URI를 생성해준다.
컬렉션(Collection)
- 서버가 관리하는 리소스 디렉토리.
- 서버가 리소스의 URI를 생성하고 관리.
- 여기서 컬렉션은 /members

API 설계 - PUT 기반 등록

파일 목록 /files -> GET
파일 조회 /files/{filename} -> GET
파일 등록 /files/{filename} -> PUT (없으면 생성, 있으면 덮어쓴다.)
파일 삭제 /files/{filename} -> DELETE
파일 대량 등록 /files -> POST

PUT - 신규 자원 등록 특징

클라이언트가 리소스 URI를 알고 있어야 한다.
- 파일 등록 /files/{filename} -> put
- PUT /files/star.jpg
클라이언트가 직접 리소스의 URI를 지정한다.
스토어(Store)
- 클라이언트가 관리하는 리소스 저장소
- 클라이언트가 리소스의 URI를 알고 관리
- 여기서 스토어는 /files

보통 컬렉션 기반의 POST 방식을 더 많이 사용한다.

HTML FORM 사용

HTML FORM은 GET, POST만 지원

 회원 목록 	/members -> GET
 회원 등록 폼 /members/new -> GET
 회원 등록 	/members/new, /members -> POST
 회원 조회 	/members/{id} -> GET
 회원 수정 폼 /members/{id} -> POST
 회원 수정 	/members/{id}/edit, /members/{id} -> POST
 회원 삭제 	/members/{id}/delete -> POST

컨트롤 URI
- GET, POST만 지원하므로 제약이 있음.
- 이런 제약을 해결하기 위해 동사로 된 리소스 경로 사용
- POST의 /new, /edit, /delete가 컨트롤 URI
- HTTP 메서드로 해결하기 애매한 경우 사용(HTTP API도 포함)
정리 - URI 설계 개념

문서 : 단일 개념(파일 하나, 객체 인스턴스, 데이터베이스 row)
예) /members/100, /files/star.jpg
컬렉션 : 서버가 관리하는 리소스 디렉터리. 서버가 리소스의 URI를 생성 관리
예) /members
스토어 : 클라이언트가 관리하는 자원 저장소. 클라이언트가 리소스의 URI를 알고 관리
예) /files
컨트롤러, 컨트롤URI : 문서, 컬렉션, 스토어로 해결하기 어려운 추가 프로세스 실행. 동사를 직접 사용
예) /members/{id}/delete

참고하면 좋은 사이트