[내일배움캠프_Spring Boot 입문주차] Spring MVC

Spring MVC란 무엇인가?

MVC 디자인 패턴

디자인 패턴: 효율적인 방법들을 패턴화 해놓은 것

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

→ 코드의 재사용성과 유지보수성 높이고, 개발자들 간의 협업을 용이하게 함

Model: 데이터와 비즈니스 로직 담당
- 데이터베이스 연동
- 데이터 저장, 조회
View: 사용자 인터페이스 담당
- 사용자가 보는 화면이나 버튼 폼 등
Controller: Model과 View 사이의 상호작용을 조정하고 제어 가능
- 사용자의 요청을 입력받아 Model에 전달
- 그 결과를 바탕으로 View 업데이트

Spring MVC

Spring 공식문서에서 Spring MVC는 DispatcherServlet이 중앙에서 HTTP 요청을 처리해주는데 이는 Front Controller 패턴으로 설계되어 있다고 설명하고 있음.

즉, Spring에서 MVC 디자인 패턴을 적용해 HTTP 요청을 효율적으로 처리하고 있음

Servlet(서블릿)

Servlet(서블릿)은 자바를 사용해 웹 페이지를 동적으로 생성하는 서버 측 프로그램 혹은 그 사양

* 톰캣(Tomcat) 안에서 서블릿(Servlet) 동작

[사용자가 HTTP API 요청 시 서버의 서블릿 동작 과정]

1. 클라이언트가 HTTP를 통해 Request 요청

2. 요청을 받은 서블릿 컨테이너는 HttpServletRequest와 HttpServletResponse 객체 생성

두 객체는 약속된 HTTP의 규격을 맞추면서 쉽게 HTTP에 담긴 데이터를 사용하기 위해 만들어낸 객체
즉, 서블릿이 개발자를 대신해서 HTTP를 분석해서 그 안에 들어있는 데이터와 정보들을 객체에 넣어줌

3. API 요청 확인 후, 그 요청이 어떤 서블릿과 매칭이 되는지 분석함(web.xml)

4. 매칭되는 서블릿을 찾으면, 해당 서블릿에서 service() 호출

5. 서비스 메서드 호출 후 HTTP 요청이 어떤 메서드 방식인지 확인한 후 해당 방식에 맞는 메서드 호출

6. 호출한 메서드들의 결과를 반환해 HttpServletResponse 객체에 응답을 담아서 클라이언트에 반환

DispatcherServlet

Dispatcher는 '전달하다'라는 의미로, DispatcherServlet은 전달하는 서블릿

여러 개의 API에 매칭되는 Servlet의 객체들을 개발자가 구현하고, 어떤 메서드 방식인지 확인해서 방식에 맞는 메서드 호출하고 수행해주는 등 개발자가 여러 가지 작업들을 작성해주어야함

이러한 불편함을 스프링에서 해결해주기 위해 DispatcherServlet을 만들고, Front 컨트롤 패턴 방식으로 모든 API들을 효율적으로 처리하고 있음

1. 브라우저에서 Request 요청 들어옴

2. DispatcherServlet이 해당 요청 분석 후, 분석한 토대로 Handler mapping을 통해 Controller를 찾아 요청 전달

Handler mapping에는 API path와 Controller 메서드가 매칭되어 있음

@RestController
public class HelloController {
    @GetMapping("/api/hello")
    public String hello() {
    	return "Hello World!";
    }
}

3. Controller는 해당 요청에 대한 작업 수행 후, 요청에 대한 결과를 Model에 담고, View에 대한 정보도 전달해줌

4. DispatcherServlet을 통해 Client에게 응답 전달

ViewResolver를 통해 View에 Model 적용해 View를 Client에게 응답으로 전달

Controller 이해하기

Controller의 장점

Spring MVC에 Front Controller 패턴이 적용되어 있지 않는 경우, 단 4개의 API를 처리하기 위해 3개의 클래스를 만들어야 함
하지만 Spring MVC는 효율적인 API 처리를 위해 Front Controller 패턴을 만들었기 때문에, API마다 파일을 만들 필요 X
- 보통 하나의 Controller에 모든 API를 넣지 않고, 유사한 성격의 API를 하나의 Controller로 관리함
메서드 이름도 마음대로 설정 가능함!

Controller 만들기

1. 프로젝트 생성 후 Controller 파일 생성

