스프링 MVC 1편 (백엔드 웹 개발 핵심 기술)

Ch06. 스프링 MVC(기본 기능) - HTTP 응답

webmaster 2022. 3. 7. 12:39
728x90
  • 정적 리소스
    • 예) 웹 브라우저에 정적인 HTML, css, js을 제공할 때는, 정적 리소스를 사용한다.
  • 뷰 템플릿 사용
    • 예) 웹 브라우저에 동적인 HTML을 제공할 때는 뷰 템플릿을 사용한다.
  • HTTP 메시지 사용
    • HTTP API를 제공하는 경우에는 HTML이 아니라 데이터를 전달해야 하므로, HTTP 메시지 바디에 JSON 같은 형식으로 데이터를 실어 보낸다

HTTP 응답 - 정적 리소스, 뷰 템플릿

  • 정적 리소스
    • 스프링 부트는 클래스 패스의 다음 디렉터리에 있는 정적 리소스를 제공한다.
      • /static 
      • /public 
      • /resources 
      • /META-INF/resources
    • src/main/resources 는 리소스를 보관하는 곳이고, 또 클래스 패스의 시작 경로이다.
    • 정적 리소스는 해당 파일을 변경 없이 그대로 서비스하는 것이다.
  • 뷰 템플릿
    • 뷰 템플릿을 거쳐서 HTML이 생성되고, 뷰가 응답을 만들어서 전달한다.
    • 스프링 부트는 기본 뷰 템플릿 경로를 제공한다.
      • src/main/resources/templates

뷰 템플릿 생성

<!DOCTYPE html>
<html xmlns:th="http://www.thymeleaf.org">
<head>
 <meta charset="UTF-8">
 <title>Title</title>
</head>
<body>
<p th:text="${data}">empty</p>
</body>
</html>

ResponseViewController

@RequestMapping("/response-view-v1")
public ModelAndView responseViewV1(){
    ModelAndView mav = new ModelAndView("response/hello")
        .addObject("data", "hello!");
    return mav;
}

@RequestMapping("/response-view-v2")
public String responseViewV2(Model model){
    model.addAttribute("data", "hello!");
    return "response/hello";
}

@RequestMapping("/response/hello")
public void responseViewV3(Model model){ //경로의 이름과 뷰의 논리적 이름이 같다면 생략이 가능하다
    model.addAttribute("data", "hello!");
}​
  • String을 반환하는 경우 - View or HTTP 메시지
    • @ResponseBody 가 없으면 response/hello 로 뷰 리졸버가 실행되어서 뷰를 찾고, 렌더링 한다.
    • @ResponseBody 가 있으면 뷰 리졸버를 실행하지 않고, HTTP 메시지 바디에 직접 response/hello라는 문자가 입력된다.
  • Void를 반환하는 경우
    • @Controller 를 사용하고, HttpServletResponse , OutputStream(Writer) 같은 HTTP 메시지 바디를 처리하는 파라미터가 없으면 요청 URL을 참고해서 논리 뷰 이름으로 사용
    • 참고로 이 방식은 명시성이 너무 떨어지고 이렇게 딱 맞는 경우도 많이 없어서, 권장하지 않는다.
  • HTTP 메시지
    • @ResponseBody , HttpEntity를 사용하면, 뷰 템플릿을 사용하는 것이 아니라, HTTP 메시지 바디에 직접 응답 데이터를 출력할 수 있다.
  • Thymeleaf 스프링 부트 설정

HTTP 응답 - HTTP API, 메시지 바디에 직접 입력

  • HTML이나 뷰 템플릿을 사용해도 HTTP 응답 메시지 바디에 HTML 데이터가 담겨서 전달된다. 여기서 설명하는 내용은 정적 리소스나 뷰 템플릿을 거치지 않고, 직접 HTTP 응답 메시지를 전달하는 경우를 말한다.
