SpringBoot系列:Spring Boot使用模板引擎Thymeleaf

  • 2019 年 10 月 13 日
  • 筆記

一、Java模板引擎

模板引擎(這裡特指用於Web開發的模板引擎)是為了使用戶介面與業務數據(內容)分離而產生的,它可以生成特定格式的文檔,用於網站的模板引擎就會生成一個標準的HTML文檔。

在java中,主要的模板引擎有JSP、Thymeleaf、FreeMarker、
Velocity等。

雖然隨著前後端分離的崛起和流行,模板引擎已遭受到冷落,但不少舊項目依然使用java的模板引擎渲染介面,而偶爾自己寫一些練手項目,使用模板引擎也比起前後端分離要來的快速。

本系列會分別講解SpringBoot怎麼集成JSP、Thymeleaf和FreeMarker,至於Velocity,高版本的SpringBoot已經不支援Velocity了,這裡也就不進行講解了。

而這一篇,主要講解Spring Boot如何集成Thymeleaf。

一、Spring Boot集成Thymeleaf

首先我們要引入依賴,除了核心的web依賴外,只需引入thymeleaf的statrer即可。

<dependency>      <groupId>org.springframework.boot</groupId>      <artifactId>spring-boot-starter-web</artifactId>  </dependency>    <!-- thymeleaf模板 -->  <dependency>      <groupId>org.springframework.boot</groupId>      <artifactId>spring-boot-starter-thymeleaf</artifactId>  </dependency>

然後就是配置文件了。spring.thymeleaf下配置視圖文件目錄prefix以及文件後綴suffix,如果是本地開發,cache可以設置為false關閉快取,避免修改文件後需要重新啟動服務。

server:    port: 10900    spring:    profiles:      active: dev    thymeleaf:      prefix: classpath:/templates/      check-template-location: true #是否檢查模板位置是否存在      suffix: .html      encoding: utf-8 #模板編碼      servlet:        content-type: text/html      mode: HTML5      cache: false #禁用快取,本地開發設置為false,避免修改後重啟伺服器

然後resoucres目錄下新建templates目錄,分別新建了hello.html和mv.html文件。

<h3>hello thymeleaf</h3>
<!DOCTYPE html>  <html lang="en" xmlns:th="http://www.thymeleaf.org">      <h3>mv thymeleaf</h3>      <span>I'm <span th:text="${name}"></span> from mv method</span>  </html>

這裡主要講解如何集成Thymeleaf,不對Thymeleaf語法做過多的講解,所以僅僅提供了兩個簡單的html文件作為演示。

接著再創建Controller類路由頁面,該類十分簡單,跳轉hello頁面,以及攜帶name=imyang跳轉mv頁面。

@Controller  @RequestMapping("index")  public class IndexApi {        @RequestMapping("/hello")      public String hello(){          return "hello";      }        @RequestMapping("/mv")      public ModelAndView mv(){          ModelAndView mv = new ModelAndView("mv");          mv.addObject("name","yanger");          return mv;      }    }

啟動項目,分別訪問http://localhost:10900/index/hello和http://localhost:10900/index/mv,可以看到已經可以展示頁面資訊了。

源碼地址:https://github.com/imyanger/springboot-project/tree/master/p18-springboot-thymeleaf