[Spring] Spring 웹 개발 방법

2025-03-13 4 분 소요

1. 스프링 웹 개발 방법

웹을 개발하는 3가지 방법이 존재한다.

개발 방법	설명
정적 콘텐츠	- HTML, CSS, JavaScript 파일과 같은 고정된 콘텐츠를 제공하는 방식. - 서버에서 파일을 클라이언트에게 그대로 전달하며, 데이터나 페이지 내용이 변경되지 않는 경우 사용. - 간단히 파일을 그대로 내려주는 방식.
MVC와 템플릿 엔진	- 서버에서 프로그래밍을 통해 HTML을 동적으로 생성하여 전달하는 방식. - MVC(Model-View-Controller) 패턴을 활용. - Model: 데이터와 비즈니스 로직 처리. - View: 사용자에게 데이터를 표시하는 역할. - Controller: 사용자 입력을 처리하고 모델과 뷰를 업데이트. - 템플릿 엔진은 미리 정의된 템플릿 파일과 데이터를 결합하여 HTML, XML 등을 생성.
API	- XML이나 JSON과 같은 데이터 구조 포맷으로 클라이언트에 데이터를 전달하는 방식. - 서버 간 통신에도 활용됨.

2. 정적 컨텐츠

2.1 정적 컨텐츠 제공

스프링 부트 정적 컨텐츠 기능은 [여기↗] 에서 자세히 확인할 수 있다.

기본 설정으로 스프링 부트는 정적 폴더를 /static에서 제공한다.

resources/static/hello-static.html을 만들어보자.

그 후, 아래 코드를 실행하고 http://localhost:8080/hello-static.html로 접속하기!

<!DOCTYPE html>
<html>
  <head>
    <title>static content</title>
    <meta http-equiv="Content-Type" content="text/html; charset=UTF-8" />
  </head>
  <body>
    정적 컨텐츠 입니다.
  </body>
</html>

즉, 정적 컨텐츠는 서버에서 파일을 클라이언트에게 그대로 전달하는 것을 볼 수 있다.

2.2 정적 콘텐츠 동작 방식

단계	설명
① URL 요청	사용자가 웹 브라우저에서 `http://localhost:8080/hello-static.html`로 접속한다.
② 내장 톰캣 서버 처리	스프링 부트는 내장된 톰캣 서버를 사용하므로, 해당 URL 요청은 톰캣 서버로 전달된다.
③ 컨트롤러 우선 처리	스프링 부트는 요청을 먼저 컨트롤러에서 찾는다. 하지만 `hello-static.html`을 처리할 수 있는 컨트롤러가 없다면, 요청을 처리할 수 없다고 판단한다.
④ 정적 리소스 처리	컨트롤러에서 해당 요청을 처리할 수 없을 때, 스프링 부트는 `resources/static/hello-static.html` 파일을 찾아 반환한다. 즉, `static` 폴더에 있는 정적 HTML 파일을 자동으로 제공하게 된다.
⑤ 브라우저에 반환	스프링 부트는 `hello-static.html` 파일을 웹 브라우저에 반환하여 사용자가 HTML 내용을 볼 수 있도록 한다.

3. MVC와 템플릿 엔진

3.1 MVC란?

MVC는 Model, View, Controller가 분리 되어있는 방법이다.

관심사 분리를 위해 View는 화면을 그리는데 집중, Model와 Controller는 비즈니스 로직과 관련되어 있도록 한다.
- 모델(Model): 데이터와 로직 처리
- 뷰(View): 사용자에게 보여주는 화면
- 컨트롤러(Controller): 사용자의 입력을 처리하고 모델과 뷰를 연결

3.2 Controller

hello.hello_project.controller에 HelloController 생성

package hello.hello_project.controller;

@Controller
public class HelloController {

		// 정적 콘텐츠 방식
		@GetMapping("hello")
    public String hello(Model model){
        model.addAttribute("data","hello!!!");
        return "hello";
    }

		// MVC 방식
		@GetMapping("hello-mvc")
		// 윈도우 파라미터 옵션 단축키(Ctrl + p)
		public String helloMvc(@RequestParam("name") String name, Model model){
				// 파라미터로 들어온 name을 넘겨줌
        model.addAttribute("name",name);
        return "hello-template";
    }
}

3.3 View

타임리프(thymeleaf)는 뷰 템플릿 엔진으로 컨트롤러가 전달하는 데이터를 이용하여 동적으로 화면을 구성할 수 있게 해준다.

resources/templates/hello-template.html

