1、 scalars：存储单值

字符串：简单文本由单或双引号括起来。
数字：直接使用数值。
日期：通常从数据模型获得
布尔值：true或false，通常在<#if …>标记中使用

 

2、 hashes：充当其它对象的容器，每个都关联一个唯一的查询名字

具有一个唯一的查询名字和他包含的每个变量相关联。

 

3、 sequences：充当其它对象的容器，按次序访问

使用数字和他包含的每个变量相关联。索引值从0开始。

 

4、 集合变量：

除了无法访问它的大小和不能使用索引来获得它的子变量：集合可以看作只能由<#list...>指令使用的受限sequences。

 

5、 方法：通过传递的参数进行计算，以新对象返回结果

方法变量通常是基于给出的参数计算值在数据模型中定义。

 

6、 用户自定义FTL指令：宏和变换器

 

7、 节点

节点变量表示为树型结构中的一个节点，通常在XML处理中使用。

 

 

这里是注释

-->

旧版本的freemarker采用的是<#comment> 注释 </#comment>方法

 

sequence?first

返回sequence的第一个值;前提条件sequence不能是null

sequence?last

       返回sequence最后一个值

sequence?reverse

       反转sequence的值

sequence?size

       返回sequence的大小

sequence?sort

       对sequence按里面的对象toString()的结果进行排序

sequence?sort_by(value)

对sequence 按里面的对象的属性value进行排序

如: sequence里面放入的是10 个user对象，user对象里面包含name,age等属性

sequence?sort_by(name) 表示所有的user按user.name进行排序

hash?keys

       返回hash里的所有keys, 返回结果类型sequence

hash?values

       返回hash里的所有value, 返回结果类型sequence

 

 

使用FTL（freeMarker模板语言）编写

组成部分

一、整体结构

1、注释：<#--注释内容-->，不会输出。

2、文本：直接输出。

3、interpolation:由 ${var} 或 #{var} 限定，由计算值代替输出。

4、FTL标记



二.表达式

1、直接指定值：

1-1、字符串：
由双引号或单引号括起来的字符串，其中的特殊字符（如‘ " \等）需要转义。


1-2、raw字符串：
有一种特殊的字符串称为raw字符串，被认为是纯文本，其中的\和{等不具有特殊含义，该类字符串在引号前面加r，下面是一个例子：
${r"/${data}"year""}屏幕输出结果为：/${data}"year"


转义    含义
序列   
 
\"  双引号(u0022)
 
\‘  单引号(u0027)
 
\\  反斜杠(u005C)
 
\n  换行(u000A)
 
\r  Return (u000D)
 
\t  Tab (u0009)
 
\b  Backspace (u0008)
 
\f  Form feed (u000C)
 
\l  <
 
\g  >
 
\a  &
 
\{  {
 
\xCode  4位16进制Unicode代码
 
1-3、数字：直接输入，不需要引号

1)、精度数字使用“.”分隔，不能使用分组符号
2)、目前版本不支持科学计数法，所以“1E3”是错误的
3)、不能省略小数点前面的0，所以“.5”是错误的
4)、数字8、+8、08和8.00都是相同的

1-4、布尔值：true和false，不使用引号

1-5、序列：由逗号分隔的子变量列表，由[]方括号限定。
1)、子变量列表可以是表达式
2)、可以使用数字范围定义数字序列，不需要方括号限定，例如2..5等同于[2, 3, 4, 5]，但是更有效率，可以定义反递增范围如：5..2。

1-6、散列(hash)
1)、由逗号分隔的键/值列表，由{}大括号限定，键和值之间用冒号分隔，如：{"key1":valu1,"key2":"character string"....}
2)、键和值都是表达式，但是键必须是字符串。

2、获取变量：

2-1、顶层变量：${变量名}

变量名只能是字母、数字、下划线、$、#、@ 的组合，且不能以数字开头。

2-2、散列：有两种方法

1)、点语法：变量名字和顶层变量的名字受同样的限制
2)、方括号语法：变量名字无限制，可以是任意的表达式的结果
book.author.name
book.author.["name"]
book["author"].name
book["author"]["name"]
以上是等价的。

2-3、序列：使用散列的方括号语法获取变量，方括号中的表达式结果必须为数字。注意：第一个项目的索引为0。可以使用
[startindex..endindex]语法获取序列片段。

2-4、特殊变量：FreeMarker内定义变量，使用.variablename语法访问。

