HTTP 응답

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

스프링(서버)에서 응답 데이터를 만드는 방법은 크게 3가지

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

정적 리소스

• 스프링 부트는 클래스패스의 다음 디렉토리에 있는 정적 리소스를 제공
  /static, /public, /resources, /META-INF/resources
• 정적 리소스 경로
  src/main/resources/static
• 정적 리소스는 해당 파일을 변경 없이 그대로 띄우는 것

뷰 템플릿 (Thymeleaf)

• 뷰 템플릿을 거쳐서 HTML 생성 -> 뷰가 응답을 만들어서 전달

• 일반적으로 HTML을 동적으로 생성하는 용도이지만, 다른 것들도 가능

• 뷰 템플릿 경로 <- 스프링 부트는 기본 뷰 템플릿을 경로를 제공
  src/main/resources/templates

• String을 반환하는 경우 - View or HTTP 메시지

  • @ResponseBody가 없으면 return 되는 경로를 뷰 리졸버가 실행되어서 뷰를 찾고 렌더링 함

  • @ResponseBody가 있으면 HTTP 메시지 바디에 return 되는 문자가 입력 됨

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

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

방법 1~3 - String
방법 1.

• 서블릿을 직접 다룰 때 처럼 HttpServletResponse 객체를 통해서 HTTP 메시지 바디에 직접 ok 응답 메시지를 전달한다.

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

방법 2.

• ResponseEntity 엔티티는 HttpEntity 를 상속 받았는데, HttpEntity는 HTTP 메시지의 헤더, 바디 정보를 가지고 있다. ResponseEntity 는 여기에 더해서 HTTP 응답 코드를 설정할 수 있다.
• HttpStatus.CREATED 로 변경하면 201 응답이 나가는 것을 확인할 수 있다.

@GetMapping("/response-body-string-v2")
public ResponseEntity<String> responseBodyV2() throws IOException {

	return new ResponseEntity<>("ok", HttpStatus.OK);
}

방법 3.

• @ResponseBody 를 사용하면 view를 사용하지 않고, HTTP 메시지 컨버터를 통해서 HTTP 메시지를 직접 입력할 수 있다.
• ResponseEntity 도 동일한 방식으로 동작한다.

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

방법 4, 5 - Json
방법 4.

• ResponseEntity 를 반환한다. HTTP 메시지 컨버터를 통해서 JSON 형식으로 변환되어서 반환된다.

@GetMapping("/response-body-json-v1")
public ResponseEntity<HelloData> responseBodyJsonV1(){
	HelloData helloData = new HelloData();
    helloData.setAge(10);
    helloData.setUsername("userA");

	return new ResponseEntity<>(helloData, HttpStatus.OK);
}

방법 5.

• ResponseEntity 는 HTTP 응답 코드를 설정할 수 있는데, @ResponseBody 를 사용하면 이런 것을 설정하기 까다롭다.
• @ResponseStatus(HttpStatus.OK) 애노테이션을 사용하면 응답 코드도 설정할 수 있다.
• 물론 애노테이션이기 때문에 응답 코드를 동적으로 변경할 수는 없다. 프로그램 조건에 따라서 동적으로 변경하려면 ResponseEntity 를 사용하면 된다.

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

	return helloData;
}