Junjangsee's Blog

SpringBoot - MVC Thymeleaf

2019-05-09

images

Thymeleaf(타임리프)

MVC에서 동적으로 컨텐츠를 생성하여 뷰로 출력시키는 역할을 하는 템플릿 엔진입니다.

JSP를 지양하는 이유

  • JSP는 자동설정을 지원하지 않는데다가 SpringBoot가 지향하는 독립적으로 실행가능한 임베디드 톰캣으로 빠르고 쉽게 개발하고 배포하는 의도와 다릅니다.
  • WAR파일로 패키징하여야 합니다.(물론 해결 방법은 있습니다.)
  • JBOSS에서 만든 가장 최신 Servlet 엔진 Undertow는 JSP를 지원하지 않습니다.
    참고문서 : 스프링공식문서



타임리프 의존성 추가하기

타임리프를 사용하기 위해선 의존성을 추가해주어야 합니다.

1
2
3
4
<dependency>
    <groupId>org.springframework.boot</groupId>
    <artifactId>spring-boot-starter-thymeleaf</artifactId>
</dependency>

Thymeleaf 의존성을 추가한 모습입니다.


테스트 클래스

뷰로 출력하기 Controller를 테스트합니다.

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
@RunWith(SpringRunner.class)
@WebMvcTest(SampleController.class)
public class SampleControllerTest {

    @Autowired
    MockMvc mockMvc;

    @Test
    public void hello() throws Exception {
        // 요청 "/hello"
        // 응답 모델 name : junjang
        // 응답 뷰 이름 : hello
        mockMvc.perform(get("/hello"))
                .andExpect(status().isOk())
                .andDo(print())
                .andExpect(view().name("hello"))
                .andExpect(model().attribute("name", is("junjang")));
    }
}

Thymeleaf 먼저 단순하게 응답시 Model과 View 이름을 확인하기 위한 코드입니다.
테스트를 실행시 404에러가 뜰텐데 이는 Controller에 명시한 경로가 없기 때문입니다.
Controller를 구현하러 이동합니다.


Controller 클래스

1
2
3
4
5
6
7
8
9
@Controller
public class SampleController {

    @GetMapping("/hello")
    public String hello(Model model) {
        model.addAttribute("name", "junjang");
        return "hello";
    }
}

Thymeleaf @Controller를 통해 View에 Model로 junjang이란 name의 데이터를 hello라는 뷰 이름으로 보냅니다.
테스트를 실행하면 템플릿인 hello가 없다는 오류가 출력됩니다. 아직 우리는 hello.html을 만들지 않았기 때문에 이제 만들러 가봅시다.

Thymeleaf /src/main/resources/​template/ 경로에 hello.html을 생성합니다.


테스트 클래스

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
@Test
public void hello() throws Exception {
    // 요청 : "/hello"
    // 응답 모델 name : junjang
    // 응답 뷰 이름 : hello

    mockMvc.perform (get ("/hello"))
            // 상태 테스트
            .andExpect(status().isOk())
            // 상태 출력하기
            .andDo(print())
            // 뷰 이름이 일치하는지 테스트
            .andExpect(view().name("hello"))
            // 값이 보내졌는지 테스트
            .andExpect(model().attribute("name", is("junjang")))
            // junjang이 view에 포함되어 있는지 테스트
            .andExpect(content().string(containsString("junjang")));
}

Thymeleaf 이번엔 junjang이란 값이 Model을 통해 넘어왔는데 그 문자열 값이 포함되어 있는지 테스트 코드를 작성 후 실행합니다.
그랬더니 값이 포함이 되어 있지 않다는 에러가 뜹니다.
이제 값을 포함 시키러 가보겠습니다.


HTML에 타임리프 적용하기

1
2
3
4
5
6
7
8
9
10
<!DOCTYPE html>
<html lang="en" xmlns:th="http://www.thymeleaf.org">
  <head>
    <meta charset="UTF-8" />
    <title>Title</title>
  </head>
  <body>
    <h1 th:text="${name}">Name</h1>
  </body>
</html>

Thymeleaf 타임리프 주소를 추가하면 th를 사용할 수 있습니다.
th에 맞는 문법을 사용하여 name을 출력하면 됩니다.

Thymeleaf junjang이라는 name 데이터가 뷰에 넘어와 출력된 것을 확인할 수 있습니다.

Tags: SpringBoot MVC Thymeleaf JSP
← SpringBoot - MVC Index, Favicon(인덱스, 파비콘) SpringBoot - MVC HtmlUnit →