3、字符串操作

3-1、interpolation:使用${}或#{}在文本部分插入表达式的值，例如：

${"hello${username}!"}
${"${username}${username}${username}"}

也可以使用+来获得同样的结果：
${"hello"+username+"!"}
${username+username+username}

注意：${}只能用于文本部分而不能出现于标记内。

<#if ${user.login}>或<#if "${user.login}">都是错误的;
<#if user.login>是正确的。
本例中user.login的值必须是布尔类型。

3-2、子串：
举例说明：假如user的值为"Big Joe"
${user[0]}${user[4]}结果是：BJ
${user[1..4]}结果是：ig J

4、序列操作

4-1、连接操作：可以使用+来操作，例如：
["title","author"]+["month","day"]

5、散列操作
5-1、连接操作：可以使用+来操作，如果有相同的KEY，则右边的值会替代左边的值，例如：
{"title":散列,"author":"emma"}+{"month":5,"day":5}+{"month":6}结果month的值就是6。

6、算术运算

6-1、操作符：+、-、*、/、%
除+号以外的其他操作符两边的数据，必须都是数字类型。
如果+号操作符一边有一个字符型数据，会自动将另一边的数据转换为字符型数据，运算结果为字符型数据。

6-2、比较操作符：
1}、=
2}、==
3}、!=
4}、<
5}、<=
6}、>
7}、>=
1-3的操作符，两边的数据类型必须相同，否则会产生错误
4-7的操作符，对于日期和数字可以使用，字符串不可以使用。

注意：
1}、FreeMarker是精确比较，所以"x" "x " "X"是不等的。
2}、因为<和>对FTL来说是开始和结束标记，所以，可以用两种方法来避免这种情况：
一种是使用括号<#if (a<b)>
另一是使用替代输出，对应如下：
<  lt
<= lte
>  gt
>= gte

6-3、逻辑操作符：只能用于布尔值，否则会出现错误。

&&(and)与运算
||(or)或运算
!(not)非运算

6-4、内建函数：使用方法类似于访问散列的子变量，只是使用?代替.例如：${test?upper_case?html}

常用的内建函数列举如下：

1}、字符串使用：

html:对字符串进行HTML编码
cap_first:字符串第一个字母大写
lower_first:字符串第一个字母小写
upper_case:将字符串转换成大写
trim:去掉字符前后的空白字符

2)、序列使用：
size:获得序列中元素的数目

3)、数字使用：
int:取得数字的整数部分

7、操作符的优先顺序：

后缀：[subbarName][subStringRange].(mathodParams)
一元：+expr、-expr、! (not)
内建：?
乘法：*、/、%
加法：+、-
关系：<、<=、>、>= (lt、lte、gt、gte)
相等：=、==、!=
逻辑与：&& (and)
逻辑或：|| (or)
数字范围：..

四、interpolation

inperpolation只能用于文本，有两种类型：通用interpolation及数字interpolation

1、通用interpolation

如${expr}

1-1、插入字符串值：直接输出表达式结果。
1-2、插入数字值：根据缺省格式(由setting指令设置)将表达式结果转换成文本输出;可以使用内建函数string来格式化单个interpolation

如：
<#setting number_format="currency" />
<#assign answer=42 />
${answer}  <#-- ￥42.00 -->
${answer?string}  <#-- ￥42.00 -->
${answer?string.number}  <#-- 42 -->
${answer?string.currency}  <#-- ￥42.00 -->
${answer?string.percent}  <#-- 42,00％ -->

1-3、插入日期值：根据缺省格式(由setting指令设置)将表达式结果转换成文本输出;可以使用内建函数string来格式化单个interpolation

如：

${lastupdata?string("yyyy-MM-dd HH:mm:ss zzzz")}  <#-- 2003-04-08 21:24:44 Pacific Daylight Time -->
${lastupdata?string("EEE,MMM d, ‘‘yy")}  <#-- tue,Apr 8, ‘03 -->
${lastupdata?string("EEEE,MMMM dd, yyyy,hh:mm:ss a ‘(‘zzz‘)‘")}  <#-- Tuesday,April 08, 2003, 09:24:44 PM (PDT)-->

1-4、插入布尔值：根据缺省格式(由setting指令设置)将表达式结果转换成文本输出;可以使用内建函数string来格式化单个interpolation

如：
<#assign foo=ture />
${foo?string("yes","no")} <#-- yes -->

2、数字interpolation:

