示例
第一步：創建demo3.html
<!DOCTYPE html>
<html lang="en" xmlns:th="http://www.thymeleaf.org">
<head>
<meta charset="UTF-8">
<title>IT Thymeleaf 內置方法</title>
</head>
<body>
<h3>#strings </h3>
<div th:if="${not #strings.isEmpty(itStr)}" >
<p>Old Str : <span th:text="${itStr}"/></p>
<p>toUpperCase : <span th:text="${#strings.toUpperCase(itStr)}"/></p>
<p>toLowerCase : <span th:text="${#strings.toLowerCase(itStr)}"/></p>
<p>equals : <span th:text="${#strings.equals(itStr, 'helloworld')}"/></p>
<p>equalsIgnoreCase : <span th:text="${#strings.equalsIgnoreCase(itStr, 'helloworld')}"/></p>
<p>indexOf : <span th:text="${#strings.indexOf(itStr, 'r')}"/></p>
<p>substring : <span th:text="${#strings.substring(itStr, 2, 8)}"/></p>
<p>replace : <span th:text="${#strings.replace(itStr, 'or', 'IT')}"/></p>
<p>startsWith : <span th:text="${#strings.startsWith(itStr, 'he')}"/></p>
<p>contains : <span th:text="${#strings.contains(itStr, 'ow')}"/></p>
</div>
<h3>#numbers </h3>
<div>
<p>formatDecimal 整數部分隨意，小數點後保留兩位，四捨五入: <span th:text="${#numbers.formatDecimal(itNum, 0, 2)}"/></p>
<p>formatDecimal 整數部分保留五位數，小數點後保留兩位，四捨五入: <span th:text="${#numbers.formatDecimal(itNum, 5, 2)}"/></p>
</div>
<h3>#bools </h3>
<div th:if="${#bools.isTrue(itBool)}">
<p th:text="${itBool}"></p>
</div>
<h3>#arrays </h3>
<div th:if="${not #arrays.isEmpty(itArray)}">
<p>length : <span th:text="${#arrays.length(itArray)}"/></p>
<p>contains : <span th:text="${#arrays.contains(itArray, 5)}"/></p>
<p>containsAll : <span th:text="${#arrays.containsAll(itArray, itArray)}"/></p>
</div>
<h3>#lists </h3>
<div th:if="${not #lists.isEmpty(itList)}">
<p>size : <span th:text="${#lists.size(itList)}"/></p>
<p>contains : <span th:text="${#lists.contains(itList, 0)}"/></p>
<p>sort : <span th:text="${#lists.sort(itList)}"/></p>
</div>
<h3>#maps </h3>
<div th:if="${not #maps.isEmpty(itMap)}">
<p>size : <span th:text="${#maps.size(itMap)}"/></p>
<p>containsKey : <span th:text="${#maps.containsKey(itMap, 'thName')}"/></p>
<p>containsValue : <span th:text="${#maps.containsValue(itMap, '#maps')}"/></p>
</div>
<h3>#dates </h3>
<div>
<p>format : <span th:text="${#dates.format(itDate)}"/></p>
<p>custom format : <span th:text="${#dates.format(itDate, 'yyyy-MM-dd HH:mm:ss')}"/></p>
<p>day : <span th:text="${#dates.day(itDate)}"/></p>
<p>month : <span th:text="${#dates.month(itDate)}"/></p>
<p>monthName : <span th:text="${#dates.monthName(itDate)}"/></p>
<p>year : <span th:text="${#dates.year(itDate)}"/></p>
<p>dayOfWeekName : <span th:text="${#dates.dayOfWeekName(itDate)}"/></p>
<p>hour : <span th:text="${#dates.hour(itDate)}"/></p>
<p>minute : <span th:text="${#dates.minute(itDate)}"/></p>
<p>second : <span th:text="${#dates.second(itDate)}"/></p>
<p>createNow : <span th:text="${#dates.createNow()}"/></p>
</div>
</body>
</html>
第二步：對應的Controller
@RequestMapping("demo3")
public String demo3(ModelMap modelMap) {
modelMap.put("itStr", "HelloWorld");
modelMap.put("itNum", 888.888D);
modelMap.put("itBool", true);
modelMap.put("itArray", new Integer[]{1,2,3,4});
modelMap.put("itList", Arrays.asList(1,3,2,4,0));
Map itMap = new HashMap();
itMap.put("thName", "${#...}");
itMap.put("desc", "變量表達式內置方法");
modelMap.put("itMap", itMap);
modelMap.put("itDate", new Date());
return "demo3";
}
結果：
Thymeleaf工具API
#dates
/*
* 使用標準區域設置格式格式化日期
* 也同樣適用於數組、列表或集合
*/
${#dates.format(date)}
${#dates.arrayFormat(datesArray)}
${#dates.listFormat(datesList)}
${#dates.setFormat(datesSet)}
/*
* 使用ISO8601格式格式化日期
* 也同樣適用於數組、列表或集合
*/
${#dates.formatISO(date)}
${#dates.arrayFormatISO(datesArray)}
${#dates.listFormatISO(datesList)}
${#dates.setFormatISO(datesSet)}
/*
* 使用指定的格式格式化日期，比如 ${#dates.format(date,'yyyy-MM-dd HH:mm:ss')}
* 也同樣適用於數組、列表或集合
*/
${#dates.format(date, 'dd/MMM/yyyy HH:mm')}
${#dates.arrayFormat(datesArray, 'dd/MMM/yyyy HH:mm')}
${#dates.listFormat(datesList, 'dd/MMM/yyyy HH:mm')}
${#dates.setFormat(datesSet, 'dd/MMM/yyyy HH:mm')}
/*
* 獲取日期屬性
* 也同樣適用於數組、列表或集合
*/
${#dates.day(date)} // 也可以是 arrayDay(...), listDay(...)之類的
${#dates.month(date)} // 也可以是 arrayMonth(...), listMonth(...)之類的
${#dates.monthName(date)} // 也可以是 arrayMonthName(...), listMonthName(...)之類的
${#dates.monthNameShort(date)} // 也可以是 arrayMonthNameShort(...), listMonthNameShort(...)之類的
${#dates.year(date)} // 也可以是 arrayYear(...), listYear(...)之類的
${#dates.dayOfWeek(date)} // 也可以是 arrayDayOfWeek(...), listDayOfWeek(...)之類的
${#dates.dayOfWeekName(date)} // 也可以是 arrayDayOfWeekName(...), listDayOfWeekName(...)之類的
${#dates.dayOfWeekNameShort(date)} // 也可以是 arrayDayOfWeekNameShort(...), listDayOfWeekNameShort(...)之類的
${#dates.hour(date)} // 也可以是 arrayHour(...), listHour(...)之類的
${#dates.minute(date)} // 也可以是 arrayMinute(...), listMinute(...)之類的
${#dates.second(date)} // 也可以是 arraySecond(...), listSecond(...)之類的
${#dates.millisecond(date)} // 也可以是 arrayMillisecond(...), listMillisecond(...)之類的
/*
* 根據year,month,day創建日期(java.util.Date)對象，比如 ${#dates.create('2008','08','08')}
*/
${#dates.create(year,month,day)}
${#dates.create(year,month,day,hour,minute)}
${#dates.create(year,month,day,hour,minute,second)}
${#dates.create(year,month,day,hour,minute,second,millisecond)}
/*
* 創建當前日期和時間創建日期(java.util.Date)對象，比如 ${#dates.format(#dates.createNow(),'yyyy-MM-dd HH:mm:ss')}
*/
${#dates.createNow()}
${#dates.createNowForTimeZone()}
/*
* 創建當前日期創建一個日期(java.util.Date)對象(時間設置爲00:00)
*/
${#dates.createToday()}
${#dates.createTodayForTimeZone()}
#Calendars
/*
* 使用標準區域設置格式格式化日曆
* 也同樣適用於數組、列表或集合
*/
${#calendars.format(cal)}
${#calendars.arrayFormat(calArray)}
${#calendars.listFormat(calList)}
${#calendars.setFormat(calSet)}
/*
* 使用ISO8601格式格式化日曆
* 也同樣適用於數組、列表或集合
*/
${#calendars.formatISO(cal)}
${#calendars.arrayFormatISO(calArray)}
${#calendars.listFormatISO(calList)}
${#calendars.setFormatISO(calSet)}
/*
* 使用指定的格式格式化日曆
* 也同樣適用於數組、列表或集合
*/
${#calendars.format(cal, 'dd/MMM/yyyy HH:mm')}
${#calendars.arrayFormat(calArray, 'dd/MMM/yyyy HH:mm')}
${#calendars.listFormat(calList, 'dd/MMM/yyyy HH:mm')}
${#calendars.setFormat(calSet, 'dd/MMM/yyyy HH:mm')}
/*
* 獲取日曆屬性
* 也同樣適用於數組、列表或集合
*/
${#calendars.day(date)} // 也可以是 arrayDay(...), listDay(...)之類的
${#calendars.month(date)} // 也可以是 arrayMonth(...), listMonth(...)之類的
${#calendars.monthName(date)} // 也可以是 arrayMonthName(...), listMonthName(...)之類的
${#calendars.monthNameShort(date)} // 也可以是 arrayMonthNameShort(...), listMonthNameShort(...)之類的
${#calendars.year(date)} // 也可以是 arrayYear(...), listYear(...)之類的
${#calendars.dayOfWeek(date)} // 也可以是 arrayDayOfWeek(...), listDayOfWeek(...)之類的
${#calendars.dayOfWeekName(date)} // 也可以是 arrayDayOfWeekName(...), listDayOfWeekName(...)之類的
${#calendars.dayOfWeekNameShort(date)} // 也可以是 arrayDayOfWeekNameShort(...), listDayOfWeekNameShort(...)之類的
${#calendars.hour(date)} // 也可以是 arrayHour(...), listHour(...)之類的
${#calendars.minute(date)} // 也可以是 arrayMinute(...), listMinute(...)之類的
${#calendars.second(date)} // 也可以是 arraySecond(...), listSecond(...)之類的
${#calendars.millisecond(date)} // 也可以是 arrayMillisecond(...), listMillisecond(...)之類的
/*
* 從其組件創建日曆(java.util.Calendar)對象
*/
${#calendars.create(year,month,day)}
${#calendars.create(year,month,day,hour,minute)}
${#calendars.create(year,month,day,hour,minute,second)}
${#calendars.create(year,month,day,hour,minute,second,millisecond)}
${#calendars.createForTimeZone(year,month,day,timeZone)}
${#calendars.createForTimeZone(year,month,day,hour,minute,timeZone)}
${#calendars.createForTimeZone(year,month,day,hour,minute,second,timeZone)}
${#calendars.createForTimeZone(year,month,day,hour,minute,second,millisecond,timeZone)}
/*
* 爲當前日期和時間創建一個日曆(java.util.Calendar)對象
*/
${#calendars.createNow()}
${#calendars.createNowForTimeZone()}
/*
* 爲當前日期創建日曆(java.util.Calendar)對象(時間設置爲00:00)
*/
${#calendars.createToday()}
${#calendars.createTodayForTimeZone()}
#numbers
/*
* ==========================
* 格式化整數
* ==========================
*/
/*
* 設置最小整數位數。
* 也同樣適用於數組、列表或集合
*/
${#numbers.formatInteger(num,3)}
${#numbers.arrayFormatInteger(numArray,3)}
${#numbers.listFormatInteger(numList,3)}
${#numbers.setFormatInteger(numSet,3)}
/*
* 設置最小整數位數和千位分隔符：
* 'POINT'、'COMMA'、'WHITESPACE'、'NONE' 或 'DEFAULT'(根據本地化)。
* 也同樣適用於數組、列表或集合
*/
${#numbers.formatInteger(num,3,'POINT')}
${#numbers.arrayFormatInteger(numArray,3,'POINT')}
${#numbers.listFormatInteger(numList,3,'POINT')}
${#numbers.setFormatInteger(numSet,3,'POINT')}
/*
* ==========================
* 格式化十進制數
* ==========================
*/
/*
* 設置最小整數數字和(精確的)十進制數字。
* 也同樣適用於數組、列表或集合
*/
${#numbers.formatDecimal(num,3,2)}
${#numbers.arrayFormatDecimal(numArray,3,2)}
${#numbers.listFormatDecimal(numList,3,2)}
${#numbers.setFormatDecimal(numSet,3,2)}
/*
* 設置最小整數數字和(精確的)小數位數, 以及小數分隔符。
* 也同樣適用於數組、列表或集合
*/
${#numbers.formatDecimal(num,3,2,'COMMA')}
${#numbers.arrayFormatDecimal(numArray,3,2,'COMMA')}
${#numbers.listFormatDecimal(numList,3,2,'COMMA')}
${#numbers.setFormatDecimal(numSet,3,2,'COMMA')}
/*
* 設置最小整數數字和(精確的)十進制數字, 以及千位和十進制分隔符。
* 也同樣適用於數組、列表或集合
*/
${#numbers.formatDecimal(num,3,'POINT',2,'COMMA')}
${#numbers.arrayFormatDecimal(numArray,3,'POINT',2,'COMMA')}
${#numbers.listFormatDecimal(numList,3,'POINT',2,'COMMA')}
${#numbers.setFormatDecimal(numSet,3,'POINT',2,'COMMA')}
/*
* ==========================
* 實用方法
* ==========================
*/
/*
* 創建一個從x到y的整數序列(數組)
*/
${#numbers.sequence(from,to)}
${#numbers.sequence(from,to,step)}
示例：
<p th:utext="${#numbers.formatInteger(0.1024,3)}"></p>
<p th:utext="${#numbers.formatInteger(1.024,3)}"></p>
<p th:utext="${#numbers.formatInteger(10.24,3)}"></p>
<p th:utext="${#numbers.formatInteger(102.4,3)}"></p>
<br><br>
<p th:utext="${#numbers.formatInteger(1.024,2,'POINT')}"></p>
<p th:utext="${#numbers.formatInteger(1024,3,'POINT')}"></p>
<p th:utext="${#numbers.formatInteger(1024,10,'POINT')}"></p>
<p th:utext="${#numbers.formatInteger(1.024,2,'COMMA')}"></p>
<p th:utext="${#numbers.formatInteger(1024,3,'COMMA')}"></p>
<p th:utext="${#numbers.formatInteger(1024,10,'COMMA')}"></p>
<p th:utext="${#numbers.formatInteger(1.024,2,'WHITESPACE')}"></p>
<p th:utext="${#numbers.formatInteger(1024,3,'WHITESPACE')}"></p>
<p th:utext="${#numbers.formatInteger(1024,10,'WHITESPACE')}"></p>
#strings
/*
* Null-safe toString()
*/
${#strings.toString(obj)} // 也可以是 array*、list* 或 set*
/*
* 檢查String是否爲空(或null)。在檢查之前執行trim()操作也同樣適用於數組、列表或集合
*/
${#strings.isEmpty(name)}
${#strings.arrayIsEmpty(nameArr)}
${#strings.listIsEmpty(nameList)}
${#strings.setIsEmpty(nameSet)}
/*
* 對字符串執行“isEmpty()”檢查, 如果爲false則返回它, 如果爲true則默認爲另一個指定的字符串。
* 也同樣適用於數組、列表或集合
*/
${#strings.defaultString(text,default)}
${#strings.arrayDefaultString(textArr,default)}
${#strings.listDefaultString(textList,default)}
${#strings.setDefaultString(textSet,default)}
/*
* 檢查字符串中是否包含片段，比如 ${#strings.containsIgnoreCase(user.name,'kang')}
* 也同樣適用於數組、列表或集合
*/
${#strings.contains(name,'ez')} // 也可以是 array*、list* 或 set*
${#strings.containsIgnoreCase(name,'ez')} // 也可以是 array*、list* 或 set*
/*
* 檢查字符串是否以片段開始或結束
* 也同樣適用於數組、列表或集合
*/
${#strings.startsWith(name,'Don')} // 也可以是 array*、list* 或 set*
${#strings.endsWith(name,endingFragment)} // 也可以是 array*、list* 或 set*
/*
* 子串相關操作
* 也同樣適用於數組、列表或集合
*/
${#strings.indexOf(name,frag)} // 也可以是 array*、list* 或 set*
${#strings.substring(name,3,5)} // 也可以是 array*、list* 或 set*
${#strings.substringAfter(name,prefix)} // 也可以是 array*、list* 或 set*
${#strings.substringBefore(name,suffix)} // 也可以是 array*、list* 或 set*
${#strings.replace(name,'las','ler')} // 也可以是 array*、list* 或 set*
/*
* 附加和前置
* 也同樣適用於數組、列表或集合
*/
${#strings.prepend(str,prefix)} // 也可以是 array*、list* 或 set*
${#strings.append(str,suffix)} // 也可以是 array*、list* 或 set*
/*
* 大小寫轉換
* 也同樣適用於數組、列表或集合
*/
${#strings.toUpperCase(name)} // 也可以是 array*、list* 或 set*
${#strings.toLowerCase(name)} // 也可以是 array*、list* 或 set*
/*
* 拆分和拼接
*/
${#strings.arrayJoin(namesArray,',')}
${#strings.listJoin(namesList,',')}
${#strings.setJoin(namesSet,',')}
${#strings.arraySplit(namesStr,',')} // 返回String []
${#strings.listSplit(namesStr,',')} // 返回List<String>
${#strings.setSplit(namesStr,',')} // 返回Set<String>
/*
* Trim
* 也同樣適用於數組、列表或集合
*/
${#strings.trim(str)} // 也可以是 array*、list* 或 set*
/*
* 計算長度
* 也同樣適用於數組、列表或集合
*/
${#strings.length(str)} // 也可以是 array*、list* 或 set*
/*
* 縮寫文本, 使其最大大小爲n。如果文本較大, 它將被剪輯並在末尾附加“...”
* 也同樣適用於數組、列表或集合
*/
${#strings.abbreviate(str,10)} // 也可以是 array*、list* 或 set*
/*
* 將第一個字符轉換爲大寫(反之亦然)
*/
${#strings.capitalize(str)} // 也可以是 array*、list* 或 set*
${#strings.unCapitalize(str)} // 也可以是 array*、list* 或 set*
/*
* 將每個單詞的第一個字符轉換爲大寫
*/
${#strings.capitalizeWords(str)} // 也可以是 array*、list* 或 set*
${#strings.capitalizeWords(str,delimiters)} // 也可以是 array*、list* 或 set*
/*
* 轉義字符串
*/
${#strings.escapeXml(str)} // 也可以是 array*、list* 或 set*
${#strings.escapeJava(str)} // 也可以是 array*、list* 或 set*
${#strings.escapeJavaScript(str)} // 也可以是 array*、list* 或 set*
${#strings.unescapeJava(str)} // 也可以是 array*、list* 或 set*
${#strings.unescapeJavaScript(str)} // 也可以是 array*、list* 或 set*
/*
* 空安全比較和連接
*/
${#strings.equals(first, second)}
${#strings.equalsIgnoreCase(first, second)}
${#strings.concat(values...)}
${#strings.concatReplaceNulls(nullValue, values...)}
/*
* 隨機數
*/
${#strings.randomAlphanumeric(count)}
#objects
/*
* 當obj不爲空時，返回obj，否則返回default默認值
* 其同樣適用於數組、列表或集合
*/
${#objects.nullSafe(obj,default)}
${#objects.arrayNullSafe(objArray,default)}
${#objects.listNullSafe(objList,default)}
${#objects.setNullSafe(objSet,default)}
#bools
/*
* 評估條件, 類似於 th:if 標籤
* 也同樣適用於數組、列表或集合
*/
${#bools.isTrue(obj)}
${#bools.arrayIsTrue(objArray)}
${#bools.listIsTrue(objList)}
${#bools.setIsTrue(objSet)}
/*
* 用否定來評估條件
* 也同樣適用於數組、列表或集合
*/
${#bools.isFalse(cond)}
${#bools.arrayIsFalse(condArray)}
${#bools.listIsFalse(condList)}
${#bools.setIsFalse(condSet)}
/*
* 評估條件並執行與操作
* 接收數組、列表或集合作爲參數
*/
${#bools.arrayAnd(condArray)}
${#bools.listAnd(condList)}
${#bools.setAnd(condSet)}
/*
* 評估條件並執行或操作
* 接收數組、列表或集合作爲參數
*/
${#bools.arrayOr(condArray)}
${#bools.listOr(condList)}
${#bools.setOr(condSet)}
#arrays
/*
* 轉換爲數組, 試圖推斷數組組件類。注意, 如果結果數組爲空, 或者目標對象的元素不是全部相同的類, 則
* 此方法將返回Object []。
*/
${#arrays.toArray(object)}
/*
* 轉換爲指定組件類的數組。
*/
${#arrays.toStringArray(object)}
${#arrays.toIntegerArray(object)}
${#arrays.toLongArray(object)}
${#arrays.toDoubleArray(object)}
${#arrays.toFloatArray(object)}
${#arrays.toBooleanArray(object)}
/*
* 計算數組長度
*/
${#arrays.length(array)}
/*
* 檢查數組是否爲空
*/
${#arrays.isEmpty(array)}
/*
* 檢查數組中是否包含元素或元素集合
*/
${#arrays.contains(array, element)}
${#arrays.containsAll(array, elements)}
#lists
/*
* 轉化爲 list
*/
${#lists.toList(object)}
/*
* 計算大小
*/
${#lists.size(list)}
/*
*/
${#lists.isEmpty(list)}
/*
* 檢查list中是否包含元素或元素集合
*/
${#lists.contains(list, element)}
${#lists.containsAll(list, elements)}
/*
* 排序給定列表的副本。列表的成員必須
* 實現comparable, 或者必須定義comparator。
*/
${#lists.sort(list)}
${#lists.sort(list, comparator)}
#sets
/*
* 轉化爲 to set
*/
${#sets.toSet(object)}
/*
* 計算大小
*/
${#sets.size(set)}
/*
* 檢查set是否爲empty
*/
${#sets.isEmpty(set)}
/*
* 檢查set中是否包含元素或元素集合
*/
${#sets.contains(set, element)}
${#sets.containsAll(set, elements)}
#maps
/*
* 計算大小
*/
${#maps.size(map)}
/*
* 檢查map是否爲空
*/
${#maps.isEmpty(map)}
/*
* 檢查map中是否包含key/s或value/s
*/
${#maps.containsKey(map, key)}
${#maps.containsAllKeys(map, keys)}
${#maps.containsValue(map, value)}
${#maps.containsAllValues(map, value)}
#aggregates
/*
* Compute sum. Returns null if array or collection is empty
*/
${#aggregates.sum(array)}
${#aggregates.sum(collection)}
/*
* Compute average. Returns null if array or collection is empty
*/
${#aggregates.avg(array)}
${#aggregates.avg(collection)}
#messages
/*
* Obtain externalized messages. Can receive a single key, a key plus arguments,
* or an array/list/set of keys (in which case it will return an array/list/set of
* externalized messages).
* If a message is not found, a default message (like '??msgKey??') is returned.
*/
${#messages.msg('msgKey')}
${#messages.msg('msgKey', param1)}
${#messages.msg('msgKey', param1, param2)}
${#messages.msg('msgKey', param1, param2, param3)}
${#messages.msgWithParams('msgKey', new Object[] {param1, param2, param3, param4})}
${#messages.arrayMsg(messageKeyArray)}
${#messages.listMsg(messageKeyList)}
${#messages.setMsg(messageKeySet)}
/*
* Obtain externalized messages or null. Null is returned instead of a default
* message if a message for the specified key is not found.
*/
${#messages.msgOrNull('msgKey')}
${#messages.msgOrNull('msgKey', param1)}
${#messages.msgOrNull('msgKey', param1, param2)}
${#messages.msgOrNull('msgKey', param1, param2, param3)}
${#messages.msgOrNullWithParams('msgKey', new Object[] {param1, param2, param3, param4})}
${#messages.arrayMsgOrNull(messageKeyArray)}
${#messages.listMsgOrNull(messageKeyList)}
${#messages.setMsgOrNull(messageKeySet)}
#ids
/*
* Normally used in th:id attributes, for appending a counter to the id attribute value
* so that it remains unique even when involved in an iteration process.
*/
${#ids.seq('someId')}
/*
* Normally used in th:for attributes in <label> tags, so that these labels can refer to Ids
* generated by means if the #ids.seq(...) function.
*
* Depending on whether the <label> goes before or after the element with the #ids.seq(...)
* function, the "next" (label goes before "seq") or the "prev" function (label goes after
* "seq") function should be called.
*/
${#ids.next('someId')}
${#ids.prev('someId')}