[Spring] welcome page 만들기

Spring

[Spring] welcome page 만들기

soowitty 2024. 1. 3. 16:08

💡 김영한님의 스프링 입문 강의를 듣고 정리한 내용입니다.

1. 프로젝트 생성하기

https://start.spring.io/에 접속하여 다음과 같이 프로젝트를 생성한다.

start.spring.io

spring boot를 기반으로 spring 프로젝트를 만들어주는 사이트이다.

프로젝트 선택

Project : Gradle - Groovy
Spring Boot : 3.x.x
Language : Java
Packaging : Jar
Java : 17 or 21

Project Metdata

groupId : hello
artifactId : hello-spring

위와 같이 입력하면 Name과 Package name은 자동으로 생성된다.

Dependencies

여기서 불러올 라이브러리를 선택해주면 된다. Spring Web과 Thymeleaf를 선택한다.

Thymeleaf는 html을 만들어주는 템플릿 엔진이다.

2. 동작 확인

1) HelloSpringApplication.java 파일의 기본 main 메소드 실행한다.

main 메소드 옆의 ▶ 표시를 누르면 main 메소드를 실행할 수 있다.

2) http://localhost:8080 에서 아래와 같은 문구가 나오면 성공한 것이다.

실행 원리

그렇다면 이것은 어떻게 실행되는 것일까?

@SpringBootApplication
public class HelloSpringApplication {

	public static void main(String[] args) {
		SpringApplication.run(HelloSpringApplication.class, Arrays.toString(args));
	}

}

main 메소드를 실행하면 SpringApplication.run(HelloSpringApplication.class); 가 동작하고, 그러면 SpringBoot 어플리케이션이 실행된다. 스프링부트는 tomcat이라는 웹 서버를 내장하고 있다. 따라서 자동으로 tomcat 서버를 실행 시키면서 SpringBoot가 동작한다.

3. Welcome Page 만들기

정적으로 실행

간단한 html 파일을 생성하여 정적페이지를 만들어보자.

먼저, src/main/resources/static에 다음과 같은 index.html 파일을 생성하고 실행해본다.

<!DOCTYPE html>
<html lang="en">
<head>
    <meta charset="UTF-8">
    <title>Hello</title>
    <meta http-equiv="Content-Type" content="text/html; charset=UTF-8" />
</head>
<body>
Hello~~
<a href="/hello">hello</a>
</body>
</html>

이렇게 뜨면 성공이다.

동적으로 실행되게 해보기

그럼 이제 동적으로 실행되는 페이지를 만들어보자!

src/main/java/hello.hellospring/controller에 HelloController.java 파일을 생성한다.

package hello.hellospring.controller;

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

@Controller
public class HelloController {
    @GetMapping("hello")
    public String hello(Model model){
        model.addAttribute("data","hello~~");
        return "hello";
    }
}

src/main/resources/static에는 다음과 같은 hello.html 파일을 생성한다.

<!DOCTYPE html>
<html xmlns:th="http://www.thymeleaf.org"><head>
  <title>Hello</title>
  <meta http-equiv="Content-Type" content="text/html; charset=UTF-8" />
</head>
<body>
<p th:text="'안녕하세요. ' + ${data}" >안녕하세요. 손님</p>
</body>
</html>

웹 브라우저에서 localhost:8080/hello에 접속했을 때, 다음과 같이 뜨면 성공이다!

코드를 뜯어서 동작 과정을 이해해보자.

먼저, @GetMapping("hello")의 역할은 뭘까? 웹 어플리케이션에서 /hello가 들어오면 아래의 함수를 실행해주는 것이다. 따라서, 여기에서는 hello 메소드가 호출된다.

다음으로 model.addAttribute("data", "hello~~"); 에 대해서 알아보자. addAttribute는 (key, value) 형태이다. 즉, key가 data, value가 hello~~인 것이다. (view 코드(html파일)에서 ${data}로 hello~~를 불러오게 된다.)

마지막으로, return "hello";는 hello.html을 렌더링하라는 의미이다. SpringBoot는 해당 return 코드가 실행되면 resources/templates/hello.html을 찾아서 렌더링하도록 세팅되어 있다.

마지막으로, 그림으로 동작 과정을 이해해보자.

1. 웹 브라우저가 localhost:8080/hello를 요청한다.

2. 내장 tomcat 서버가 스프링 컨테이너에게 요청을 넘긴다.

3. 컨테이너는 Controller에서 hello에 맵핑된 메소드가 존재하는지 확인한다. @GetMapping()이 존재한다면 맵핑된 hello() 메서드를 호출한다.

4. return 값인 hello를 보내고, 동시에 model에 (key:value)형태의 데이터인 (data:hello~~) 를 넣어 보낸다.

5. src/main/resources/templates에서 View에 해당하는 hello.html을 찾아주고, 템플릿 엔진을 연결해주는 viewResolver가 동작한다.

SpringBoot 템플릿 엔진은 기본적으로 viewName 매핑이 된다. 여기서 viewName 매핑이란, 'resources:templates + {viewName} + .html' 를 의미한다.

6. 템플릿엔진(thymeleaf)은 html 파일을 받아서 변환한 후에 웹 브라우저에 반환해준다.

'Spring' 카테고리의 다른 글

[Spring Boot] JPA 부터 Spring Data JPA까지 (0)	2024.04.14
[Spring] AOP (0)	2024.01.22

현재글[Spring] welcome page 만들기

happindex

Today :
Yesterday :

일	월	화	수	목	금	토
			1	2	3	4
5	6	7	8	9	10	11
12	13	14	15	16	17	18
19	20	21	22	23	24	25
26	27	28	29	30	31

happindex