有两种形式：
1)、#{expr}
2)、#{expr;format}：format可以用来格式化数字，format可以是如下：
mX:小数部分最小X位
MX:小数部分最大X位

例如：
<#assign x=2.582 />
<#assign y=4 />
#{x;M2} <#-- 2.58 -->
#{y;M2} <#-- 4 -->
#{x;m1} <#-- 2.582 -->
#{y;m1} <#-- 4.0 -->
#{x;m1M2} <#-- 2.58 -->
#{y;m1M2} <#-- 4.0 -->

 

宏

宏和变换器变量是两种不同类型的用户自定义指令，他们的区别是：

宏可以在模板中用macro指令来定义
变换器是在模板外由程序定义

1、宏：和某个变量关联的模板片段，以便在模板中通过用户自定义指令使用该变量
1-1、基本用法：
例如：
<#macro greet>
<font size="+2"> Hello JOE!
</#macro>


使用时：
<@greet></@greet>
如果没有体内容也可以用
<@greet />

1-2、变量：

1)、可以在宏定义之后定义参数，宏参数是局部变量，只在宏定义中有效。如：

<#macro greet person>
<font size="+2"> Hello ${person}!
</#macro>
使用时：
<@greet person="emma"> and <@greet person="LEO">
输出为：
<font size="+2"> Hello emma!
<font size="+2"> Hello LEO!

注意：宏的参数是FTL表达式，所以，person=emma和上面的例子中具有不同的意义，这意味着将变量emma的值传给person,这个值可能是任意一种数据类型，甚至是一个复杂的表达式。


宏可以有多个参数，使用时参数的次序是无关的，但是只能使用宏中定义的参数，并且对所有参数赋值。如：
<#macro greet person color>
<font size="+2" color="${color}"> Hello ${person}!
</#macro>

使用时：
<@greet color="black" person="emma" />正确
<@greet person="emma" />错误，color没有赋值，此时，如果在定义宏时为color定义缺省值<#macro greet person color="black">这样的话，这个使用方法就是正确的。
<@greet color="black" person="emma" bgcolor="yellow" />错误，宏greet定义中未指定bgcolor这个参数



2、嵌套内容：

2-1、自定义指令可以有嵌套内容，使用<#nested>指令，执行自定义指令开始和结束标记之间的模板片段。例如：
<#macro greet>

<#nested>
 

</#macro>


<@greet>hello Emma!</@greet>

输出为

hello Emma!

2-2、<#nested>指令可以被多次调用，例如
<#macro greet>

<#nested>
<#nested>
<#nested>
<#nested>
 

</#macro>

<@greet>hello Emma!</@greet>

输出为

hello Emma!
hello Emma!
hello Emma!
hello Emma!
 

2-3、嵌套的内容可以是有效的FTL，例如：
<#macro welcome>

<#nested>
 

</#macro>

<#macro greet person color="black">
<font size="+2" color="${color}"> Hello ${person}!
</#macro>

<@welcome>
<@greet person="Emma" color="red" />
<@greet person="Andrew" />
<@greet person="Peter" />
</@welcome>

输出为：

<font size="+2" color="red"> Hello Emma!
<font size="+2" color="black"> Hello Andrew!
<font size="+2" color="black"> Hello Peter!
 

2-4、宏定义中的局部变量对嵌套内容是不可见的，例如：

<#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:???

2-5、在宏定义中使用循环变量，通常用来重复嵌套内容，基本用法为：作为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>

输出结果是

1. 0.5
2. 1
3. 1.5
4. 2last!

注意：指定循环变量的数目和用户定义指令开始标记指定的不同不会有问题
调用时，少指定循环变量，多指定的值会不见
调用时，多指定循环变量，多余的循环变量不会被创建

二、在模板中定义变量

1、在模板中定义的变量有三种类型

1-1、plain变量：可以在模板的任何地方访问，包括使用include指令插入的模板，使用assign指令创建和替换。
1-2、局部变量：在宏定义体中有效，使用local指令创建和替换。
1-3、循环变量：只能存在于指令的嵌套内容，由指令(如list)自动创建。

注意：
1)、宏的参数是局部变量，不是循环变量。
2)、局部变量隐藏同名的plain变量
3)、循环变量隐藏同名的plain变量和局部变量。

例如：

<#assign x="plain">
1. ${x} <#-- plain -->

<@test />

