[HTTP ] 5. HTTP 메서드 활용
2024. 1. 21. 05:15
728x90
SMALL
📌 클라이언트에서 서버로 데이터 전송
⚡ 데이터 전달 방식
- 쿼리 파라미터를 통한 데이터 전송
- GET
- 주로 정렬 필터(검색어)
- 메시지 바디를 통한 데이터 전송
- POST, PUT, PATCH
- 회원가입, 상품 주문, 리소스 등록, 리소스 변경
⚡ 4가지 상황
✔ 정적 데이터 조회
- 이미지, 정적 텍스트 문서
✔ 동적 데이터 조회
- 주로 검색, 게시판 목록에서 정렬 필터(검색어)
✔ HTML Form을 통한 데이터 전송
- 회원가입, 상품 주문, 데이터 변경
✔ HTTP API를 통핸 데이터 전송
- 회원 가입, 상품 주문, 데이터 변경
- 서버 to 서버, 앱 클라이언트, 웹 클라이언트(Ajax)
⚡ 정적 데이터 조회
✔ 쿼리 파라미터 미사용(단순 조회)
- 이미지, 정적 테스트 문서
- 조회는 GET 사용
- 정적 데이터는 일반적으로 쿼리 파라미터 없이 리소스 경로로 단순하게 조회 가능
⚡ 동적 데이터 조회
✔ 쿼리 파라미터 사용
- 주로 검색, 게시판 목록에서 정렬 필터(검색어)
- 조회 조건을 줄여주는 필터, 조회 결과를 정렬하는 정렬 조건에 주로 사용
- 조회는 GET 사용
- GET은 쿼리 파라미터 사용해서 데이터를 전달
⚡ HTML Form 데이터 전송
🔶 POST 전송 - 저장
🔶 GET 전송 - 저장
🔶 GET 전송 - 조회
🔶 multipart/form-data
- HTML Form submit시 POST 전송
- ex) 회원가입, 상품주문, 데이터변경
- Content-Type : application/x-www-form-urlencoded 사용
- form의 내용을 메시지 바디를 통해서 전송(key = value, 쿼리 파라미터 형식)
- 전송 데이터를 url encoding 처리
- ex) abc김-> abc%EA%B9%80
- HTML Form은 GET 전송도 가능
- Content-Type : multipart/form-data
- 파일 업로드 같은 바이너리 데이터 전송시 사용
- 다른 종류의 여러 파일과 폼의 내용 함께 전송 가능(그래서 이름이 multipart)
💡cf) HTML Form 전송은 GET, POST만 지원
⚡ HTTP API 데이터 전송
- 서버 to 서버
- 백엔드 시스템 통신
- 앱 클라이언트
- 아이폰, 안드로이드
- 웹 클라이언트
- HTML에서 Form 전송 대신 자바스크립트를 통한 통신에 사용(AJAX)
- ex) React, VueJs같은 웹 클라이언트와 API 통신
- POST, PUT, PATCH : 메시지 바디를 통해 데이터 전송
- GET : 조회, 쿼리 파라미터로 데이터 전달
- Content-Type : application/json을 주로 사용(사실상 표준)
- TEXT, XML, JSON 등등
반응형
📌 HTTP API에서 설계 예시
- HTTP API - 컬렉션
POST
기반 등록- ex) 회원 관리 API 제공
- HTTP API - 스토어
PUT
기반 등록- ex) 정적 컨텐츠 관리, 원격 파일 관리
- HTML FORM 사용
- 웹페이지 회원 관리
GET
,POST
만 지원
⚡ 회원 관리 시스템
API 설계 - POST 기반 등록
회원 목록 /memebers -> GET
회원 등록 /members -> POST
회원 조회 /members/{id} -> GET
회원 수정 /members/{id} -> PATCH, PUT, POST
회원 삭제 /members/{id} -> DELETE
POST - 신규 자원 등록 특징
- 클라이언트는 등록될 리소스의 URI를 모름
- 회원 등록
/members
->POST
- POST /members
- 회원 등록
- 서버가 새로 등록된 리소스 URI를 생성해줌 (클라이언트가 결정하는 것이 아님)
HTTP/1.1 201 Created Location : /members/100
- 컬렉션(Collection)
- 서버가 관리하는 리소스 디렉토리
- 서버가 리소스의 URI를 생성하고 관리
- 여기서 컬렉션은 /members
⚡ 파일 관리 시스템
API 설계 - PUT 기반 등록
파일 목록 /files -> GET
파일 조회 /files/{filename} -> GET
파일 등록 /files/{filename} -> PUT
파일 삭제 /files/{filename} -> DELETE
파일 대량 등록 /files/{filename} -> POST
PUT - 신규 자원 등록 특징
- 클라이언트가 리소스 URI를 알고 있어야 함
- 파일 등록 /files/{filename} -> PUT
- PUT /files/star.jpg
- 클라이언트가 직접 리소스의 URI를 지정
- 스토어(Store)
- 클라이언트가 관리하는 리소스 저장소
- 클라이언트가 리소스의 URI를 알고 관리
- 여기서 스토어는 /files
✔ POST : 클라이언트가 서버에 요청
✔ PUT : 클라이언트가 등록된 리소스 URI를 직접 관리
⚡ HTML FORM 사용
회원 목록 /memebers -> 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
- 여기서는 순수 HTML, HTML FORM 이야기
- HTML FORM은
GET
,POST
만 지원 -> 제약이 있음 - AJAX 같은 기술을 사용해서 해결 가능 -> 회원 API 참고
- 회원 등록 폼과 회원 등록의 URL 경로를 맞추는 방법 선호
- 회원 삭제에서 DELETE를 사용못하므로
/delete
같은 control URI 사용
Control URI
- GET, POST만 지원하므로 제약이 있음
- 동사로 된 리소스 경로 사용
- POST의
/new
,/edit
,/delete
가 컨트롤 URI - HTTP 메서드로 해결하기 애매한 경우 사용(HTTP API 포함)
⚡ 정리
- HTTP API - 컬렉션
POST
기반 등록- 서버가 리소스 URI 결정
- HTTP API - 스토어
PUT
기반 등록- 클라이언트가 리소스 URI 결정
- HTML FORM 사용
- 순수 HTML + HTML form 사용
GET
,POST
만 지원
참고하면 좋은 URI 설계 개념
🔶 https://restfulapi.net/resource-naming
- 문서(document)
- 단일 개념(파일 하나, 객체 인스턴스, 데이터 베이스 row)
- ex)
/members/100
,/files/star.jpg
- 컬렉션(collection)
- 서버가 관리하는 리소스 디렉터리
- 서버가 리소스의 URI를 생성하고 관리
- ex)
/members
- 스토어(store)
- 클라이언트가 관리하는 자원 저장소
- 클라이언트가 리소스의 URI를 알고 관리
- ex)
/files
- 컨트롤러(controller), 컨트롤러 URI
- 문서, 컬렉션, 스토어로 해결하기 어려운 추가 프로세스 실행
- 동사를 직접 사용
- ex)
/members/{id}/delete
<모든 개발자를 위한 HTTP 웹 기본 지식_김영한>을 수강하고 참고하여 작성한 글입니다.
PREV
NEXT
728x90
LIST
'인프런 Spring 강의 정리 > 모든 개발자를 위한 HTTP 웹 기본 지식' 카테고리의 다른 글
[HTTP ] 7. HTTP 헤더(1) - 일반 헤더 (1) | 2024.01.21 |
---|---|
[HTTP ] 6. HTTP 상태코드 (0) | 2024.01.21 |
[HTTP ] 4. HTTP 메서드 (0) | 2024.01.21 |
[HTTP ] 3. HTTP 기본 (1) | 2024.01.21 |
[HTTP ] 2. URI와 웹 브라우저 요청 흐름 (0) | 2024.01.21 |