freemarker基础语法

freemarker常见语法大全

一、FreeMarker模板文件主要有4个部分组成

1、文本:直接输出的部分

2、注释:即<#--...-->格式不会输出

3、插值（Interpolation）：即${..}或者#{..}格式的部分,将使用数据模型中的部分替代输出

4、FTL指令：FreeMarker指令，和HTML标记类似，名字前加#予以区分，不会输出。

插值规则:

 

1、通用插值：${expr}

2、数字格式化插值：#{expr}或者#{expr;format}

通用插值:

1.插值结果为字符串值：直接输出表达式结果

2.插值结果为数字值：根据默认格式(#setting 指令设置)将表达式结果转换成文本输出。可以使用内建的字符串函数格式

示例:

<#setting number_format = "currency" />  <#assign price = 42 />  ${price}  ${price?string}  ${price?string.number}  ${price?string.currency}  ${price?string.percent}  

3.输出值为日期值：根据默认格式(由 #setting 指令设置)将表达式结果转换成文本输出，可以使用内建的字符串函数格式化单个插值

示例:

<#assign lastUpdated = "2009-01-07 15:05"?datetime("yyyy-MM-dd HH:mm") />  ${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};  ${lastUpdated?String.full};  

4.插值结果为布尔值

示例:

<#assign foo=true />${foo?string("是foo","非foo")}

5. 数字格式化插值:数字格式化插值可采用#{expr;format}的形式来格式化数字,format可以是

mX:小数部分最小X位

MX:小数部分最大X位

示例:

<#assign x = 2.582 />  <#assign y =4 />  #{x;M2};  #{y;M2};  #{x;m1};  #{y;m1};  #{x;m1M2};  #{y:m1M2};  

二、表达式

1、直接指定值

示例:

${'我的名字是\"yeek\"'};
${"我的文件保存在d：\\盘"};
         

2.日期型

FreeMarker支持date、time、datetime三种类型，这三种类型的值无法直接指定，通常需要借助字符串的date、time、datetime三个内建函数进行转换

示例:

<#assign test1 = "2009-01-22"?date("yyyy-MM-dd") />;  <#assign test2 ="16:34:43"?time("HH:mm:ss") />  <#assign test2 = "2009-01-22 17:23:45"?datetime("yyyy-MM-dd HH:mm:ss") />  ${test1?string.full}  

三、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>  

3.list、break指令

示例:

<#list sequence as item>    ...  </#list>  

4.assign指令

它用于为该模板页面创建一个变量相当于java中声明一个变量

示例:

<#assign readonly =(HISTORY=="0") && (ACTIVITY=='start' || ACTIVITY == 'usertask1')>