6. ${x}
<#list ["loop"] as x>
7. ${x} <#-- loop -->
<#assign x="plain2">
8. ${x} <#-- loop -->
</#list>
9. ${x} <#-- plain2 -->

<#macro test>
2. ${x} <#-- plain -->
<#local x="local">
3. ${x} <#-- local -->
<#list ["loop"] as x>
4. ${x} <#-- loop -->
</#list>
5. ${x} <#-- local -->
</#macro>

4)、内部循环变量隐藏同名的外部循环变量

<#list ["loop1"] as x>
${x} <#-- loop1 -->
<#list ["loop2"] as x>
${x} <#-- loop2 -->
<#list ["loop3"] as x>
${x} <#-- loop3 -->
</#list>
${x} <#-- loop2 -->
</#list>
${x} <#-- loop1 -->
</#list>

5)、模板中的变量会隐藏数据模型中的同名变量，如果需访问数据模型中的变量，使用特殊变量global。

例如：
假设数据模型中的user值为Emma
<#assign user="Man">
${user} <#-- Man -->
${.global.user} <#-- Emma -->

 

 

 

输出

 

定义循环输出的宏

 

 

包含body的宏

 

输出

 

 

 

 

 

freemarker指令有两种：
1、预定义指令：引用方式为<#指令名称>
2、用户定义指令：引用方式为<@指令名称>，引用用户定义指令时须将#换为@。
注意：如果使用不存在的指令，FreeMarker不会使用模板输出，而是产生一个错误消息。

freemarker指令由FTL标记来引用，FTL标记和HTML标记类似，名字前加#来加以区分。如HTML标记的形式为<h1></h1>则FTL标记的形式是<#list></#list>（此处h1标记和list指令没有任何功能上的对应关系，只是做为说明使用一下）。

有三种FTL标记：
1)、开始标记：<#指令名称>
2)、结束标记：</#指令名称>
3)、空标记：<#指令名称/>

注意：

1) FTL会忽略标记之中的空格，但是，<#和指令 与 </#和指令 之间不能有空格。
2) FTL标记不能够交叉，必须合理嵌套。每个开始标记对应一个结束标记，层层嵌套。 如：
<#list>
<li>
${数据}
<#if 变量>

game over!

</#if>

</#list>

注意事项：
1)、FTL对大小写敏感。所以使用的标记及interpolation要注意大小写。name与NAME就是不同的对象。<#list>是正确的标记，而<#List>则不是。
2)、interpolation只能在文本部分使用，不能位于FTL标记内。如<#if ${var}>是错误的，正确的方法是：<#if var>,而且此处var必须为布尔值。
3)、FTL标记不能位于另一个FTL标记内部，注释例外。注释可以位于标记及interpolation内部。


 

 

 

 

 

 

 

 

 

字符串

 

数字

 

 

 

 

 

输出结果

 

 

 

假设mylib.ftl里定义了宏copyright那么我们在其他模板页面里可以这样使用

 

 

"my"在freemarker里被称作namespace

 

 

 

 

全局赋值语法，利用这个语法给变量赋值，那么这个变量在所有的namespace中是可见的,如果这个变量被当前的assign语法覆盖 如<#global x=2> <#assign x=1> 在当前页面里x=2将被隐藏，或者通过${.global.x}来访问[A2]

 

 

date_format, time_format, datetime_format

假如当前是匈牙利的设置，然后修改成美国

 

 

 

 

 

 

 

${expression}计算expression并输出

#{ expression }数字计算#{ expression ;format}安格式输出数字format为M和m

M表示小数点后最多的位数,m表示小数点后最少的位数如#{121.2322;m2M2}输出121.23

 

 

 

 

1..5 表示从1到5，原型number..number

${123.23?int} 输出123

${var?default(“hello world<br>”)?html}如果var is null那么将会被hello world<br>替代

 

 

返回安全的html输出,替换掉html代码

var?xml  

 

 

 

·        f: 只替换第一个出现被替换字符串的字符串

·        r:  XY是正则表达式

·        m: Multi-line mode for regular expressions. In multi-line mode the expressions^ and $ match just after or just before, respectively, a line terminator or the end of the string. By default these expressions only match at the beginning and the end of the entire string.

·        s: Enables dotall mode for regular expressions (same as Perl singe-line mode). In dotall mode, the expression. matches any character, including a line terminator. By default this expression does not match line terminators.

·        c: Permits whitespace and comments in regular expressions.

 

Freemarker的ftl文件中直接使用内部对象:

