ResponseEntity 도입으로 REST API HTTP 응답 제어력 향상됨

Context

기존 @GetMapping 메서드가 List 타입을 직접 반환함. Spring이 자동으로 200 OK 상태 코드를 설정하지만, 응답 구조를 개발자가 직접 제어할 수 없는 한계가 있음. 에러 응답이나 다른 HTTP 상태 코드를 반환해야 하는 경우 유연하게 대응하기 어려움.

Technical Solution

• ResponseEntity<List>: 완전한 HTTP 응답 객체를 반환 타입으로 지정함
• ResponseEntity.ok(tasks): 명시적으로 200 OK 상태 코드와 함께 응답 본문을 설정함
• ResponseEntity.notFound().build(): 404 Not Found 응답을 반환하는 메서드를 제공함
• ResponseEntity.noContent().build(): 204 No Content 응답을 반환하는 메서드를 제공함
• 서비스 계층에서 조회한 List를 ResponseEntity로 감싸서 컨트롤러에서 HTTP 레벨 제어를 가능하게 함

Impact

수치 데이터 없음

Key Takeaway

ResponseEntity를 사용하면 HTTP 상태 코드, 헤더, 본문을 개발자가 직접 제어할 수 있음. RESTful API에서 명확한 응답 구조와 일관된 에러 처리가 가능해짐.