[스프링 MVC] - 14. HTTP message body 를 통한 데이터 요청

 

 

HTTP 요청 메시지 - 단순 텍스트

 

  

요청 파라미터와 다르게, HTTP 메시지 바디를 통해 데이터가 직접 넘어오는 경우는

 

@RequestParam , @ModelAttribute 를 사용할 수 없다.

 

 

 

 

InputStream

ServletInputStream inputStream = request.getInputStream();
String messageBody = StreamUtils.copyToString(inputStream, StandardCharsets.UTF_8);

log.info("messageBody={}",messageBody);

 

HTTP 메시지 바디의 데이터를 InputStream 을 사용해서 직접 읽을 수 있다.

 

 

 

@PostMapping("/request-body-string-v2")
public void requestBodyString(InputStream inputStream, Writer responseWriter) throws IOException {

    String messageBody = StreamUtils.copyToString(inputStream, StandardCharsets.UTF_8);
    log.info("messageBody={}",messageBody);
    responseWriter.write("OK");

 

InputStream(Reader): HTTP 요청 메시지 바디의 내용을 직접 조회

 

OutputStream(Writer): HTTP 응답 메시지의 바디에 직접 결과 출력

 

 

 

HttpEntity

 

@PostMapping("/request-body-string-v3")
public HttpEntity<String> requestBodyStringV3(HttpEntity<String> httpEntity) throws IOException {

    String messageBody = httpEntity.getBody();
    log.info("messageBody={}",messageBody);

    return new HttpEntity<>("OK");
}

 

 HTTP header, body 정보를 편리하게 조회 / 메시지 바디 정보를 직접 조회

 

 

 

@RequestBody / @ResponseBody

 

@ResponseBody
@PostMapping("/request-body-string-v4")
public String requestBodyStringV4(@RequestBody String messageBody){
    
    log.info("messageBody={}",messageBody);
    return "OK";
}

 

 

@RequestBody : HTTP 메시지 바디를 직접 조회하는 기능

 

@ResponseBody : 응답 결과를 HTTP 메시지 바디에 직접 담아서 전달

 

 

 

 

요청 파라미터를 조회하는 기능: @RequestParam , @ModelAttribute


HTTP  메시지 바디를 직접 조회하는 기능 : @RequestBody

 

 

 

HTTP 요청 메시지 - JSON

 

ServletInputStream inputStream = request.getInputStream();
String messageBody = StreamUtils.copyToString(inputStream, StandardCharsets.UTF_8);

 

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

 

 

private ObjectMapper objectMapper = new ObjectMapper();
HelloData helloData = objectMapper.readValue(messageBody, HelloData.class);

 

문자로 된 JSON 데이터를 Jackson 라이브러리인 objectMapper 를 사용해서 자바 객체로 변환한다.

 

JSON 파일을 Java 객체로 deserialization 하기 위해서는 ObjectMapper의 readValue() 메서드를 이용한다.

 

문자로 된 JSON 데이터인 messageBody 를 objectMapper 를 통해서 자바 객체로 변환한다.

 

 

# 참고 : ObjectMapper (JSON 파싱)

ObjectMapper

 

ObjectMapper를 이용하면 JSON을 Java 객체로 변환

 

반대로 Java 객체를 JSON 객체로 serialization 할 수 있다.

 

 

Java Object → JSON

 

Java 객체를 JSON으로 serialization 하기 위해서는 ObjectMapper의 writeValue() 메서드를 이용한다.

 

// Java Object ->  JSON
        Person person = new Person("zooneon", 25, "seoul");
        try {
            objectMapper.writeValue(new File("src/person.json"), person);
        } catch (IOException e) {
            e.printStackTrace();
        }

위와 같이 파라미터로 JSON을 저장할 파일과 직렬화시킬 객체를 넣어주면 된다.

 

JSON → Java Object

 

JSON 파일을 Java 객체로 deserialization 하기 위해서는 ObjectMapper의 readValue() 메서드를 이용한다.

 

// JSON -> Java Object
        String json = "{\"name\":\"zooneon\",\"age\":25,\"address\":\"seoul\"}";
        try {
            Person deserializedPerson = objectMapper.readValue(json, Person.class);
            System.out.println(deserializedPerson);
        } catch (JsonProcessingException e) {
            e.printStackTrace();
        }

위와 같이 파라미터로 JSON 형태의 문자열 or 객체와 역직렬화 시킬 클래스를 넣어주면 된다.

 

 

 

 

@RequestBody 객체 변환

 

@ResponseBody
@PostMapping("request-body-json-v3")
public String requestBodyJsonV3(@RequestBody HelloData helloData) throws IOException {
    log.info("username={}, age={}",helloData.getUsername(),helloData.getAge());
    return "OK";
}

 

@RequestBody 에 직접 만든 객체를 지정할 수 있다.

 

 

@RequestBody는 생략 불가능

 

HelloData에 @RequestBody 를 생략하면 @ModelAttribute 가 적용되어버린다.

따라서 생략하면 HTTP 메시지 바디가 아니라 요청 파라미터를 처리하게 된다.

 

 

 

@ModelAttribute

 

요청 파라미터를 받아서 필요한 객체를 만들고 그 객체에 값을 넣어준다 

 

요청 파라미터의 이름으로 HelloData 객체의 프로퍼티를 찾는다.

 

 

 

@ResponseBody 

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

 

 

응답의 경우에도 @ResponseBody 를 사용하면 해당 객체를 HTTP 메시지 바디에 직접 넣어줄 수 있다.

 

 

 

@RequestBody 요청

 

JSON 요청 -> HTTP 메시지 컨버터 -> 객체

 

@ResponseBody 응답

 

객체 -> HTTP 메시지 컨버터 -> JSON 응답

 

 

 

 

https://www.inflearn.com/course/%EC%8A%A4%ED%94%84%EB%A7%81-mvc-1/dashboard

스프링 MVC 1편 - 백엔드 웹 개발 핵심 기술 - 인프런 | 강의