2. API 만들기

* 경로는 중복이 될 수 있지만, Method까지 중복 X

package com.sparta.springmvc.controller;

import org.springframework.stereotype.Controller;
import org.springframework.web.bind.annotation.*;

@Controller
public class HelloController {
    @GetMapping("/api/hello")
    @ResponseBody
    public String hello() {
        return "Hello World!";
    }

    @GetMapping("/api/get")
    @ResponseBody
    public String get(){
        return "GET Method 요청";
    }

    @PostMapping("/api/hello")
    @ResponseBody
    public String postHello() {
        return "Hello Post World!";
    }

    @PostMapping("/api/post")
    @ResponseBody
    public String post() {
        return "POST Method 요청";
    }

    @PutMapping("/api/put")
    @ResponseBody
    public String put() {
        return "PUT Method 요청";
    }

    @DeleteMapping("/api/delete")
    @ResponseBody
    public String delete() {
        return "DELETE Method 요청";
    }
}

3. 중복 코드 없애기

@RequestMapping을 상단에 달고, 특정 url로 시작하는 요청은 해당 클래스로 넘어옴. 그 이후 path와 Method 방식을 분석해 메서드에 매칭함

package com.sparta.springmvc.controller;

import org.springframework.stereotype.Controller;
import org.springframework.web.bind.annotation.*;

@Controller
@RequestMapping("/api")
public class HelloController {
    @GetMapping("/hello")
    @ResponseBody
    public String hello() {
        return "Hello World!";
    }

    @GetMapping("/get")
    @ResponseBody
    public String get(){
        return "GET Method 요청";
    }

    @PostMapping("/post")
    @ResponseBody
    public String post() {
        return "POST Method 요청";
    }

    @PutMapping("/put")
    @ResponseBody
    public String put() {
        return "PUT Method 요청";
    }

    @DeleteMapping("/delete")
    @ResponseBody
    public String delete() {
        return "DELETE Method 요청";
    }
}

정적 페이지와 동적 페이지

thymeleaf: 템플릿 엔진으로 동적인 웹페이지 즉, 동적인 HTML 파일을 만들기 위한 라이브러리

정적 페이지 처리

static 폴더에 있는 HTML에 접근하기 위한 방법

1. URL 경로에서 직접 접근

2. thymeleaf가 엔진에 걸려 있지 않은 상황에서 Controller를 통해 접근

package com.sparta.springmvc.html;

import org.springframework.stereotype.Controller;
import org.springframework.web.bind.annotation.GetMapping;

@Controller
public class HtmlController {
    @GetMapping("/static-hello")
    public String hello() {
        return "hello.html";
    }
}

3. redirect로 접근

package com.sparta.springmvc.html;

import org.springframework.stereotype.Controller;
import org.springframework.web.bind.annotation.GetMapping;

@Controller
public class HtmlController {
    @GetMapping("/static-hello")
    public String hello() {
        return "hello.html";
    }

    @GetMapping("/html/redirect")
    public String htmlStatic() {
        return "redirect:/hello.html"; // 재호출
    }
}

templates 폴더에 있는 HTML에 접근하기

package com.sparta.springmvc.html;

import org.springframework.stereotype.Controller;
import org.springframework.web.bind.annotation.GetMapping;

@Controller
public class HtmlController {
    @GetMapping("/html/templates")
    public String htmlTemplate(){
        return "hello";
    }
}

동적 페이지 처리

반환할 데이터는 Model에 담고, 그 Model이 적용될 View name에 정보 전달하면 View Resolver를 통해서 그 Model의 데이터가 View에 적용되고 완성된 페이지를 클라이언트에 반환하는 과정

<!DOCTYPE html>
<html>
  <head><meta charset="UTF-8"><title>Hello Spring</title></head>
  <body>
    <div>
      Hello, Spring 동적 웹 페이지!!
    </div>
    <div>
      (방문자 수: <span th:text="${visits}"></span>)
    </div>
  </body>
</html>

package com.sparta.springmvc.html;

import org.springframework.stereotype.Controller;
import org.springframework.ui.Model;
import org.springframework.web.bind.annotation.GetMapping;

@Controller
public class HtmlController {

    private static long visitCount = 0; // 방문 횟수

    @GetMapping("/html/dynamic")
    public String htmlDynamic(Model model) {
        visitCount++;
        model.addAttribute("visits", visitCount);
        return "hello-visit";
    }
}

