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