[Spring]스프링 MVC 1편 - 스프링 MVC 기본 기능(응답)

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

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

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

🚩정적리소스 

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

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

 

정적 리소스 경로

src/main/resources/static

 

다음 경로에 파일이 들어있으면

src/main/resources/static/basic/hello-form.html

 

웹 브라우저에서 다음과 같이 실행하면 된다.

http://localhost:8080/basic/hello-form.html

 

정적 리소스는 해당 파일을 변경 없이 그대로 서비스하는 것이다.

🚩뷰 템플릿 

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

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

  @GetMapping("/resopnse-view-v1")
  public ModelAndView resonseViewV1(){
    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!!");
  }

• ModelAndView로 반환하는 경우 
  • ModelAndView에 HTML 경로를 설정해 반환해주면 된다.
• String을 반환하는 경우 
  • @ResponseBody가 없으면 response/hello로 뷰 리졸버가 실행되어서 뷰를 찾고, 렌더링한다.
  • @ResponseBody가 있으면 뷰 리졸버를 실행하지 않고, HTTP 메시지 바디에 직접 response/hello라는 문자가      입력된다. 
• Void로 반환하는 경우
  • @Controller를 사용하고 HTTP 메시지 바디를 처리하는 파라미터(HttpServlertResponse,OutputStream)가 없으면 요청 URL을 참고해서 논리 뷰 이름으로 사용한다.
    • 요청 URL : /response/hello
    • 실행 : templates/response/hello.html 
  • 참고로 이 방식은 명시성이 매우 떨어져 사용하지 말것 

 

📝HTTP 응답 - REST API 

HTTP API를 제공하는 경우에는 HTML이 아니라 데이터를 전달해야한다. 

HTTP 메시지 바디에 JSON 같은 형식으로 데이터를 실어 보낸다. 

 

단순 텍스트 보내기

  @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() throws IOException{
    return new ResponseEntity<>("ok", HttpStatus.OK);
  }
  @ResponseBody
  @GetMapping("/response-body-string-v3")
  public String responseBodyV3(){
    return "ok";
  }

• responseBodyV1
  • 서블릿을 직접 다룰 때처럼 사용한다. 
• responseBodyV2
  • ResponseEntity 엔티티는 HttpEntitiy를 상속받는다. HttpEntitiy는 HTTP 메시지의 헤더, 바디 정보를 가지고 있다. 
  • 이것을 이용해서 HTTP 응답 코드를 설정할 수 있다. 
• responseBodyV3
  • @ResponseBody를 사용하면 view를 사용하지 않고, HTTP 메시지 컨버터를 통해서 HTTP 메시지를 직접 입력할 수 있다. 

JSON 형식 보내기 

  @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);
  }

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

    return helloData;
  }

• responseBodyJsonV1
  • ResponseEntity를 반환한다. HTTP 메시지 컨버터를 통해서 JSON 형식으로 변환되어서 반환
• responseBodyJsonV2
  • ResponseEntity는 HTTP 응답 코드를 설정할 수 있는데, @ResponseBody를 사용하면 이런 것을 설정하기 까다롭다.
  • @ResponseStatus(HttpStatus.OK) 애노테이션을 사용하면 응답 코드를 설정할 수 있다. 

 

• @RestController
  • @Controller 대신에 @RestController 애노테이션을 사용하면, 해당 컨트롤러에 모두 @ResponseBody가 적용된다.
  • 해당 애노테이션은 Rest API를 만들 때 사용한다.