TIL - 2024/10/22 Spring View Engine과 Build - kcdevdes.log🧑🏻‍💻

Spring Static Page

스프링 공식 문서에서는 다음과 같이 설명한다.

Spring Boot supports both static and templated welcome pages. It first looks for an index.html file in the configured static content locations. If one is not found, it then looks for an index template. If either is found, it is automatically used as the welcome page of the application.

This only acts as a fallback for actual index routes defined by the application. The ordering is defined by the order of HandlerMapping beans which is by default the following:

정적, 템플릿화된 웰컴 페이지를 모두 지원한다. 먼저, index.html 파일이 resources/static 디렉토리에 위치해 있는지 확인하고, 없는 경우엔 index template(엔진 종류에 따라 다름)을 찾게 된다. 하나라도 발견되면 그게 웰컴페이지로 자동 등록이 된다.

당연하지만 이런 방식보다는 실제 index 라우터를 추가하는 것이 좋다. 이러한 순서는 HandlerMapping이란 빈에 기본 등록되어있다고 명시되어있다.

Spring View Engine

Spring에서는 다양한 View Engine을 지원한다. 여기서 사용한 엔진의 이름은 Thymeleaf로 간단한 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>

이런 코드를 작성하면 viewResolver가 작동하여 Template Engine에게 데이터와 HTML로 만들라는 요청을 보내고, 이를 스프링 부트가 변환하게 된다.

실행하는 코드는 다음과 같다.

package hello.hello_spring.controller;

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

@Controller
public class HelloController {

    /**
     * thymeleaf 템플릿 엔진을 동작시킨다.
     * 요청 -> 톰캣 서버 (/hello 라우팅) -> 스프링부트 helloController
     * -> viewResolver(템플릿 엔진 처리) -> html 변환 -> 반환
     *
     * 패턴
     * resources:templates/{ViewName}.html
     * @param model
     * @return
     */
    @GetMapping("hello")
    public String hello(Model model) {
        model.addAttribute("data", "Hello!!");
        return "hello";
    }
}

Build, Distribute, and Handle Fallback

gradle은 스프링을 구성하는 설정을 담고 있다. 이를 통해 우린 스프링 파일을 하나의 .jar파일로 만들어 맘껏 배포할 수 있다.

./gradlew build # 프로젝트 빌드하기

해당 명령을 통해 만들어진 .jar파일은 /build/libs안에 위치한다. Java 가상머신이 설치된 컴퓨터라면 어디서든 실행이 가능해지는 것이다.

java -jar <만들어진 파일 이름> # 해당 파일을 가동

스프링이 실행이 시작될 것이다.

./gradlew clean

만약 실행되지 않는다면 위의 코드를 실행해보면 프로젝트 캐시, 파일 등이 전부 날라가서 오류 상황에서 요긴하게 사용할 수 있다.

TIL – 2024/10/22 Spring View Engine과 Build

Spring Static Page

Spring View Engine

Build, Distribute, and Handle Fallback

Leave a Reply Cancel reply