ResponseEntity란?

• HttpRequest를 응답하기 위해 httpEntity를 상속받아 HttpStatus, HttpHeaders, HttpBody를 정의하여 사용하는 클래스
  • Http는 단순한 데이터 전송이 아니라 상태 정보를 포함한 통신 프로토콜이기 때문에, 올바른 상태 코드와 헤더를 제공해야 클라이언트가 적절히 반응할 수 있다.

ResponseEntity 생성 두 방식

1. 생성자 방식

   return new ResponseEntity<>(responseBody, headers, HttpStatus.OK);
   

   → 상태/헤더/바디를 명시적으로 전달

   • 보기

2. 빌더(메서드 체이닝) 방식

   return ResponseEntity.ok().headers(headers).body(responseBody);
   

   → 가독성 좋고 요즘 선호

   • 보기

   사용 패턴:

   • ok() → 200
   • created(URI) → 201 + Location
   • noContent() → 204
   • headers(...), contentType(...), body(...), build() 조합

제네릭 와일드카드 ResponseEntity<?>

• 바디가 없거나, 반환 타입을 고정하고 싶지 않을 때 사용
• .build()로 끝나면 실제 바디는 없음

Content-Type과 인코딩

• MediaType("application","json", Charset.forName("UTF-8"))로 명시적 지정
• 스프링부트 기본도 JSON 응답엔 UTF-8을 사용하므로, 명시가 없어도 문제는 거의 없음

REST 의미론

• POST /users: 새 리소스 생성 → 보통 201 + Location
• GET /users/{id}: 조회 → 200
• PUT /users/{id}: 업데이트 → 200/204(수정) 또는 201(신규 생성)
• DELETE /users/{id}: 삭제 → 204

요청/응답 시나리오