Spring學習<四>模板引擎

常見的模板引擎有: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:srcth:href

th:each:遍歷循環元素,和th:text或th:value一起使用。

th:if:條件判斷,類似的還有th:unlessth:switchth:case

th:insert:代碼塊引入,類似的還有th:replaceth: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>


© 2011 The Good Thymes Virtual Grocery
/<code>

#{...} 消息表達式

消息表達式一般用於國際化的場景。結構: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等

五、listssets:集合方法,常用的方法有: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


分享到:


相關文章: