Spring RequestBody 및 ResponseBody

1. @RequestBody

@RequestBody 주석은 HttpRequest 본문을 전송 또는 도메인 객체에 매핑하여 인바운드 HttpRequest 본문을 Java 객체로 자동 역 직렬화할 수 있도록 한다.

Spring 컨트롤러 메서드를 확인한다.

@PostMapping("/request")
public ResponseEntity postController(
  @RequestBody LoginForm loginForm) {

    exampleService.fakeAuthenticate(loginForm);
    return ResponseEntity.ok(HttpStatus.OK);
}

Spring은 적절한 유형이 지정되었다고 가정하고 자동으로 JSON을 Java 유형으로 역직렬화한다.

기본적으로 @RequestBody 주석으로 주석을 다는 유형은 클라이언트 측 컨트롤러에서 보낸 JSON과 일치해야 한다.

public class LoginForm {
    private String username;
    private String password;
    // ...
}

HttpRequest 본문을 나타내는데 사용하는 개체는 LoginForm 개체에 매핑된다.

CURL을 사용하여 이것을 테스트한다.

curl -i \
-H "Accept: application/json" \
-H "Content-Type:application/json" \
-X POST --data 
  '{"username": "johnny", "password": "password"}' "https://localhost:8080/.../request"

@RequestBody 주석을 사용하는 Spring REST API 및 Angular 클라이언트에 필요한 전부이다.

2. @ResponseBody

@ResponseBody 주석은 반환된 개체가 자동으로 JSON으로 직렬화되고 HttpResponse 개체로 다시 전달됨을 컨트롤러에 알린다.

사용자 지정 Response 개체가 있다.

public class ResponseTransfer {
    private String text;
    
    // standard getters/setters
}

관련 컨트롤러를 구현할 수 있다.

@Controller
@RequestMapping("/post")
public class ExamplePostController {

    @Autowired
    ExampleService exampleService;

    @PostMapping("/response")
    @ResponseBody
    public ResponseTransfer postResponseController(
      @RequestBody LoginForm loginForm) {
        return new ResponseTransfer("Thanks For Posting!!!");
     }
}

브라우저의 개발자 콘솔에서 또는 Postman과 같은 도구를 사용하여 다음 응답을 볼 수 있다.

{"text":"Thanks For Posting!!!"}

Spring이 기본적으로 수행하기 때문에 @RestController 주석이 달린 컨트롤러에 @ResponseBody 주석을 달 필요가 없다.

1) 콘텐츠 유형 설정

@ResponseBody 어노테이션을 사용할 때 여전히 메서드가 반환하는 콘텐츠 유형을 명시적으로 설정할 수 있다.

이를 위해 @RequestMapping의 생성 속성을 사용할 수 있다. @PostMapping, @GetMapping 등과 같은 주석은 해당 매개변수의 별칭을 정의한다.

JSON 응답을 보내는 새 끝점을 추가한다.

@PostMapping(value = "/content", produces = MediaType.APPLICATION_JSON_VALUE)
@ResponseBody
public ResponseTransfer postResponseJsonContent(
  @RequestBody LoginForm loginForm) {
    return new ResponseTransfer("JSON Content!");
}

예제에서는 MediaType.APPLICATION_JSON_VALUE 상수를 사용했다. 또는 application/json을 직접 사용할 수 있다.

다음으로 동일한 /content 경로에 매핑되지만 대신 XML 콘텐츠를 반환하는 새 메서드를 구현해본다.

@PostMapping(value = "/content", produces = MediaType.APPLICATION_XML_VALUE)
@ResponseBody
public ResponseTransfer postResponseXmlContent(
  @RequestBody LoginForm loginForm) {
    return new ResponseTransfer("XML Content!");
}

이제 요청 헤더에서 전송된 Accept 매개변수 의 값에 따라 다른 응답을 받게 된다.

curl -i \ 
-H "Accept: application/json" \ 
-H "Content-Type:application/json" \ 
-X POST --data 
  '{"username": "johnny", "password": "password"}' "https://localhost:8080/.../content"

CURL 명령은 JSON 응답을 반환한다.

HTTP/1.1 200
Content-Type: application/json
Transfer-Encoding: chunked
Date: Thu, 20 Feb 2020 19:43:06 GMT

{"text":"JSON Content!"}

Accept 매개변수를 변경해 본다.

curl -i \
-H "Accept: application/xml" \
-H "Content-Type:application/json" \
-X POST --data
  '{"username": "johnny", "password": "password"}' "https://localhost:8080/.../content"

이번에는 XML 콘텐츠를 얻는다.

HTTP/1.1 200
Content-Type: application/xml
Transfer-Encoding: chunked
Date: Thu, 20 Feb 2020 19:43:19 GMT

<ResponseTransfer><text>XML Content!</text></ResponseTransfer>

[출처 및 참고]

• https://www.baeldung.com/spring-request-response-body