設置價格格式
<#setting number_format = "currency" />
<#assign price = 42 />
${price}-
${price?string}--
${price?string.number}---
${price?string.currency}----
${price?string.percent}-----
輸出結果:設置價格格式 ¥42.00- ¥42.00-- 42--- ¥42.00---- 4,200%-----
設置日期格式
<#assign lastUpdated = "2009-01-07 15:05"?datetime("yyyy-MM-dd HH:mm") />
${lastUpdated?string("yyyy-MM-dd HH:mm:ss zzzz")};
${lastUpdated?string("yyyy-MM-dd HH:mm:ss zzzz")};
${lastUpdated?string("EEE,MMM d,yy")};
${lastUpdated?string("EEEE,MMMM dd,yyyy,hh:mm:ss a '('zzz')'")};
${lastUpdated?string.short};
${lastUpdated?string.long};
輸出結果:
2009-01-07 15:05:00 中國標准時間;
2009-01-07 15:05:00 中國標准時間;
星期三,一月 7,09;
星期三,一月 07,2009,03:05:00 下午 (CST);
09-1-7 下午3:05;
2009年1月7日 下午03時05分00秒;
判斷布爾
<#assign foo=true />
${foo?string("是foo","非foo")}
輸出結果:
是foo
集合
<#assign mynums=[11,12,13,14,15,16,17,18,19]/>
<#list mynums as mn>
${mn}<br>
</#list>
輸出結果:(¥是默認格式數字)
¥12.00
¥13.00
¥14.00
¥15.00
¥16.00
¥17.00
¥18.00
¥19.00
拆分序列
<#-- 這里是將mynums序列中下標從3到6之間的元素拆分出來,組成一個新的序列 -->
<#assign mynum01=mynums[3..6]/>
<#list mynum01 as mn01>
${mn01}
</#list>
輸出結果:
¥14.00
¥15.00
¥16.00
¥17.00
字符串的拆分(截取字符串)
<br>
${"你好,你來了嗎今天看書了嗎!"[0..8]}
<br>
你好,你來了嗎今天...
輸出結果:
你好,你來了嗎今天
你好,你來了嗎今天...
連續序列(即num01為完整集合不是拆分的)
從55到58:注意此時若寫成[55..58]或者[66..68]則會報錯
<#assign num01=55..58/>
<#list num01 as num>
${num}
</#list>
<#list 66..68 as num>
${num}
</#list>
哈希表(Map)
定義哈希表
<#assign maps={"1":"張三","2":"李四"}> ${maps["1"]} |
輸出結果:張三 |
<#--以下代碼可以將map的key轉換為相應的序列--> <#assign keys=maps?keys> <#list keys as key> ${key}---${maps[key]} </#list> |
輸出結果: 1---張三 2---李四 |
<#assign users={"username":"張三","password":"123"}> ${users.username}---${users["password"]} |
輸出結果: 張三---123 |
字符串操作
a、字符串鏈接
字符串連接有兩種語法
A、使用${..}(或#{..})在字符串常量部分插入表達式的值,從而完成字符串連接
B、直接使用連接運算符(+)來連接字符串
使用第一種語法來連接字符串
${"Hello,${user}!"}
第二種使用連接符號來連接字符串
${"Hello,"+user+"!"};
值的注意的是,${..}只能用於文本部分,因此,下面的代碼是錯誤的:
<#if ${isBig}>Wow!</#if>
<#if "${isBig}">Wow!</#if>
應該寫成:
<#if isBig>Wow!</#if>
集合連接運算符
這里所說的集合連接運算時將兩個集合連接成一個新的集合,連接集合的運算符是+,例如
<#list ["星期一"," 星期二","星期三"]+["星期四","星期五"] as x>
${x}
</#list>
Map連接運算符
Map對象的連接運算也是將兩個Map對象連接成一個新的Map對象,Map對象的連接運算符是+。如果兩個Map對象具有相同的 key,則后加入Map里的key所
對應的value替代原來key所對應的value
<#assign maps={"1":"張三","2":"李四"}+{"3":"張五","4":"李六"}>
${maps["1"]}
${maps["2"]}
${maps["3"]}
${maps["4"]}
輸出結果:張三 李四 張五 李六
算術運算符
FreeMarker表達式中完全支持算術運算,FreeMarker支持的算術運算符包括: +,-,*,/,%
看如下代碼示范
<#assign x = 5 />
${x* -100}
${x/2}
${12%10}
輸出結果:-500.00 2.50 2.00
在表達式中使用算術運算時要注意以下幾點。
A、運算符兩邊的運算數必須是數字,因此下面的代碼是錯誤的:
${3*"5"}
B、使用+(既可以作為加號,也可以作為字符串連接運算符)運算時,如果一邊是數字,一邊是字符串,就會自動將數字轉化為字符串。例如
${3+"5"}
輸出結果:35
C、使用內建的int函數可對數值取整。例如
<#assign x = 5>
${(x/2)?int}
${1.1?int}
${1.999?int}
${-1.9999?int}
${-1.1?int}
輸出結果:
2
1
1
-1
-1
比較運算符
表達式中支持的比較運算符有如下幾個
a、=(或者==):判斷兩個值是否相等.
b、!=:判斷兩個值是否不相等
c、 >(或者gt):判斷坐標值是否大於右邊值
d、 >=(或者gte):判斷坐標值是否大於等於右邊值
e、 <(或者lt):判斷左邊值是否小於右邊值
f、 <=(或者lte):判斷左邊值是否小於等於右邊值
邏輯運算符
邏輯運算符有如下幾個
a、邏輯與:&&
b、邏輯或:||
c、邏輯非:!
邏輯運算符只能作用於布爾值,否則將產生錯誤。
內建函數
FreeMarker還提供了一些內建函數來轉換輸出,可以在任何變量后緊跟?,?后緊跟內建函數,就可通過內建函數來轉換輸出變量
下面是常用的內建的字符串函數
a、html:對字符串進行HTML編碼
b、cap_first:將字符串第一個字母成大寫
c、lower_case:將字符串轉換成小寫
d、upper_case:將字符串轉換成大寫
e、trim: 去掉字符串前后的空白字符
下面是集合的常用的內建函數
a、size: 獲得序列中元素的數目
下面是數字值的常用的內建函數
a、int 取得數字的整數部分
例如
<#assign test="Tom & Jerry" />
${test?html}
${test?upper_case?html}
輸出結果:
Tom & Jerry
TOM & JERRY
空值處理運算符
FreeMarker對空值的處理非常嚴格,FreeMarker的變量必須有值,沒有被賦值的變量就會拋出異常。
FreeMarker 的常用指令
1、 if指令
分支控制語句
語法格式如下
<#if condition>
....
<#elseif condition2>
...
<#elseif condition3>
...
<#else>
...
</#if>
2、switch、case、default、break指令
<#switch value>
<#case refValue>
...
<#bread>
<#case refValue>
...
<#bread>
<#default>
...
</#switch>
雖然FreeMarker提供了switch指令,但它並不推薦使用switch指令來控制也輸出,而是推薦使用FreeMarker的if..elseif..else 指令來替代它。
3、list、break指令
list指令時一個典型的迭代輸出指令,用於迭代輸出數據模型中的集合。list指令的語法格式如下:
<#list sequence as item>
...
</#list>
除此之外,迭代集合對象時,還包括兩個特殊的循環變量:
a、item_index:當前變量的索引值。
b、item_has_next:是否存在下一個對象
也可以使用<#break>指令跳出迭代
<#list ["星期一","星期二","星期三","星期四","星期五"] as x>
${x_index +1}.${x} <#if x_has_next>,</#if>
<#if x = "星期四"><#break></#if>
</#list>
4、include 指令
include指令的作用類似於JSP的包含指令,用於包含指定頁,include指令的語法格式如下
<#include filename [options]
在上面的語法格式中,兩個參數的解釋如下
a、filename:該參數指定被包含的模板文件
b、options:該參數可以省略,指定包含時的選項,包含encoding和parse兩個選項,encoding指定包含頁面時所使用的解碼集,而parse指定被
包含是否作為FTL文件來解析。如果省略了parse選項值,則該選項值默認是true
5、 import指令
該指令用於導入FreeMarker模板中的所有變量,並將該變量放置在指定的Map對象中,import 指令的語法格式如下
<#import path as mapObject>
在上面的語法格式中,path指定要被導入的模板文件,而mapObject是一個Map對象名,通過這行代碼,將導致path模板中的所有變量都被放置
在mapObject中
<#import "/lib/common.ftl" as com>
6、noparse指令
noparse指令指定FreeMarker不處理該指令里包含的內容,該指令的語法格式如下:
<#noparse>
...
</#noparse>
7、escape、noescape指令
8、assign指令
它用於為該模板頁面創建或替換一個頂層變量
9、setting指令
該指令用於設置FreeMarker的運行環境,該指令的語法格式如下:
<#setting name = value>
name 的取值范圍包括如下幾個
locale :該選項指定該模板所用的國家/語言選項
number_format:該選項指定格式化輸出數字的格式
boolean_format:該選項指定兩個布爾值的語法格式,默認值是"true、false"
date_format,time_format,datetime_format:該選項指定格式化輸出日期的格式
time_zone: 設置格式化輸出日期時所使用的時區
10、macro、nested、return指令