<html xmlns:th="http://www.thymeleaf.org">
  <body>
    /*
    <p th:text="|hello ${name}|">hello! empty</p>
  </body>
</html>

$표시 : modle 키 값 name으로 치환

3.4 MVC 동작 방식

단계	설명
① 웹 브라우저 요청	사용자가 `http://localhost:8080/hello-mvc?name=Spring`로 요청을 보낸다.
② 내장 톰캣 서버	요청을 받으면, 내장 톰캣 서버는 이를 스프링 부트 애플리케이션에 전달한다.
③ 컨트롤러 처리	스프링 부트는 `HelloController` 클래스에서 `@GetMapping("hello-mvc")`와 매핑된 메서드를 호출한다. 이때, `name=Spring`이라는 요청 파라미터를 모델(Model)로 넘겨준다. (`model.addAttribute("name", name)`)
④ 뷰 템플릿 렌더링	컨트롤러는 `"hello-template"`이라는 뷰 이름을 리턴한다. 스프링은 이 이름에 맞는 템플릿 파일을 찾기 위해 `resources/templates/hello-template.html`을 검색한다.
⑤ 템플릿 엔진 처리	타임리프(Thymeleaf) 템플릿 엔진이 HTML 파일을 렌더링한다. 템플릿 내에서 `${name}`은 모델에 담긴 `"name"` 키를 참조하여 `"Spring"`으로 치환된다.
⑥ 결과 반환	변환된 HTML 파일이 웹 브라우저로 반환되어 사용자에게 보여진다.

4. API

정적 컨텐츠를 제외하면 사실 두 가지로 볼 수 있다.

서버에서 View를 찾아서 템플릿 엔진을 통해 화면을 렌더링해서 html을 웹브라우저에 내려주는 방법이 있고 (= MVC와 템플릿 엔진),
데이터를 (일반적으로 JSON 형태로) 바로 내리는 방법이 있다. (= API)

@ResponseBody에 문자를 반환하는 예시

@Controller
public class HelloController {
		// API 방식
		@GetMapping("hello-string")
    @ResponseBody
    public String helloString(@RequestParam("name") String name){
        return "hello " + name;
    }
}

@ResponseBody는 뷰 리졸버(viewResolver) 를 사용하지 않고, HTTP 응답 본문(body)에 데이터를 직접 반환한다.
이를 통해 템플릿 엔진을 사용하지 않고, 요청에 대한 응답을 동적으로 생성하여 클라이언트에게 전달할 수 있다.
이 방식은 주로 RESTful API에서 JSON, XML, 텍스트 등을 반환할 때 사용된다.

http://localhost:8080/hello-string?name=String!!!로 실행

API는 문자가 그대로 출력되는 것을 확인할 수 있다.

사용자가 http://localhost:8080/hello-string?name=Spring!!! 와 같은 요청을 보내면, name=Spring!!!이라는 파라미터가 helloString 메서드로 전달된다.
helloString 메서드는 @ResponseBody 어노테이션을 사용하여 반환 값을 HTTP 응답 본문에 담아 클라이언트로 전달한다.
이 때, 템플릿 엔진은 사용되지 않으며, 단순히 문자열이 그대로 응답으로 반환된다.

@ResponseBody가 객체를 반환하는 예시 -> 데이터 전달하고 싶을 때 사용

package hello.hello_project.controller;

@Controller
public class HelloController {
		// 문자를 반환
		@GetMapping("hello-string")
    @ResponseBody
    public String helloString(@RequestParam("name") String name){
        return "hello " + name;
    }

		// 객체를 반환
		@GetMapping("hello-api")
    @ResponseBody
    public Hello helloApi(@RequestParam("name") String name){
        Hello hello = new Hello();
        hello.setName(name);
        return hello;
    }
		// static class를 만들면 class 안에서 class를 생성할 수 있다.
		static class Hello{
        private String name;

        public String getName(){
            return name;
        }

        public void setName(String name){
            this.name = name;
        }
    }
}

@ResponseBody 를 사용하고, 객체를 반환하면 객체가 JSON으로 변환된다.
실행: http://localhost:8080/hello-api?name=spring

참고

@RestController 은 @Controller와 @ResponseBody를 합친 어노테이션이다.

따라서,

스프링 컨테이너에 빈으로 자동 등록되고,
모든 메서드에 @ResponseBody가 기본 적용되어서 HTTP 응답 바디에 데이터를 직접 반환한다.

즉, @RestController를 사용하면 별도로 @ResponseBody를 붙이지 않아도 JSON이나 문자열 데이터를 바로 클라이언트에게 반환할 수 있다!

@ResponseBody 사용 원리

스프링은 이전과 같이 hello-api라는 Controller를 찾는다.
이때 Controller에 @ResponseBody 태그가 붙어있으면 MVC 방식에서의 viewResolver가 아닌 HttpMessageConverter가 동작한다.
- Controller에서 반환하는 값이 string이라면 StringHttpMessageConverter가 작동하여 string을 바로 처리하고,
- 객체가 반환되면 MappingJackson2HttpMessageConverter가 작동해 객체를 JSON방식으로 변환한다.
- JSON으로 만들어진 객체는 바로 웹 브라우저에 key-value 쌍으로 반환된다.

박시은

[Spring] Spring 웹 개발 방법

1. 스프링 웹 개발 방법

2. 정적 컨텐츠

2.1 정적 컨텐츠 제공

2.2 정적 콘텐츠 동작 방식

3. MVC와 템플릿 엔진

3.1 MVC란?

3.2 Controller

3.3 View

3.4 MVC 동작 방식

4. API

댓글남기기

참고

[Spring-MVC] 요청 매핑 (@Controller, @RestController, @RequestMapping)

[Spring-MVC] Spring MVC 웹페이지 만들기

[Spring-MVC] Model vs ModelAndView

[Spring-MVC] HTTP 응답