Spring 입문 1주차 : Spring MVC

Spring MVC

MVC 디자인 패턴

• MVC란 Model-View-Controller의 약자로, 소프트웨어 디자인 패턴 중 하나
• MVC 패턴은 소프트웨어를 구성하는 요소들을 Model, View, Controller로 구분하여 각각의 역할을 분리

Model

• 데이터와 비즈니스 로직을 담당
• 데이터베이스와 연동하여 데이터를 저장하고 불러오는 등의 작업을 수행

View

• 사용자 인터페이스 담당

Controller

• Model과 View 사이의 상호작용을 조정하고 제어
• 입력을 받아 Model에 전달하고, Model의 결과를 바탕으로 View를 업데이트

MVC 패턴은 소프트웨어를 구성하는 요소들을 분리함으로써 코드의 재사용성과 유지보수성을 높이고, 개발자들 간의 협업을 용이하게 함.
따라서 소프트웨어를 개발할, MVC 패턴을 적용하여 구조를 잘 설계하는 것이 중요함

Spring MVC

Spring Web MVC는 Servlet API를 기반으로 구축된 독창적인 웹 프레임워크로, 처음부터 Spring Framework에 포함되어 왔음
중앙에 있는 DispatcherServlet이 요청을 처리하기 위한 공유 알고리즘을 제공하는 Front Controller 패턴을 중심으로 설계되어 있으며 이 모델은 유연하고 다양한 워크 플로우를 지원함

Servlet?

• 자바를 사용하여 웹 페이지를 동적으로 생성하는 서버 측 프로그램 혹은 그 사양
• 사용자가 API 요청했을 대 서버의 서블릿이 동작하는 방식
  

1. 사용자가 client를 통해 서버에 HTTP Request 즉, API 요청
2. 요청을 받은 Servlet 컨테이너는 HttpServletRequest, HttpServletResponse 객체를 생성
   • HTTP 규격을 맞추면서 쉽게 HTTP에 담긴 데이터를 사용하기 위한 객체
3. 설정된 정보를 통해 어떠한 Servlet에 대한 요청인지 탐색
4. 해당 Servlet에서 service 메서드를 호출한 뒤 브라우저 요청 Method에 따라 doGet 혹은 doPost등의 메서드를 호출
5. 호출한 메서드의 결과를 그대로 반환하거나 동적 페이지를 생성한 뒤 HttpServletResponse 객체에 응답을 담아 Client에 반환
6. 응답이 완료되면 생성한 HttpServletRequest, HttpServletResponse 객체 소멸

Front Controller?

• 모든 API 요청을 앞서 살펴본 서블릿의 동작 방식에 맞춰 코드를 구현한다면 무수히 많은 Servlet 클래스를 구현해야 함
• 따라서 Spring은 DispatcherServlet을 사용하여 Front Controller 패턴 방식으로 API 요청을 효율적으로 처리
• Front Controller 패턴 동작 과정
  
  1. Client에서 HTTP 요청이 들어오면 DispatcherServlet 객체가 요청을 분석
  2. DispatcherServlet객체는 분석한 데이터를 토대로 Handler mapping을 통해 Controller를 찾아 요청 전달
     • API path 즉, URL을 Controller에 작성하는 방법은 @Controller 애노테이션이 달려있는 클래스를 생성한 뒤 @GetMapping처럼 요청한 HTTP Method와 일치하는 애노테이션을 추가한 메서드를 구현
       • 직접 Servlet을 구현하지 않아도 DispatcherServlet에 의해 간편하게 HTTP 요청 처리 가능
  3. Controller -> DispathcerServlet
     • 해당 Controller는 요청에 대한 처리를 완료한 후 처리에 대한 결과 즉, 데이터(Model)와 View 정보를 전달
  4. DispatcherServlet -> Client
     • ViewResolver를 통해 View에 Model을 적용하여 View를 Client에게 응답을 전달함

정적 페이지와 동적 페이지

@Controller vs @RestController

• @Controller : 전통적인 Spring MVC의 컨트롤러
• @RestController : RESTful 웹 서비스의 컨트롤러
• 주요한 차이점은 HTTP Response Body가 생성되는 방식

@RestController

• @Controller에 @ResponseBody가 추가된 것
• 주용도는 Json 형태로 객체 데이터를 반환하는 것

Jackson?

Jackson 라이브러리

• JSON 데이터 구조를 처리해주는 라이브러리
  • Object를 JSON 타입의 String으로 반환 가능
• Spring 3 이후로 Jackson과 관련된 API를 제공함으로써, 직접 소스 코드를 작성하여 JSON 데이터를 처리하지 않아도 자동으로 처리해주고 있음

Object To JSON

@Test
@DisplayName("Object To JSON : get Method 필요")
void test1() throws JsonProcessingException {
    Star star = new Star("Robbie", 95);

    ObjectMapper objectMapper = new ObjectMapper();
    String json = objectMapper.writeValueAsString(star);

    System.out.println("json = " + json);

JSON To Object

@Test
@DisplayName("JSON To Object : 기본 생성자 & (get or set) Method 필요")
void test2() throws JsonProcessingException {
    String json = "{\"name\":\"Robbie\",\"age\":95}";

    ObjectMapper objectMapper = new ObjectMapper();

    Star star = objectMapper.readValue(json, Star.class);
    System.out.println("star.getName() = " + star.getName());

Path Variable과 Request Param

• Path Variable

  • Client에서 서버로 HTTP 요청을 보낼 때 데이터를 함께 보낼 수 있음
  • 서버에서는 이 데이터를 받아서 사용해야 하는데 데이터를 보내는 방식이 한 가지가 아니라 여러 가지가 있기 때문에 모든 방식에 대한 처리 방법을 학습해야 함
  • Path Variable 방식

    GET http://localhost:8080/hello/request/star/Robbie/age/95

  • 서버에 보내려는 데이터를 URL 경로에 추가 가능
  • 'Robbie'와 '95' 데이터를 서버에 보내기 위해 URL 경로에 추가

    // [Request sample]
    // GET http://localhost:8080/hello/request/star/Robbie/age/95
    @GetMapping("/star/{name}/age/{age}")
    @ResponseBody
    public String helloRequestPath(@PathVariable String name, @PathVariable int age)
    {
      return String.format("Hello, @PathVariable.<br> name = %s, age = %d", name, age);
    }

• Request Param

  GET http://localhost:8080/hello/request/form/param?name=Robbie&age=95

  • 서버에 보내려는 데이터를 URL 경로 마지막에 ?과 &을 사용하여 추가 가능

    // [Request sample]
    // GET http://localhost:8080/hello/request/form/param?name=Robbie&age=95
    @GetMapping("/form/param")
    @ResponseBody
    public String helloGetRequestParam(@RequestParam String name, @RequestParam int age) {
          return String.format("Hello, @RequestParam.<br> name = %s, age = %d", name, age);
    }