${Request ["a"]}

${RequestParameters["a"]}

${Session ["a"]}

${Application ["a"]}

${JspTaglibs ["a"]}

 

${name}将会以下面的顺序查找name值

注意，如果标签的属性值是数字，那么必须采用nubmer=123方式给属性赋值

 

 

 

1． 初始化全局共享数据模型

freemark在web上使用的时候对共享数据的初始化支持的不够,不能在配置初始化的时候实现，而必须通过ftl文件来初始化全局变量。这是不能满主需求的，我们需要在servlet init的时候留出一个接口来初始化系统的共享数据

具体到和webwork整合,因为本身webwork提供了整合servlet,如果要增加全局共享变量，可以通过修改com.opensymphony.webwork.views.freemarker.FreemarkerServlet来实现,我们可以在这个servlet初始化的时候来初始化全局共享变量

配置web.xml

<servlet>

<param-value>/</param-value>

<!—模板载入文件夹，这里相对context root，递归获取该文件夹下的所有模板-->

      <param-name>NoCache</param-name> <!—是否对模板缓存-->

<param-name>template_update_delay</param-name>

<!—模板更新时间,0表示每次都更新,这个适合开发时候-->

      <param-value>0.##########</param-value><!—数字显示格式-->

 </servlet>

 <servlet-mapping>

 </servlet-mapping>

 

 

在模板中除了可以通过对象来调用方法外（${object.methed(args)}）也可以直接调用java实现的方法，java类必须实现接口TemplateMethodModel的方法exec(List args). 下面以把毫秒的时间转换成按格式输出的时间为例子

 

输出

 

实现自定义的<@transform>文本或表达式</@transform>的功能,允许对中间的最终文本进行解析转换

 

例子：实现<@upcase>str</@upcase> 将str转换成STR 的功能

 

代码如下：

 

root.put("upcase", new UpperCaseTransform());

 

在view(ftl)页面中可以如下方式使用

 

<@upcase>

hello world

</@upcase>

 

HELLO WORLD

 

 

${repeat("A", B)} – 复制B次A

 

 

 

1. String内置的JavaScript转换： js_string
用途：用于JavaScript转义，转换‘,",换行等特殊字符
模板:

2.内置的默认值处理：default
用途: 用于处理默认值
模本:

输出:

User: Anonymous
<td>&nbsp;</td>

注，可以对整个对象树加上()，再用内置处理器这种方便的做法，偶也是最近刚学会的，以前一直用很傻的方法做.....

3. Sequence内置的计数器: xxx_index
用途：显示序号
模板:

<#list employees as e>
${e_index}. ${e.name}
</#list>

输出:

1. Readonly
2. Robbin

4. Sequence内置的分段器: chunk
用途：某些比较BT的排版需求
模板:

String
${"It‘s \"quoted\" and
this is a backslash: \\"}


${‘It\‘s "quoted" and
this is a backslash: \\‘}


${r"${foo}"}
raw字符串，原封不动地现实引号中的内容


ps:前一种是用双引号来引用字符串，后一种是用单引号来引用字符串。
分别需要对双引号和单引号进行转义


${"${user}${user}${user}${user}"}
${user + user + user + user}
效果相同


★substring
${user[0]}${user[4]}
${user[1..4]}
${user[4..]}


★number
不支持科学计数法
小数点前面的零不能省略


★sequences
<#list ["winter", "spring", "summer", "autumn"] as x>
${x}
</#list>


<#list 2..5 as x> ${x} </#list>
<#list [2,3,4,5] as x> ${x} </#list>


数组的拼接
<#list ["Joe", "Fred"] + ["Julia", "Kate"] as user>
- ${user}
</#list>


★hash
<#assign ages = {"Joe":23, "Fred":25} + {"Joe":30, "Julia":18}>
- Joe is ${ages.Joe}
- Fred is ${ages.Fred}
- Julia is ${ages.Julia}
注意重复的键对应的值取最后的一个


★运算
${5/2?int} 显示2

cap_first : 首字母大写

 

capitalize: 所有单词首刺目大写

 

html : 转换为HTML格式

index_of : 显示元素所在的位置

 

Contains:判断是否存在字符

 

Replace :替换

 

split(“XX”):截取XX之后的字符

 

 

 

 

 

trim :去掉空格

 

seq_index_of 数组中元素的位置

 

 

Exists:放在if句 如果没有…..

 

 

 

if_exists 放在一般语句