데이터를 Client에 반환하는 방법

웹 생태계에서 서버는 MySQL과 같은 데이터베이스 서버에서 받아온 데이터를 클라이언트에 반환해주면, 클라이언트가 해당 데이터를 가지고 브라우저를 통해 사용자에게 결과값을 보여주는 형태로 발전하고 있음

즉, Client 쪽을 개발하는 Frontend와 서버 쪽을 개발하는 Backend가 서로 느슨하게 결합되는 방식을 더 많이 채택하고 있음

서버에서 데이터 교환 포맷 중에 JSON이라는 형태로 데이터 반환하고 있음

Client에서 최초 Request하면 정적 HTML 혹은 동적 HTML 반환
그 이후에는 자바스크립트 라이브러리인 AJAX로 비동기적으로 서버에 요청이 들어와 서버는 JSON 형태로 반환
- JSON은 자바스크립트 쪽에서 있는 타입이기 때문에 자바에서 읽을 수 X
- 즉, 응답을 반환해줄 때 JSON 형식처럼 생긴 String 형식으로 작성

String 반환

package com.sparta.springmvc.response;

import org.springframework.stereotype.Controller;
import org.springframework.web.bind.annotation.GetMapping;
import org.springframework.web.bind.annotation.RequestMapping;
import org.springframework.web.bind.annotation.ResponseBody;

@Controller
@RequestMapping("/response")
public class ResponseController {
    // Content-Type: text/html
    // Response Body
    // {"name":"Robbie", "age":95}
    @GetMapping("/json/string")
    @ResponseBody
    public String helloStringJson() {
        return "{\"name\":\"Robbie\",\"age\":95}";
    }
}

자바 클래스 반환

자바 객체를 반환하면 Spring 내부적으로 자바 객체를 JSON 형태로 변환해줌

package com.sparta.springmvc.response;

import lombok.Getter;

@Getter
public class Star {
    String name;
    int age;

    public Star(String name, int age) {
        this.name = name;
        this.age = age;
    }

    public Star() {}
}

package com.sparta.springmvc.response;

import org.springframework.stereotype.Controller;
import org.springframework.web.bind.annotation.GetMapping;
import org.springframework.web.bind.annotation.RequestMapping;
import org.springframework.web.bind.annotation.ResponseBody;

@Controller
@RequestMapping("/response")
public class ResponseController {
    // Content-Type: text/html
    // Response Body
    // {"name":"Robbie", "age":95}
    @GetMapping("/json/string")
    @ResponseBody
    public String helloStringJson() {
        return "{\"name\":\"Robbie\",\"age\":95}";
    }

    // Content-Type: application/json
    // Response Body
    // {"name":"Robbie", "age":95}
    @GetMapping("/json/class")
    @ResponseBody
    public Star helloClassJson(){
        return new Star("Robbie", 95);
    }
}

RestController

RestController는 Controller + ResponseBody로, 메서드에 따로 ResponseBody를 달지 않아도 됨!

package com.sparta.springmvc.response;

import org.springframework.web.bind.annotation.GetMapping;
import org.springframework.web.bind.annotation.RequestMapping;
import org.springframework.web.bind.annotation.RestController;

@RestController
@RequestMapping("/response/rest")
public class ResponseRestController {
    // [Response header]
    //   Content-Type: text/html
    // [Response body]
    //   {"name":"Robbie","age":95}
    @GetMapping("/json/string")
    public String helloStringJson() {
        return "{\"name\":\"Robbie\",\"age\":95}";
    }

    // [Response header]
    //   Content-Type: application/json
    // [Response body]
    //   {"name":"Robbie","age":95}
    @GetMapping("/json/class")
    public Star helloClassJson() {
        return new Star("Robbie", 95);
    }
}

Jackson

Jackson은 JSON 데이터 구조를 처리해주는 라이브러리로, Object(=자바 객체)를 JSON 타입의 String으로 변환해 줄 수 있고, 반대로 JSON 타입의 String 값을 Object로 변환해 줄 수 있음
- Spring 3.0 버전 이후로 Jackson과 관련된 API 제공

ObjectMapper 클래스 사용해서 Object → JSON 형태 혹은 JSON → Object 형태 변환

Object → JSON

자바 클래스 내에 Getter 메서드 반드시 필요함! → 직렬화 수행을 위해

