[스프링MVC 기본 기능 8] HTTP 요청 메시지 - JSON

[스프링MVC 기본 기능 7] HTTP 요청 메시지 - 단순 텍스트 (tistory.com)

[스프링MVC 기본 기능 7] HTTP 요청 메시지 - 단순 텍스트

---

 

JSON 형식으로 데이터를 전송해보자.

 

[스프링 MVC 13] 서블릿: HTTP 요청 데이터 - API 메시지 바디 (tistory.com)

[스프링 MVC 13] 서블릿: HTTP 요청 데이터 - API 메시지 바디

@Slf4j
@Controller
public class RequestBodyJsonController {

    //문자로 된 JSON 데이터를 objectMapper (Jackson 라이브러리)를 사용해서 자바 객체로 변환
    private ObjectMapper objectMapper = new ObjectMapper();

    @PostMapping("/request-body-json-v1")
    public void requestBodyJsonV1(HttpServletRequest request, HttpServletResponse response) throws IOException {
        ServletInputStream inputStream = request.getInputStream();
        String messageBody = StreamUtils.copyToString(inputStream, StandardCharsets.UTF_8);

        log.info("messageBody={}", messageBody);
        HelloData data = objectMapper.readValue(messageBody, HelloData.class);
        log.info("username={}, age={}", data.getUsername(), data.getAge());

        response.getWriter().write("ok");
    }

• HttpServletRequest를 사용해서 직접 HTTP 메시지 바디에서 데이터를 읽어와서, 문자로 변환

 

Postman 테스트 결과

 

---

• @RequestBody 문자 변환
  • @RequestBody를 사용해서 HTTP 메시지에서 데이터를 꺼내고 messageBody에 저장
  • StringHttpMessageConverter 적용

@ResponseBody
@PostMapping("/request-body-json-v2")
public String requestBodyJsonV2(@RequestBody String messageBody) throws IOException {
    HelloData data = objectMapper.readValue(messageBody, HelloData.class);
    //문자로된 JSON데이터(messageBody)를 objectMapper를 사용해 자바 객체로 변환 ->v3에선 HttpMessageConverter가 해줌
    log.info("username={}, age={}", data.getUsername(), data.getAge());

    return "ok";
}

• @ResponseBody
  
  • 메시지 바디 정보 직접 반환 (view 조회 X)
  • StringHttpMessageConverter 적용

 

---

문자로 변환하고 다시 json으로 변환하는 과정이 불편하다. @ModelAttribute처럼 한번에 객체로 변환할 수는 없을까?

 

---

• @RequestBody 객체 변환
  • @RequestBody 객체 파라미터 : @RequestBody에 직접 만든 객체를 파라미터로 지정할 수 있다.

@ResponseBody
@PostMapping("/request-body-json-v3")
public String requestBodyJsonV3(@RequestBody HelloData data) {  //@RequestBody에 직접 만든 객체를 지정
    log.info("username={}, age={}", data.getUsername(), data.getAge());
    return "ok";
}

• HttpEntity , @RequestBody 를 사용하면 HTTP 메시지 컨버터가 HTTP 메시지 바디의 내용을 문자나 객체 등으로 변환해준다. HTTP 메시지 컨버터는 문자 뿐만 아니라 JSON도 객체로 변환해준다. (v2의 작업 대신 해줌)
  • MappingJackson2HttpMessageConverter 가 동작 (content-type: application/json)

---

[스프링MVC 기본 기능 6] HTTP 요청 파라미터 - @ModelAttribute (tistory.com)

[스프링MVC 38] 기본 기능: HTTP 요청 파라미터 - @ModelAttribute

• @RequestBody는 생략 불가능!
  • 스프링은 @ModelAttribute , @RequestParam 과 같은 해당 애노테이션을 생략시 다음과 같은 규칙을 적용한다.
    • String , int , Integer 같은 단순 타입 = @RequestParam
    • 나머지 = @ModelAttribute (argument resolver 로 지정해둔 타입 외)
  •  따라서 이 경우 HelloData에 @RequestBody를 생략하면 @ModelAttribute 가 적용되어버린다.
    • HelloData data → @ModelAttribute HelloData data
    • 따라서 생략하면 HTTP 메시지 바디가 아니라 요청 파라미터를 처리하게 된다.

 

---

HTTP 요청시에 content-type이 application/json인지 꼭 확인해야 한다!

그래야 JSON을 처리할 수 있는 HTTP 메시지 컨버터가 실행된다.

 

---

• 물론  HttpEntity를 사용해도 된다.

@ResponseBody
@PostMapping("/request-body-json-v4")
public String requestBodyJsonV4(HttpEntity<HelloData> httpEntity) {
    HelloData data = httpEntity.getBody();
    log.info("username={}, age={}", data.getUsername(), data.getAge());
    return "ok";
}

 

---

• 응답의 경우에도 @ResponseBody를 사용하면 해당 객체를 HTTP 메시지 바디에 직접 넣어줄 수 있다. 물론 이 경우에도 HttpEntity 를 사용해도 된다.
• @RequestBody 요청
  • JSON 요청 → HTTP 메시지 컨버터 → 객체
• @ResponseBody 응답
  • 객체  → HTTP 메시지 컨버터 →  JSON 응답

@ResponseBody
@PostMapping("/request-body-json-v5")
public HelloData requestBodyJsonV5(@RequestBody HelloData data) {
    log.info("username={}, age={}", data.getUsername(), data.getAge());
    return data;
}

• @ResponseBody
  
  • 메시지 바디 정보 직접 반환 (view 조회 X)
  • MappingJackson2HttpMessageConverter 적용 (Accept: application/json)

 

---

---

[스프링MVC 38] 기본 기능: HTTP 요청 파라미터 - @ModelAttribute (tistory.com)

[스프링MVC 38] 기본 기능: HTTP 요청 파라미터 - @ModelAttribute