@PathVariable과 @RequestBody의 차이

학습하는 분들께 도움이 되고, 더 좋은 답변을 드릴 수 있도록 질문전에 다음을 꼭 확인해주세요.

1. 강의 내용과 관련된 질문을 남겨주세요.
2. 인프런의 질문 게시판과 자주 하는 질문(링크)을 먼저 확인해주세요.
(자주 하는 질문 링크: https://bit.ly/3fX6ygx)
3. 질문 잘하기 메뉴얼(링크)을 먼저 읽어주세요.
(질문 잘하기 메뉴얼 링크: https://bit.ly/2UfeqCG)

질문 시에는 위 내용은 삭제하고 다음 내용을 남겨주세요.
=========================================
[질문 템플릿]
1. 강의 내용과 관련된 질문인가요? (예/아니오)
2. 인프런의 질문 게시판과 자주 하는 질문에 없는 내용인가요? (예/아니오)
3. 질문 잘하기 메뉴얼을 읽어보셨나요? (예/아니오)

[질문 내용]
여기에 질문 내용을 남겨주세요.

@PatchMapping("/api/v2/members/{id}")
public UpdateMemberResponse updateMember(@PathVariable("id") Long id,
                                         @RequestBody @Valid UpdateMemberRequest updateMemberRequest) {

수정 api는 위와 같은 주소를 이용합니다.

근데 사실 UpdateMemberRequest에 id라는 필드를 넣고 주소를 /api/v2/members 로 둬도 상관 없지 않나요?

id를 PathVariable로 뺀 이유가 궁금합니다

안녕하세요, 인프런 AI 인턴입니다. 집이좋아님.

질문해 주신 내용에 대한 답변을 드리겠습니다. @PathVariable과 @RequestBody 사용의 차이는, API 설계와 관련이 있습니다.

@PathVariable: URL 경로에 포함되는 변수를 사용해서 리소스를 지정하는 경우에 활용됩니다. RESTful 설계 원칙에 따라 리소스를 명확히 식별하는데 유리합니다. URL 경로에 포함되기 때문에 클라이언트가 쉽게 구분할 수 있습니다.
@RequestBody: HTTP 요청의 본문에서 데이터를 추출해야 할 때 사용됩니다. 주로 JSON 포맷의 데이터 처리가 필요할 때 사용되며, 흔히 여러 속성을 가진 객체를 사용할 때 유용합니다.

id를 @PathVariable로 사용하는 이유는 RESTful API의 관점에서 리소스를 명확하게 식별하기 위함입니다. API 설계 원칙에 따라 리소스를 경로를 통해 식별하는 것이 명확하고 이해하기 쉬우며, 직관적입니다. 반면, UpdateMemberRequest 객체에 id 필드를 추가할 수 있지만, 이는 일반적으로 데이터 변경의 세부사항으로 사용되며 리소스 식별자가 아닌 경우가 많습니다.

이와 관련된 토론은 여러 번 있어서, 보다 명확한 이해를 돕기 위해 관련 링크들을 제공합니다:

8:41 질문: 업데이트된 정보를 가져오는 방식에 대한 토론.
select 쿼리없이 dto 만들지 않은 이유: 데이터베이스 조회의 필수성에 대한 논의.

이 게시물들은 API 설계와 관련된 논의를 포함하고 있으니 참조하시면 좋겠습니다.

저는 질문자님의 이해를 돕고자 지식공유자님의 기존 답변을 참고하여 유사한 답변 링크를 추천해드리고 있습니다. 현재 베타 기능으로 답변이 만족스럽지 않을 수 있는 점 양해 부탁드립니다. 🙏 추가적으로 궁금한 점이 있으시면, 이어서 질문해 주세요. 곧 지식공유자께서 답변해 주실 것입니다.

인프런 커뮤니티 질문&답변