freemarker基本使用语法

?

1.插入（输出）${book.name}
空值判断：${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 -->2．逻辑判断a:<#if condition>...<#elseif condition2>...<#elseif condition3>......<#else>...其中空值判断可以写成<#if book.name?? ></#if>b:<#switch value><#case refValue1>??? ...??? <#break><#case refValue2>??? ...??? <#break>...<#case refValueN>??? ...??? <#break><#default>??? ...</#switch>3．循环读取<#list sequence as item>...</#list>空值判断<#if bookList?size = 0></#list>e.g.<#list employees as e>${e_index}. ${e.name}</#list>输出:1. Readonly2. Robbin4.FreeMarker
3 宏/模板
宏Macro
宏是在模板中使用macro指令定义l.1 基本用法宏是和某个变量关联的模板片断，以便在模板中通过用户定义指令使用该变量，下面是一个例子：
<#macro greet><font size="+2">Hello Joe!</font></#macro>
调用宏时，与使用FreeMarker的其他指令类似，只是使用@替代FTL标记中的#。
<@greet></@greet>
<#--<@greet/>-->
在macro指令中可以在宏变量之后定义参数，如：
<#macro greet person><font size="+2">Hello ${person}!</font></#macro>可以这样使用这个宏变量：?? <@greet person="Fred"/>但是下面的代码具有不同的意思：?? <@greet person=Fred/>这意味着将Fred变量的值传给person参数，该值不仅是字符串，还可以是其它类型，甚至是复杂的表达式。
宏可以有多参数，下面是一个例子：<#macro greet person color><font size="+2" color="${color}">Hello ${person}!</font></#macro>
可以这样使用该宏变量，其中参数的次序是无关的：<@greet person="Fred" color="black"/>
可以在定义参数时指定缺省值，否则，在调用宏的时候，必须对所有参数赋值：<#macro greet person color="black"><font size="+2" color="${color}">Hello ${person}!</font></#macro>
注意：宏的参数是局部变量，只能在宏定义中有效。
?
在宏里嵌套内容FreeMarker的宏可以有嵌套内容，<#nested>指令会执行宏调用指令开始和结束标记之间的模板片断，举一个简单的例子：
<#macro border><table border=4 cellspacing=0 cellpadding=4><tr><td>??? <#nested></tr></td></table></#macro>
执行宏调用：<@border>The bordered text</@border>输出结果：<table border=4 cellspacing=0 cellpadding=4><tr><td>??? ?? The bordered text</tr></td></table>
<#nested>指令可以被多次调用，每次都会执行相同的内容。<#macro do_thrice><#nested><#nested><#nested></#macro>
<@do_thrice>Anything.</@do_thrice>
FMPP 输出结果：Anything.Anything.Anything.
嵌套内容可以是有效的FTL，下面是一个有些复杂的例子，我们将上面三个宏组合起来：<@border><ul><@do_thrice>??? <li><@greet person="Joe"/></@do_thrice></ul></@border>输出结果：<table border=4 cellspacing=0 cellpadding=4><tr><td><ul>??? <li><font size="+2">Hello Joe!</font>??? <li><font size="+2">Hello Joe!</font>??? <li><font size="+2">Hello Joe!</font></ul></tr></td></table>
宏定义中的局部变量对嵌套内容是不可见的，例如：<#macro repeat count><#local y = "test"><#list 1..count as x>??? ${y} ${count}/${x}: <#nested></#list></#macro>
<@repeat count=3>${y?default("?")} ${x?default("?")} ${count?default("?")}</@repeat>
输出结果：test 3/1: ? ? ?test 3/2: ? ? ?test 3/3: ? ? ?
在宏定义中使用循环变量nestted指令也可以有循环变量（循环变量的含义见下节），调用宏的时候在宏指令的参数后面依次列出循环变量的名字，格式如下：
<@ macro_name paramter list; loop variable list[,]>
例如：<#macro repeat count><#list 1..count as x>??? <#nested x, x/2, x==count></#list></#macro>
<@repeat count=4 ; c, halfc, last>${c}. ${halfc}<#if last> Last!</#if></@repeat>
这里count是宏的参数，c, halfc,last则为循环变量，输出结果：1. 0.52. 13. 1.54. 2 Last!循环变量和宏标记指定的不同不会有问题，如果调用时少指定了循环变量，那么多余的值不可见。调用时多指定了循环变量，多余的循环变量
不会被创建：<@repeat count=4 ; c, halfc, last>${c}. ${halfc}<#if last> Last!</#if></@repeat>
<@repeat count=4 ; c, halfc>${c}. ${halfc}</@repeat>
<@repeat count=4>Just repeat it...</@repeat>
在模板中定义变量在模板中定义的变量有三种类型：plain变量：可以在模板的任何地方访问，包括使用include指令插入的模板，使用assign指令创建和替换。局部变量：在宏定义体中有效，使用local指令创建和替换。循环变量：只能存在于指令的嵌套内容，由指令（如list）自动创建；宏的参数是局部变量，而不是循环变量局部变量隐藏（而不是覆盖）同名的plain变量；循环变量隐藏同名的局部变量和plain变量，下面是一个例子：
<#assign x = "plain">${x} <#-- we see the plain var. here -->
<@test/>6. ${x} <#-- the value of plain var. was not changed --><#list ["loop"] as x>7. ${x} <#-- now the loop var. hides the plain var. -->??? <#assign x = "plain2"> <#-- replace the plain var, hiding does not mater here -->8. ${x} <#-- it still hides the plain var. --></#list>9. ${x} <#-- the new value of plain var. --><#macro test>2. ${x} <#-- we still see the plain var. here --><#local x = "local">3. ${x} <#-- now the local var. hides it --><#list ["loop"] as x>??? 4. ${x} <#-- now the loop var. hides the local var. --></#list>5. ${x} <#-- now we see the local var. again --></#macro>输出结果：1. plain2. plain3. local4. loop5. local6. plain7. loop8. loop9. plain2内部循环变量隐藏同名的外部循环变量，如：<#list ["loop 1"] as x>${x}<#list ["loop 2"] as x>??? ${x}??? <#list ["loop 3"] as x>????? ${x}??? </#list>??? ${x}</#list>${x}</#list>输出结果：loop 1??? loop 2????? loop 3??? loop 2loop 1模板中的变量会隐藏（而不是覆盖）数据模型中同名变量，如果需要访问数据模型中的同名变量，使用特殊变量global，下面的例子假设数据
模型中的user的值是Big Joe：<#assign user = "Joe Hider">${user}????????? <#-- prints: Joe Hider -->${.globals.user} <#-- prints: Big Joe -->名字空间通常情况，只使用一个名字空间，称为主名字空间，但为了创建可重用的宏、变换器或其它变量的集合（通常称库），必须使用多名字空间，
其目的是防止同名冲突创建库下面是一个创建库的例子（假设保存在lib/my_test.ftl中）：<#macro copyright date><p>Copyright (C) ${date} Julia Smith. All rights reserved.<br>Email: ${mail}</p></#macro> <#assign mail = "frogking@phome.com">使用import指令导入库到模板中，Freemarker会为导入的库创建新的名字空间，并可以通过import指令中指定的散列变量访问库中的变量：<#import "/lib/my_test.ftl" as my><#assign mail="fred@phome.com"><@my.copyright date="1999-2002"/>${my.mail}${mail}输出结果：<p>Copyright (C) 1999-2002 Julia Smith. All rights reserved.<br>Email: frogking@phome.com</p>frogking@phome.comfred@phome.com可以看到例子中使用的两个同名变量并没有冲突，因为它们位于不同的名字空间。还可以使用assign指令在导入的名字空间中创建或替代变量
，下面是一个例子：<#import "/lib/my_test.ftl" as my>${my.mail}<#assign mail="frogking@phome.com" in my>${my.mail}输出结果：frogking@phome.comfrogking@phome.com数据模型中的变量任何地方都可见，也包括不同的名字空间，下面是修改的库：<#macro copyright date><p>Copyright (C) ${date} ${user}. All rights reserved.</p></#macro><#assign mail = "${user}@phome.com">假设数据模型中的user变量的值是Fred，则下面的代码：<#import "/lib/my_test.ftl" as my><@my.copyright date="1999-2002"/>${my.mail}输出结果：<p>Copyright (C) 1999-2002 Fred. All rights reserved.</p>Fred@phome.com