常見的模板引擎有:JSP、Velocity、Freemarker、Thymeleaf
SpringBoot推薦使用Thymeleaf。
Thymeleaf
Thymeleaf是一個用於web和獨立環境的現代服務器端Java模板引擎,能夠處理HTML、XML、JavaScript、CSS甚至純文本。
Thymeleaf的主要目標是提供一種優雅且高度可維護的創建模板的方法。為了實現這一點,它基於自然模板的概念,以不影響模板用作設計原型的方式將其邏輯注入到模板文件中。這改善了設計的溝通,縮小了設計團隊和開發團隊之間的差距Thymeleaf 是一個優秀的、面向Java 的XML慶HTML/HTML5 頁面模板,具有豐富的標籤語言和函數。
常用屬性
th:text :設置當前元素的文本內容,相同功能的還有th:utext,兩者的區別在於前者不會轉義html標籤,後者會。
th:value:設置當前元素的value值,類似修改指定屬性的還有th:src,th:href。
th:each:遍歷循環元素,和th:text或th:value一起使用。
th:if:條件判斷,類似的還有th:unless,th:switch,th:case
th:insert:代碼塊引入,類似的還有th:replace,th:include。
th:fragment:定義代碼塊,方便被th:insert引用。
th:object:聲明變量,一般和*{}一起配合使用。
th:attr:修改任意屬性,實際開發中用的較少,因為有豐富的其他th屬性幫忙,類似的還有th:attrappend,th:attrprepend。
示例:
<code>
<title>Thymeleaf 語法/<title>
ITDragon Thymeleaf 語法
ID:
TH:
DE:
/<code>
常用表達式
${...} 變量表達式
@{...} 鏈接表達式
#{...} 消息表達式
~{...} 代碼塊表達式
*{...} 選擇變量表達式
~{...} 代碼塊表達式
支持兩種語法結構
推薦:~{templatename::fragmentname}
支持:~{templatename::#id}
templatename:模版名,Thymeleaf會根據模版名解析完整路徑:/resources/templates/templatename.html,要注意文件的路徑。
fragmentname:片段名,Thymeleaf通過th:fragment聲明定義代碼塊,即:th:fragment="fragmentname"
id:HTML的id選擇器,使用時要在前面加上#號,不支持class選擇器。
代碼塊表達式的使用
代碼塊表達式需要配合th屬性(th:insert,th:replace,th:include)一起使用。
th:insert:將代碼塊片段整個插入到使用了th:insert的HTML標籤中,
th:replace:將代碼塊片段整個替換使用了th:replace的HTML標籤中,
th:include:將代碼塊片段包含的內容插入到使用了th:include的HTML標籤中,
用一個官方例子來區分三者的不同,第三部分會通過實戰再次用到該知識。
<code>
<footer>
© 2011 The Good Thymes Virtual Grocery
/<footer>
<footer>
© 2011 The Good Thymes Virtual Grocery
/<footer>
<footer>
© 2011 The Good Thymes Virtual Grocery
/<footer>/<code>
© 2011 The Good Thymes Virtual Grocery
#{...} 消息表達式
消息表達式一般用於國際化的場景。結構:th:text="#{msg}" 。
@{...} 鏈接表達式
鏈接表達式好處
不管是靜態資源的引用,form表單的請求,凡是鏈接都可以用@{...} 。這樣可以動態獲取項目路徑,即便項目名變了,依然可以正常訪問
<code>#修改項目名,鏈接表達式會自動修改路徑,避免資源文件找不到
server.context-path=/itdragon/<code>
鏈接表達式結構
無參:@{/xxx}
有參:@{/xxx(k1=v1,k2=v2)} 對應url結構:xxx?k1=v1&k2=v2
引入本地資源:@{/項目本地的資源路徑}
引入外部資源:@{/webjars/資源在jar包中的路徑}
列舉:第三部分的實戰引用會詳細使用該表達式
<code><link>
<link>
/<code>
${...}變量表達式
變量表達式有豐富的內置方法,使其更強大,更方便。
變量表達式功能
一、可以獲取對象的屬性和方法
二、可以使用ctx,vars,locale,request,response,session,servletContext內置對象
三、可以使用dates,numbers,strings,objects,arrays,lists,sets,maps等內置方法(重點介紹)
常用的內置對象
一、ctx :上下文對象。
二、vars :上下文變量。
三、locale:上下文的語言環境。
四、request:(僅在web上下文)的 HttpServletRequest 對象。
五、response:(僅在web上下文)的 HttpServletResponse 對象。
六、session:(僅在web上下文)的 HttpSession 對象。
七、servletContext:(僅在web上下文)的 ServletContext 對象
這裡以常用的Session舉例,用戶刊登成功後,會把用戶信息放在Session中,Thymeleaf通過內置對象將值從session中獲取。
<code>// java 代碼將用戶名放在session中
session.setAttribute("userinfo",username);
// Thymeleaf通過內置對象直接獲取
th:text="${session.userinfo}"/<code>
常用的內置方法
一、strings:字符串格式化方法,常用的Java方法它都有。比如:equals,equalsIgnoreCase,length,trim,toUpperCase,toLowerCase,indexOf,substring,
replace,startsWith,endsWith,contains,containsIgnoreCase等
二、numbers:數值格式化方法,常用的方法有:formatDecimal等
三、bools:布爾方法,常用的方法有:isTrue,isFalse等
四、arrays:數組方法,常用的方法有:toArray,length,isEmpty,contains,containsAll等
五、lists,sets:集合方法,常用的方法有:toList,size,isEmpty,contains,containsAll,sort等
六、maps:對象方法,常用的方法有:size,isEmpty,containsKey,containsValue等
七、dates:日期方法,常用的方法有:format,year,month,hour,createNow等
SpringBoot集成
依賴:
<code>
<dependency>
<groupid>org.springframework.boot/<groupid>
<artifactid>spring-boot-starter-thymeleaf/<artifactid>
/<dependency>/<code>
配置文件:
<code>###ThymeLeaf配置
spring:
thymeleaf:
#模板的模式,支持 HTML, XML TEXT JAVASCRIPT
mode: HTML5
#編碼 可不用配置
encoding: UTF-8
#內容類別,可不用配置
content-type: text/html
#開發配置為false,避免修改模板還要重啟服務器
cache: false
#配置模板路徑,默認是templates,可以不用配置
prefix: classpath:/templates/<code>
只要我們把HTML頁面放在classpath:/templates/,thymeleaf就能自動渲染;
導入thymeleaf的名稱空間:
<code>
Controller:
<code> @GetMapping(value = "/test")
\t public ModelAndView test(HttpServletRequest req) {
\t ModelAndView mv = new ModelAndView();
\t mv.addObject("hello", hello);
\t mv.setViewName("/user/show.html");
\t return mv;
\t }
/<code>
頁面:
<code>
<title>Title/<title>成功!
這是顯示歡迎信息
/<code>
部分示例引入:https://www.cnblogs.com/itdragon/archive/2018/04/13/8724291.html
閱讀更多 代碼接盤俠 的文章