【freemarker总结】——最常用的指令

1、空值的判断（！的使用）

对于null，或者miss value，freemarker会报错

我们可以使用 感叹号 来进行空值的判断

例如${user.group!"空值"}

如果user里没有group这个属性的值，那么它就会输出"空值"

再例如 ${user.group.name!"空值"},这样使用就是不可以的，这样写依然会报错，因为freemarker仅仅只会判断group.name是不是空值

所以我们应该这样写${(user.group.name)!"空值"},使用括号括起来之后就会去判断里面每一个是否是空值(连续判断)

$(demo!) 或者 ${demo!"默认值"} ：如果demo是空，那么就使用空字符串或者默认值来代替

2、if指令

<#if condifition>

<#elseif condifition>

<#else>

</#if>

Boolean类型的空值判断

空值判断可以写成<#if book.name?? > //注意${}为变量的渲染显示,而<>为定义等操作符的定义，在if里面不能使用$符号

——

<#if demoList??>两个问号判断是否是空值，返回bool

<#if ${user.login？？}>或<#if "${user.login？？}">都是错误的;

<#if user.login？？>是正确的。

3、数字格式化

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

mX:小数部分最小X位

MX:小数部分最大X位

eg：#{hotgood.spCost ;m2M2} 最大两位，最小两位---显示两位

注： #{${hotgood.spCost} ;m2M2} 不要这样写

4、list--break

<#list sequence as item>

</#list>

item_index :list序列号，从0开始

item_has_next :是否存在下一个对象.

例子:

<#list ${demoList} as item>

${item_index + 1}.${x}

<#if
item_has_next>,</#if>——当前变量的索引值.
<#if item_index == 0> 在if中不能使用$/#符号，直接使用就行

<#if
item="星期四"><#break></#if>

</#list>

输出结果:

1.星期一,

2.星期二,

3.星期三,

4.星期四,

5、常用

FreeMarker的插值有如下两种类型:1,通用插值${expr};2,数字格式化插值:#{expr}或#{expr;format}

${book.name?if_exists } //用于判断如果存在,就输出这个值

${book.name?default(‘xxx’)}//默认值xxx

${book.name!"xxx"}//默认值xxx

${book.date?string('yyyy-MM-dd')} //日期格式

${book?string.number} 20 //三种不同的数字格式

${book?string.currency}--<#-- $20.00 -->

${book?string.percent}—<#-- 20% -->

<#assign foo=ture /> //声明变量,插入布尔值进行显示

${foo?string("yes","no")} <#-- yes -->

大小比较符号使用需要注意:(xml的原因),可以用于比较数字和日期

使用lt、lte、gt和gte来替代<、<=、>和>= 也可以使用括号<#if (x>y)>

6、定义变量

<#-- 定义变量 -->

<#assign myname="Jadyer"/>

${myname}

<#-- 定义数字 -->

<#assign mynum=10/>

${mynum + 20}

<#-- 定义字符串 -->

<#assign mystr="55"/>

${mystr + 20}

<#-- 下面的变量会覆盖上面定义的同名变量，而不会顾及数据类型是否一致 -->

<#assign mystr=55/>

${mystr + 20}

<#-- 下面的两种写法是等价的，它们连接字符串的方式分别为：字符串连接方式和插值连接方式 -->

${"hello,welcome:" + username}

${"hello,welcome:${username}"}

7、布尔值和日期的输出

<#-- 定义布尔型 --> 直接使用true和false,不使用引号.：下面是输出，这说的是判断

<#-- 如果直接输出${myflag}则会报错，因为FreeMarker不能直接输出数字或字符串以外的东西，否则都会报错 -->

<#-- 此时需要将其转换为字符串才能输出：使用xxx?string可以完成对字符串的转换。另外??用于判断变量是否存在 -->

<#assign myflag=true/>

${myflag?string}

${myflag?string("isTrue","isFalse")}

${(user.name)???string("user.nameIsTrue","user.nameIsFalse")}

<#-- 日期类型的处理。如果直接输出${currTime}则会报错，此时仍需将其转换为字符串 -->

${currTime?string("yyyy-MM-dd HH:mm:ss")}

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

${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')'")}

输出结果是:

2008-04-08 08:08:08 Pacific Daylight Time

Tue, Apr 8, '03

Tuesday, April 08, 2003, 08:08:08 PM (PDT)

<#if demoList??>

<#list demoList as demo>

<#if demo_index == 0>

<dl class="sort unfold" id="${demo_index!}">

<#else>

<dl class="sort" id="${demo_index!}">

</#if>

<dt><i></i>${demo.head!}</dt>

<#list demo.contents as content>

<dd><a href="#">${content!}</a></dd>

</#list>

</dl>

</#list>

</#if>