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=”[e-mail]”>

       <#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}    显示：&lt;&gt;&quot;&amp;

（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特殊字符转义：

       <转换为&lt;

       >      &gt;

       &      &amp;

       “       &quot;

       ‘       &apos;

(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”/>