Spring

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

130mood 2024. 5. 20. 17:12

HTTP message body에 데이터를 직접 담아서 요청

- HTTP API에서 주료 사용 JSON, XML, TEXT

- 데이터 형식은 주로 JSON 사용

- POST, PUT, PATCH

 

요청 파라미터와 다르게, HTTP 메시지 바디를 통해 데이터가 직접 넘어오는 경우 @RequestParam, @ModelAttribute를 사용할 수 없다.(물론 HTML Form 형식으로 전달되는 경우는 요청 파라미터로 인정된다.)

 

먼저 가장 단순한 텍스트 메세지를 HTTP 메세지 바디에 담아서 전송하고, 읽어보자

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

 

requsetBodyString - v1

    @PostMapping("/request-body-string-v1")
    public void requestBodyString(HttpServletRequest request, HttpServletResponse response) throws IOException {

        ServletInputStream inputStream = request.getInputStream();
        String messageBody = StreamUtils.copyToString(inputStream, StandardCharsets.UTF_8);
        log.info("messageBody={}", messageBody);
        response.getWriter().write("ok");
    }

 

Postman을 사용해서테스트 해보자

POST :  http://localhost:8080/request-body-string-v1

BODY : row, Text 선택

 

requsetBodyString - v2

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

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

스프링 MVC는 다음 파라미터를 지원한다.

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

- OutPutStream(Writer) : HTTP 응당 메시지의 바디에 직접 결과 출력

 

requsetBodyString - v3

    @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");
    }

스프링은 MVC는 다음 파라미터를 지원한다.

HttpEntity : HTTP header, body 정보를 편리하게 조회

- 메시지 바디 정보를 직접 조회

- 요청 파라미터를 조회하는 기능과 관계 없음

 

HttpEntity는 응답에도 사용 가능

- 메시지 바디 정보 직접 반환

- 헤더 정보 포함 가능

- view 조회 x

 

requsetBodyString - v4

    @ResponseBody
    @PostMapping("/request-body-string-v4")
    public String requestBodyStringV4(@RequestBody String messageBody) {

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

        return "ok";
    }

@RequestBody

HTTP 메시지 바디 정보를 편리하게 조회할 수 있다. 참고로 헤더 정보가 필요하다면 @RequstHeader를 사용하면 된다.

 

해당 내용은 김영한님의 인프런 강의 "스프링 MVC 1편"을 참고하여 정리한 글 입니다.