package com.sparta.springmvc;

import com.sparta.springmvc.response.Star;
import org.junit.jupiter.api.DisplayName;
import org.junit.jupiter.api.Test;
import tools.jackson.databind.ObjectMapper;

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

        ObjectMapper objectMapper = new ObjectMapper(); // Jackson 라이브러리의 ObjectMapper
        String json = objectMapper.writeValueAsString(star);

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

JSON → Object

자바 클래스 내에 기본 생성자와 Getter 혹은 Setter 필요! → 역직렬화 수행을 위해

package com.sparta.springmvc;

import com.sparta.springmvc.response.Star;
import org.junit.jupiter.api.DisplayName;
import org.junit.jupiter.api.Test;
import tools.jackson.databind.ObjectMapper;

public class JacksonTest {
    @Test
    @DisplayName("JSON To Object : 기본 생성자 & (get OR set) Method 필요")
    void test2() {
        String json = "{\"name\":\"Robbie\",\"age\":95}"; // JSON 타입의 String

        ObjectMapper objectMapper = new ObjectMapper(); // Jackson 라이브러리의 ObjectMapper

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

Path Variable과 Request Param

클라이언트에서 요청을 보낼 때 데이터를 함께 보낼 수 있음. 서버에서는 이 데이터를 받아서 사용해야함. 하지만 데이터를 보내는 방식이 여러 가지가 있기 때문에 모든 방식에 대한 처리 방법 학습해야 함

Path Variable

보내려고하는 데이터를 브라우저에서 경로에 넣는 것

URL 경로에서 데이터를 받고자 하는 위치의 경로에 {data} 중괄호 사용
해당 요청 메서드 파라미터에 @PathVariable 애너테이션과 함께 {data} 중괄호에 선언한 변수명과 변수타입을 선언해서 해당 경로의 데이터 받아옴

package com.sparta.springmvc.request;

import org.springframework.stereotype.Controller;
import org.springframework.web.bind.annotation.GetMapping;
import org.springframework.web.bind.annotation.PathVariable;
import org.springframework.web.bind.annotation.RequestMapping;
import org.springframework.web.bind.annotation.ResponseBody;

@Controller
@RequestMapping("/hello/request")
public class RequestController {
    // [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(혹은 Query String)

URL 내 경로 뒤에 Query String 방식으로 데이터를 시작할 때 물음표로 시작하고, Key-Value 형태로 데이터를 넣음. 데이터 여러 개를 보낼 때에는 &로 연결

해당 요청 메서드 파라미터에 @RequestParam 애너테이션과 함께 key 부분에 선언한 변수명과 변수타입을 선언해 데이터 받아옴

package com.sparta.springmvc.request;

import org.springframework.stereotype.Controller;
import org.springframework.web.bind.annotation.*;

@Controller
@RequestMapping("/hello/request")
public class RequestController {
    // [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);
    }
}

파라미터에 @RequestParam 애너테이션 생략 가능

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

클라이언트에서 전달받은 값들 중 해당 값이 포함되지 않아도 되는 경우의 옵션 설정 → default로 true가 설정되어 있음!(@PathVariable도 동일)
- 안들어오는 경우 오류가 발생하지는 않지만, null 값이 들어옴

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

form 태그 POST

HTML 내의 form 태그 사용하면 URL 요청 가능

POST는 GET과 달리 body를 가지고 있음. Payload 부분에 데이터를 보낼 수 있음

<h2>POST /hello/request/form/param</h2>
<form method="POST" action="/hello/request/form/param">
  <div>
    이름: <input name="name" type="text">
  </div>
  <div>
    나이: <input name="age" type="text">
  </div>
  <button>전송</button>
</form>
<br>

package com.sparta.springmvc.request;

import org.springframework.stereotype.Controller;
import org.springframework.web.bind.annotation.*;

@Controller
@RequestMapping("/hello/request")
public class RequestController {
    // [Request sample]
    // POST http://localhost:8080/hello/request/form/param
    // Header
    //  Content type: application/x-www-form-urlencoded
    // Body
    //  name=Robbie&age=95
    @PostMapping("/form/param")
    @ResponseBody
    public String helloPostRequestParam(@RequestParam String name, @RequestParam int age) {
        return String.format("Hello, @RequestParam.<br> name = %s, age = %d", name, age);
    }
}

HTTP 데이터를 객체로 처리하는 방법

@ModelAttribute 애노테이션

Body의 Query String 방식의 데이터를 객체에 Mapping

body 부분에 들어온 Query String 방식의 데이터를 객체에 mapping해서 가지고 올 수 있음

클래스(객체)의 필드 이름과 클라이언트에서 보내는 데이터 이름이 동일해야함

// [Request sample]
// POST http://localhost:8080/hello/request/form/model
// Header
//  Content type: application/x-www-form-urlencoded
// Body
//  name=Robbie&age=95
@PostMapping("/form/model")
@ResponseBody
public String helloRequestBodyForm(@ModelAttribute Star star) {
    return String.format("Hello, @ModelAttribute.<br> (name = %s, age = %d) ", star.name, star.age);
}

Request Param 방식의 데이터를 객체에 Mapping

request param 방식도 @ModelAttribute를 이용해서 객체로 받아올 수 있음

@ModelAttribute는 Setter 혹은 오버로딩된 생성자 반드시 필요함!

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

@ModelAttribute 생략하기

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

❓ Spring에서 @RequestParam과 @ModelAttribute 모두 생략이 가능한데 어떻게 구분할까?

🗣️ Spring은 해당 파라미터가 SimpleValueType(원시타입, Wrapper, Date 타입)이면 @RequestParam으로 간주하고,
아니라면 @ModelAttribute가 생략이 되었다고 판단함

Body에 JSON 형식으로 넘어온 경우

HTTP Body 부분에 JSON 형식으로 데이터가 넘어왔을 때에 @RequestBody 애노테이션을 꼭 붙여주어야 함!

field를 꼭 맞춰주어야 함!

// [Request sample]
// POST http://localhost:8080/hello/request/form/json
// Header
//  Content type: application/json
// Body
//  {"name":"Robbie","age":"95"}
@PostMapping("/form/json")
@ResponseBody
public String helloPostRequestJson(@RequestBody Star star) {
    return String.format("Hello, @RequestBody.<br> (name = %s, age = %d) ", star.name, star.age);
}

'백엔드 > spring&springboot' 카테고리의 다른 글

[내일배움캠프_Spring Boot 입문주차] Database와 SQL (0)	2026.06.24
[내일배움캠프_Spring Boot 입문주차] 메모장 프로젝트 만들기 (0)	2026.06.24
[내일배움캠프_Spring Boot 입문주차] Lombok과 application.properties (0)	2026.06.23
[내일배움캠프_Spring Boot 입문주차] 테스트 코드 (0)	2026.06.23
[내일배움캠프_Spring Boot 입문주차] Spring Boot 프로젝트 생성 및 서버 개발 시 필요한 개념 (0)	2026.06.22

차곡차곡🐿️

[내일배움캠프_Spring Boot 입문주차] Spring MVC

Spring MVC란 무엇인가?

MVC 디자인 패턴

Spring MVC

Controller 이해하기

Controller의 장점

Controller 만들기

정적 페이지와 동적 페이지

정적 페이지 처리

동적 페이지 처리

데이터를 Client에 반환하는 방법

String 반환

자바 클래스 반환

RestController

Jackson

Object → JSON

JSON → Object

Path Variable과 Request Param

Path Variable

Request Param(혹은 Query String)

form 태그 POST

HTTP 데이터를 객체로 처리하는 방법

@ModelAttribute 애노테이션

Body에 JSON 형식으로 넘어온 경우

'백엔드 > spring&springboot' 카테고리의 다른 글

티스토리툴바

[내일배움캠프_Spring Boot 입문주차] Spring MVC

Spring MVC란 무엇인가?

MVC 디자인 패턴

Spring MVC

Controller 이해하기

Controller의 장점

Controller 만들기

정적 페이지와 동적 페이지

정적 페이지 처리

동적 페이지 처리

데이터를 Client에 반환하는 방법

String 반환

자바 클래스 반환

RestController

Jackson

Object → JSON

JSON → Object

Path Variable과 Request Param

Path Variable

Request Param(혹은 Query String)

form 태그 POST

HTTP 데이터를 객체로 처리하는 방법

@ModelAttribute 애노테이션

Body에 JSON 형식으로 넘어온 경우

'백엔드 > spring&springboot' 카테고리의 다른 글

관련글

티스토리툴바