📗Spring MVC Study [ HTTP 응답 ]

Caruh·2025년 3월 24일

spring mvc

Spring MVC

목록 보기

15/17

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

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

정적 리소스

스프링 부트는 클래스패스의 다음 디렉토리에 있는 정적 리소스를 제공한다.
/static, /public, /resource, META-INF/resources
src/main/resources는 리소를 보관하는 곳이고, 또 클래스패스의 시작 경로이다. 따라서 다음 디렉토리에 리소를 넣어두면 스프링 부트가 정적 리소스로 서비스를 제공한다.

정적 리소스 경로

src/main/resources/static 이다.
다음 경로에 파일이 들어있을 경우
- src/main/resources/static/basic/hello-form.html
웹 브라이저에서 다음과 같이 실행하면 된다.
- http://localhost:8000/basic/hello-form.html
정적 리소스는 해당 파일을 변경 없이 그대로 서비스하는 것이다.

뷰 템플릿

뷰 템플릿을 거쳐서 HTML이 생성되고, 뷰가 응답을 만들어서 전달한다.
일반적으로 HTML을 동적으로 생성하는 용도를 사용하지만, 다른 것들도 가능하다. 뷰 템플릿이 만들 수 있는 것이라면 뭐든지 가능
스프링 부트는 기본 뷰 템플릿 경로를 제공한다.
- 뷰 템플릿 경로 : src/main/resources/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로 뷰 리졸버가 실행되어서 뷰를 찾고, 렌더링 한다.
@ResponseBody가 있으면 뷰 리졸버를 실행하지 않고, HTTP 메시지 바디에 직접 response/hello라는 문자가 입력된다.
여기서는 뷰의 논리 이름인 response/hello를 반호나하면 다음 경로의 뷰 템플릿이 렌더링 되는 것을 확인할 수 있다.
- 실행 : templates/response/hello.html

Void를 반환하는 경우

@Controller를 사용하고, HttpServletResponse, OutputStream(Writer)같은 HTTP 메시지 바디를 처리하는 파리미터가 없으면 요청 URL을 참고해서 논리 뷰 이름으로 사용
- 요청 URL : /response/hello
- 실행 : templates/response/hello.html
참고롤 이 방식은 명시성이 너무 떨어지고 이렇게 딱 맞는 경우도 많이 없어서, 권장 X

HTTP 메시지

@ResponseBody, HttpEntity를 사용하면, 뷰 템플릿을 사용하는 것이 아니라, HTTP 메시지 바디에 직접 응답 데이터를 출력할 수 있다.

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

HTTP API를 제공하는 경우에는 HTML이 아니라 데이터를 전달해야 하므로, HTTP 메시지 바디에 JSON 같은 형식으로 데이터를 실어 보낸다.
참고
- HTML이나 뷰 템플릿을 사용해도 HTTP 응답 메시지 바디에 HTML 데이터가 담겨서 전달된다. 여기서 설명하는 내용은 정적 리소스나 뷰 템플릿을 거치지 않고, 직접 HTTP 응답 메시지를 전달하는 경우이다.

@ResController

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