스프링 MVC 기본 기능, HTTP 응답 - 정적 리소스, 뷰 템플릿, HTTP API, 메시지 바디에 직접 입력

인프런 김영한 님의 스프링 강의이며, 섹션 6 - 스프링 MVC 기본 기능을 정리하는 시간이다.

자세한 설명이 궁금하면 수강을 권장한다.

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

---

스프링에서 응답 데이터를 만드는 방법은 3가지다.

- 정적 리소스 : 웹 브라우저에서 정적인 HTML, css, js

- 뷰 템플릿 사용 :  웹 브라우저에 동적인 HTML 제공

- HTTP 메시지 사용 : HTTP 메시지 바디에 JSON 형식으로 데이터를 전달

 

정적 리소스

스프링 부트는 클래스패스의 다음 디렉토리에 있는 정적 리소스를 제공한다.

/static, /public, /resource, /META-INF/resources

 

정적 리소스 경로

src/main/resources/static

위와 같은 경로에 파일이 있으면 http://localhost:8080/basic/hello-form.html 로 접근이 가능하다.

정적 리소스에 접근이 된다.

 

뷰 템플릿

뷰 템플릿을 거쳐서 HTML이 생성되고, 뷰가 응답을 만들어서 전달한다.

스프링부트는 기본 뷰 템플릿 경로를 제공한다.

 

뷰 템플리 경로 : src/main/resource/templates 

@Controller
public class 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로 뷰 리볼버가 실행되어서 뷰를 찾고 렌더링 한다.

만약에 있으면 뷰 리졸버를 건너뛰고 HTTP 메시지 바디에 직접 response/hello 문자가 입력되어 반환된다.

 

@ResponseBody가 없고, 뷰 이름도 반환되지 않는다면?

스프링은 자체적으로 경로로 뷰 템플릿을 찾아서 반환된다. (명시적이 없어 비권장한다) 

경로로 뷰 템플릿이 반환된다.

---

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

HTTP API를 제공하는 경우에 HTML이 아니라 데이터를 전달해야 하므로, HTTP 메시지 바디에 JSON 형식으로 데이터를 보낸다.

 

@Slf4j
@Controller
public class ResponseBodyController {

    @GetMapping("/response-body-string-v1")
    public void responseBodyV1(HttpServletResponse response) throws IOException {
        response.getWriter().write("ok");
    }

    @GetMapping("/response-body-string-v2")
    public ResponseEntity<String> responseBodyV2() {
        return new ResponseEntity<>("ok", HttpStatus.OK);
    }

    @ResponseBody
    @GetMapping("/response-body-string-v3")
    public String responseBodyV3() {
        return "ok";
    }

    @GetMapping("/response-body-json-v1")
    public ResponseEntity<HelloData> responseBodyJsonV1() {
        HelloData helloData = new HelloData();
        helloData.setAge(20);
        helloData.setUsername("userA");
        return new ResponseEntity<>(helloData, HttpStatus.OK);
    }

    @ResponseStatus(HttpStatus.OK)
    @ResponseBody
    @GetMapping("/response-body-json-v2")
    public HelloData responseBodyJsonV2() {
        HelloData helloData = new HelloData();
        helloData.setAge(20);
        helloData.setUsername("userA");
        return helloData;
    }
}

responseBodyV1 : HttpServletResponse 객체를 통해서 HTTP 메시지 바디에 응답 메시지를 전달한다.

responseBodyV2 : HttpEntity는 HTTP 메시지의 헤더, 바디 정보를 갖는데, 이를 상속받은 ResponseEntity는 HTTP 응답 코드를 설정할 수 있다.

responseBodyV3 : @ResponseBody를 사용하면 HTTP 메시지 컨버터를 통해 HTTP 메시지를 직접 입력한다.

 

responseBodyJsonV1 : ResponseEntity로 반환한다.

responseBodyJsonV2 : @ResponseBody 사용할 경우에 HTTP 응답 코드는 @ResponseStatus로 설정한다.