@GetMapping("/response-body-string-v1")
public void responseBodyV1(HttpServletResponse response) throws IOException {
    response.getWriter().write("ok");
}
  • 서블릿을 직접 다룰 때처럼
    • HttpServletResponse 객체를 통해서 HTTP 메시지 바디에 직접 ok 응답 메시지를 전달한다.
@GetMapping("/response-body-string-v2")
public ResponseEntity<String> responseBodyV2() throws IOException {
    return new ResponseEntity<>("ok", HttpStatus.OK);
}
  • ResponseEntity 엔티티는 HttpEntity를 상속받았는데, HttpEntity는 HTTP 메시지의 헤더, 바디 정보를 가지고 있다.
  • ResponseEntity는 여기에 더해서 HTTP 응답 코드를 설정할 수 있다.
@ResponseBody
@GetMapping("/response-body-string-v3")
public String responseBodyV3(){
    return "ok";
}
  • @ResponseBody를 사용하면 view를 사용하지 않고, HTTP 메시지 컨버터를 통해서 HTTP 메시지를 직접 입력할 수 있다.
  • ResponseEntity 도 동일한 방식으로 동작한다.
@GetMapping("/response-body-json-v1")
public ResponseEntity<HelloData> responseBodyJsonV1(){
    HelloData helloData = new HelloData();
    helloData.setUsername("userA");
    helloData.setAge(20);
    return new ResponseEntity<>(helloData, HttpStatus.OK);
}
  • ResponseEntity를 반환한다. HTTP 메시지 컨버터를 통해서 JSON 형식으로 변환되어서 반환된다.
@ResponseStatus(HttpStatus.OK)
@ResponseBody
@GetMapping("/response-body-json-v2")
public HelloData responseBodyJsonV2(){
    HelloData helloData = new HelloData();
    helloData.setUsername("userA");
    helloData.setAge(20);
    return helloData;
}
  • ResponseEntity는 HTTP 응답 코드를 설정할 수 있는데, @ResponseBody를 사용하면 이런 것을 설정하기 까다롭다.
  • @ResponseStatus(HttpStatus.OK) 애노테이션을 사용하면 응답 코드도 설정할 수 있다.
  • 애노테이션이기 때문에 응답 코드를 동적으로 변경할 수는 없다. 프로그램 조건에 따라서 동적으로 변경하려면 ResponseEntity를 사용하면 된다.

@RestController

@RestController

  • @Controller 대신에 @RestController 애노테이션을 사용하면, 해당 컨트롤러에 모두 @ResponseBody 가 적용되는 효과가 있다.
  • 따라서 뷰 템플릿을 사용하는 것이 아니라, HTTP 메시지 바디에 직접 데이터를 입력한다. 이름 그대로 Rest API(HTTP API)를 만들 때 사용하는 컨트롤러이다.
  • 참고로 @ResponseBody는 클래스 레벨에 두면 전체에 메서드에 적용되는데, @RestController 에노테이션 안에 @ResponseBody 가 적용되어 있다.
728x90

'스프링 MVC 1편 (백엔드 웹 개발 핵심 기술)' 카테고리의 다른 글

Ch06. 스프링 MVC(기본 기능) - 요청 매핑 헨들러 어뎁터 구조  (0) 2022.03.07
Ch06. 스프링 MVC(기본 기능) - HTTP 메시지 컨버터  (0) 2022.03.07
Ch06. 스프링 MVC(기본 기능) - HTTP 요청 파라미터  (0) 2022.03.07
Ch06. 스프링 MVC(기본 기능) - HTTP 요청(기본, 헤더 조회)  (0) 2022.03.06
Ch06. 스프링 MVC(기본 기능) - 요청 매핑(API 예시)  (0) 2022.03.06

'스프링 MVC 1편 (백엔드 웹 개발 핵심 기술)'의 다른글

  • 현재글Ch06. 스프링 MVC(기본 기능) - HTTP 응답

관련글

댓글

티스토리툴바