HTTP 요청 메시지 - 텍스트

messageBody에 문자를 입력하고 그 문자를 받아오는 코드

 

@Slf4j
@Controller
public class RequestBodyStringController {
    @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");
    }

Http의 Body를 이용해서 메시지를 출력하는 코드이다.

포스트맨에서 messageBody에 hello를 넣고 Send를 눌렀다.

결과적으로 콘솔 창에 messageBody=hello라는 메시지가 출력되었다.

 

 

 

 

 

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

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

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

 

서블릿에서 request와 response를 받아서 사용하지 않아도 InputStream과 OutputStream을 사용할 수 있다.

 

 

 

HttpEntity

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

    String messageBody = httpEntity.getBody();

    log.info("messageBody={}", messageBody);
    
    return new HttpEntity<>("ok");
}

InputStream과 OutputStream 대신 HttpEntity를 사용하면 문자타입 등을 http에서 자동으로 인식하기에

String messageBody = StreamUtils.copyToString(inputStream, StandardCharsets.UTF_8);를 입력하지 않아도 된다.

 

messageBody라는 변수도 httpEntity.getBody()로 body에서 바로 꺼낼 수 있다.

또한 HttpEntity를 반환값으로 사용하기때문에 return도 HttpEntity로 바로 반환할 수 있다.

 

 

 

가장 많이 사용하는 방법

    @ResponseBody // 응답은 @ResponseBody
    @PostMapping("/request-body-string-v3")
    public String requestBodyStringV3(@RequestBody String messageBody) {
				// 요청은 @RequestBody
        log.info("messageBody={}", messageBody);

        return "ok";
    }

단순히 @ResponseBody로 응답을 받고 @RequestBody를 사용해서 HTTP 메시지 바디 정보를 편리하게 조회할 수 있다.

 

 

 

 

요청 파라미터와의 차이점???

요청 파라미터는 쿼리 파라미터 또는 POST 방식으로 html을 전송하는 경우에만 사용하는 것이고, 그 외에 경우에는 HttpEntity를 사용하는 등으로 한다.

 

이 게시글의 메시지 바디를 직접 조회하는 기능은 요청 파라미터를 조회하는 @RequestParam, @ModelAttribute와는 전혀 관계가 없다.

 

헷갈리지 않도록 잘 유의해야한다.