Spring 요청 데이터 3

HttpEntity

HttpEntity는 HTTP Header, Body 정보를 편리하게 조회할 수 있도록 만들어준다.

• HttpEntity 역할

  1. Http Request Body Message를 직접 조회한다
  2. Request 뿐만 아니라 Response도 사용할 수 있도록 만들어준다.
  3. Response Header 또한 사용할 수 있다.
  4. Request Parameter를 조회하는 기능들과는 아무 관계가 없다.
  5. View를 반환하지 않는다.

• HttpEntity를 상속받은 객체

  • RequestEntity<>
    • HTTP Request Method, URL 정보가 추가 되어있다.
  • ResponseEntity<>
    • HTTP Response 상태 코드 설정이 가능하다.
  • 코드 예시

@Controller
public class RequestBodyStringController {
	
	@PostMapping("/v4/request-body-text")
  public HttpEntity<String> requestBodyTextV4(RequestEntity<String> httpEntity) {

      // HttpMessageConverter가 동작해서 아래 코드가 동작하게됨
      String body = httpEntity.getBody();
      // url, method 사용 가능

      return new ResponseEntity<>("response = " + body, HttpStatus.CREATED); // Body Data, 상태코드
  }

}

• Postman
  
• 위 방법을 적용해도 불편하다.
  • Data를 httpEntity에서 꺼내어 사용해야 한다.

Spring은 Http RequestBody Message를 읽어서 String이나 Object로 자동으로 변환해준다.
이때 HttpMessageConverter가 사용된다.

@RequestBody, @ResponseBody

Spring에서 @RequestBody, @ResponseBody 어노테이션을 사용하면 각각 Request, Response 객체의 Body에 편하게 접근하여 사용할 수 있다.

• 코드 예시

@Controller // @RestController = @Controller + @ResponseBody
public class RequestBodyStringController {
	
  @ResponseBody
  @PostMapping("/v5/request-body-text")
  public String requestBodyTextV5(
          @RequestBody String body,
          @RequestHeader HttpHeaders headers
  ) {
      // HttpMessageConverter가 동작해서 아래 코드가 동작하게됨
      String bodyMessage = body;

      return "request header = " + headers + " response body = " + bodyMessage;
  }
}

• Postman
  

• @RequestBody

  • 요청 메세지 Body Data를 쉽게 조회할 수 있다.

• @RequestHeader

  • 요청 헤더 정보 조회

• @ResponseBody

  • 응답 메세지 바디에 값을 쉽게 담아서 전달할 수 있도록 해준다.
  • View가 아닌 데이터를 반환한다.

• 요약

  1. 요청 파라미터, HTML Form Data에 접근하는 경우
     • @RequestParam, @ModelAttribute 를 사용한다.
  2. Http Message Body에 접근하는 경우
     • @RequestBody를 사용한다. (JSON, XML, TEXT)