FreeMarker
与jsp在HTML页面中嵌入java脚本代码不同，FreeMarker不支持脚本代码。
1．FreeMarker基本对象类型:
保存单值的变量(size,price,)称为scalar(标量). ${root.size}
另外一种变量类型是：sequence(序列).在java中可以用java.util.List来构建序列。
<#list [“one”,”two”]+[“three”,”four”] as user> 序列的连接用+
${user}
</#list>
方法变量：
方法变量基于给出的参数进行计算，然后返回一个结果。
例：<#function avg x y>
<#return (x+y)/2>
<#function>
调用方法：${avg(3,5)}
宏变量：
宏变量可以被用户定义的指令。
Macro指令：
Macro指令在当前名称空间中创建一个宏变量，你可以把宏变量看成是java中没有返回值的方法。
没有参数的宏：
<#macro test>
Test text
</#macro>
调用方法：<@test/>
带有参数的宏：
<#macro test foo bar baaz>
Test text ,and the params: ${foo},${bar},${baaz}
</#macro>
调用宏：<@test foo=”a” bar=”b” baaz=5*5-2/>
Nested指令：
在宏定义体内，nested指令调用了几次,在用户定义指令开始标签和结束标签之间的内容就会被执行几次。
<#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>
Return指令：
使用return 指令，你可以在任何地主跳出宏定义体。例如：
<#macro test>
Test text
<#return>
Will not be printed.
</#macro>
显示为：Test text
2.指令：
（1）if/elseif/else 指令：
<#if a==3>3
<#elseif a==5>5
<#else>8
</#if>
（2）switch/case/default/break指令：
<#switch value>
<#case 1>1 <#break>
<#case 2>2 <#break>
<#default>3
<#switch>
（3）list/break指令：
<#list sequence as item>
…
</#list>
Item_index:表示当前迭代项在整个循环中的索引。
Item_has_next: 布尔值，用于判断是否是最后一项。
（4）include指令：
Include 指令用于在模板中插入其他文件的内容。
<#include “/common/copyright.ftl” encoding=”GBK”>
（5）import指令：
Import指令用于导入一个库。所谓库，就是在一个模板中使用assign和macro指令创建的可重用的变量的集合。
Footer.ftl内容：
<#assign mail=”[email protected]”>
<#macro test>
Test
</#macro>
<#import “/lib/footer.ftl” as my>
${my.mail}
<@my.test/>
（6）assign指令：
Assign指令用于创建一个新的变量，或者替换一个现在的变量。
<#assign val=”123”/>
（7）global指令：
Global指令创建的是全局变量，可以在所有的名称空间中使用。
（8）local指令：
Local指令用于创建或替换局部变量。
<#setting locale=”en_US”>
Locale:指定语言环境.
Number_format:指定将数字转换为字符串时使用的数字格式。可以使用预定义的值：number,currency,percent.
Boolean_format:
Date_format,time_format,datetime_format:指定日期转换格式。
Time_zone:
（9）noparse指令：
Noparse指令用于禁止对ftl的解析。
（10）escape和noescape指令：
自动添加转义的表达式。
<#escape x as x?html>
First name: ${firstname}
Last name: ${lastname}
</#escape>
上迷等价于：
First name: ${firstname?html}
Last name: ${lastname?html}
3．Freemarker内置函数：
操作字符串：
（1）substring
截取字符串：${‘abc’?substring(2)} ${‘abc’?substring(0,2)}
（2）cap_first
将第一个单词的首字母转换为大写形式。 ${“green mouse”?cap_first}
（3）uncap_first
将第一个单词的首字母转换为小写。
（4）length
用于返回字符串中字符的数量。 ${“zhangsan”?length}
（5）capitalize
将所有单词的首字母都转换成大写。
（6）date,time和datetime
<#setting locale=”zh_CN”>
<#assign test1=”1998-10-22”?date(“yyyy-MM-dd”)
（7）ends_with
用于判断一个字符串是否由某个子串结尾，返回布尔值。
${“redhead”?ends_with(“head”)?string}
布尔值不能直接输出，需要转换为字符串输出。
（8）html
用于将字符串中的<、>、&替换为它们对应的实体引用。
${“<>&\””?html} 显示：<>"&
（9）index_of
用于在一个字符串中查找某个子串，并返回找到的子串的第一个字符的索引。如果没有找到，则返回-1.
（10）j_string
使用java语言字符串字面量的转义规则对字符串进行转义。
（11）js_string
使用javascript语言中的字符串字面量的转义规则对字符串进行转义。
（12）last_index_of
查找子串，返回最右边的子串的第一个字符的索引。
（13）lower_case
用于将字符串转换成小写。
（14）upper_case
用于将字符串转换为大写。
（15）left_pad
指定字符串的输出长度，左边补空格。
[${“abc”?left_pad(5)}]
[${“abc”?left_pad(5,”*”)}]
(16)right_pad
(17)contains
用于判断一个字符串中是否包含了某个子串。该函数返回布尔值。
<#if “piceous”?contains(“ice”)> test</#if>
(18)number
用于将字符串转换为数字。
${“123.55”?number}
(19)replace
用于将字符串中的一部分替换为另外的字符串。
${“this is a car.”?replace(“car”,”bus”)}
(20)url
url对字符串使用 URL转义
<#setting url_escaping_charset=”UTF-8”>
<#assign x=’a/b c’>
${x?url}
(21)split
拆分字符串
(22)start_with
用于判断一个字符串是否由某个子串开始，返回布尔值。
(23)string (与字符串一起使用)
用于字符串时只是简单的返回字符串。
(24)trim
用于删除字符串首尾的空格。
(25)word_list
查找一个字符串中的所有单词，按照它们出现的顺序返回一个序列。
(26)xml
将xml特殊字符转义：
<转换为<
> >
& &
“ "
‘ '
(27)c
用于将数字转换为字符串
(28)string (与数字一起使用)
<#assing num=42>
${num}
${num?string.number} ${num?string.currency} ${num?string.percent}
${num?string(“,##0.00”)} 数字格式化
(29)string (与日期一起使用)
${date?string(“yyyy-MM-dd hh:mm:ss”)}
4.操作序列：
(1)first
${[“one”,”two”,”three”]?first} 显示：one
(2)last
(3)seq_contains
(4)seq_index_of
(5)seq_last_index_of
(6)reverse
(7)size
(8)sort
(9)sort_by
(10)chunk
<#assign seq=[‘a’,’b’,’c’,’d’,’e’]>
<#list seq?chunk(3) as row>
<#list row as cell> ${cell}</#list>
<#list>
输出结果为：
a b c
d e
<#list seq?chunk(4,’-’) as row>
<#list row as cell> ${cell}</#list>
</#list>
输出结果：
a b c
d e -
5.操作散列：
(1) Keys
返回散列中的所有的key.
<#assign map={“name”:”mouse”,”price”:50}>
<#assign keys=h?keys>
<#list keys as key> ${key}=${map[key]}</#list>
(2) values
<#assign values=map?values>
<#list values as value> ${value}</#list>
缺少值外理操作符：
如果你指定的变量没有定义，或者为null。如果你访问一个为null的变量，那么freeMarker将抛出错误。
在freeMarker中，变量不存或者为null,都被看作是缺少值。
(1) 默认值操作符：！
${val!”abc”}
(2) 缺少值测试操作符：？？
<#if val??>
Not null
<#if>
6.Jsp标签支持：
在web.xml文件中配置JspSupportServlet
<servlet>
<servlet-name>jspSupport</servlet-name>
<servlet-class>org.apache.struts2.views.JspSupportServlet</servlet-class>
<load-on-startup>1</load-on-startup>
</servlet>
在模板文件中引入：
<#assign c=JSPTaglibs[“/WEB-INF/tld/c.tld”]>
<@c.out value=”Hello”/>