freemaker注释:格式部分,不会输出。

1、字符输出

${emp.name?if_exists}　　　　　　// 变量存在，输出该变量，否则不输出

${emp.name!}　　　　　　　　　　 // 变量存在，输出该变量，否则不输出

${emp.name?default("xxx")} // 变量不存在，取默认值xxx

${emp.name!"xxx"} 　　　　　　// 变量不存在，取默认值xxx

常用内部函数：

${"123
456"?html} 　　// 对字符串进行HTML编码，对html中特殊字符进行转义

${"str"?cap_first} 　　 // 使字符串第一个字母大写

${"Str"?lower_case} // 将字符串转换成小写

${"Str"?upper_case} // 将字符串转换成大写

${"str"?trim} // 去掉字符串前后的空白字符

字符串的两种拼接方式拼接：

${"hello${emp.name!}"} // 输出hello+变量名

${"hello"+emp.name!} // 使用+号来连接，输出hello+变量名

可以通过如下语法来截取子串:

// 方法1

${str?substring(0,4)} // 输出abcd

// 方法2

${str[0]}${str[4]} // 结果是ae

${str[1..4]} 　　　 // 结果是bcde

// 返回指定字符的索引

${str?index_of("n")}

2、日期输出

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

3、数字输出(以数字20为例)

${emp.name?string.number} 　// 输出20

${emp.name?string.currency} // ￥20.00

${emp.name?string.percent} // 20%

${1.222?int} 　　　　　　　　　　 // 将小数转为int，输出1

// 设置数字默认输出方式(‘percent‘,百分比)

　　　　　　　　 // 声明变量 answer 42

#{answer} 　　　　　　　　 // 输出 4,200%

${answer?string} 　　　　 // 输出 4,200%

${answer?string.number} 　　// 输出 42

${answer?string.currency} // 输出 ￥42.00

${answer?string.percent} 　// 输出 4,200%

#{answer} 　　　　　　　　// 输出 42

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

mX:小数部分最小X位

MX:小数部分最大X位

如下面的例子:

#{x; M2} // 输出2.58

#{y; M2} // 输出4

#{x; m2} // 输出2.58

#{y; m2} // 输出4.0

#{x; m1M2} // 输出2.58

#{x; m1M2} // 输出4.0

4、申明变量

// 声明变量,插入布尔值进行显示,注意不要用引号

${foo?string("yes","no")} // 当为true时输出"yes",否则输出"no"

申明变量的几种方式

capture this

#assign>

capture this

#assign>

5、比较运算符

表达式中支持的比较运算符有如下几个:

= 或 == ：判断两个值是否相等.

!= ：判断两个值是否不等.

> 或 gt ：判断左边值是否大于右边值

>= 或 gte ：判断左边值是否大于等于右边值

< 或 lt ：判断左边值是否小于右边值

<= 或 lte ：判断左边值是否小于等于右边值

6、算术运算符

FreeMarker表达式中完全支持算术运算,

FreeMarker支持的算术运算符包括:+, - , * , / , %

注意：

(1)、运算符两边必须是数字

(2)、使用+运算符时,如果一边是数字,一边是字符串,就会自动将数字转换为字符串再连接,如:${3 + "5"},结果是:35

7、逻辑运算符

逻辑运算符有如下几个:

逻辑与:&&

逻辑或:||

逻辑非:!

逻辑运算符只能作用于布尔值,否则将产生错误

8、FreeMarker中的运算符优先级如下(由高到低排列):

①、一元运算符:!

②、内建函数:?

③、乘除法:*, / , %

④、加减法:- , +

⑤、比较:> , < , >= , <= (lt , lte , gt , gte)

⑥、相等:== , = , !=

⑦、逻辑与:&&

⑧、逻辑或:||

⑨、数字范围:..

实际上,我们在开发过程中应该使用括号来严格区分,这样的可读性好,出错少

9、if 逻辑判断(注意：elseif 不加空格)

...

...

...

...

#if>

if 空值判断

...#if>

Wow!#if>

Wow!#if>

Wow!#if>

10、switch (条件可为数字，可为字符串)

....

....

....

....

#switch>

11、集合 & 循环

${emp.name!}

#list>

${empList[i].name!}

#list>

empList?size 　　　// 取集合的长度

emp_index: 　　　　// int类型，当前对象的索引值

emp_has_next: // boolean类型，是否存在下一个对象

#if>

#if>

${i}

#list>

empList[3..5]

[2 + 2, [1, 2, 3, 4], "whatnot"]

${x?seq_contains("blue")?string("yes", "no")} // yes

${x?seq_contains("yellow")?string("yes", "no")} // no

${x?seq_contains(16)?string("yes", "no")} // yes

${x?seq_contains("16")?string("yes", "no")} // no

${x?seq_index_of("blue")}

#list>

#list>

${moive.name}

#list>

${movie.name}

#list>

${movie.name}

#list>

${movie.name}

#list>

12、Map对象

emp.name // 全部使用点语法

emp["name"] // 使用方括号

13、FreeMarker支持如下转义字符:

\" ：双引号(u0022)

\‘ ：单引号(u0027)

\\ ：反斜杠(u005C)

\n ：换行(u000A)

\r ：回车(u000D)

\t ：Tab(u0009)

\b ：退格键(u0008)

\f ：Form feed(u000C)

\l ：<

\g ：>

\a ：&

\{ ：{

\xCode ：直接通过4位的16进制数来指定Unicode码,输出该unicode码对应的字符.

如果某段文本中包含大量的特殊符号,FreeMarker提供了另一种特殊格式:可以在指定字符串内容的引号前增加r标记,在r标记后的文件将会直接输出.看如下代码:

${r"${foo}"} // 输出 ${foo}

${r"C:/foo/bar"} // 输出 C:/foo/bar

14、include指令

// include指令的作用类似于JSP的包含指令:

// 在上面的语法格式中,两个参数的解释如下:

encoding="GBK" // 编码格式

parse=true 　　 // 是否作为ftl语法解析,默认是true，false就是以文本方式引入,注意:在ftl文件里布尔值都是直接赋值的如parse=true,而不是parse="true"

15、import指令

// 类似于jsp里的import,它导入文件，然后就可以在当前文件里使用被导入文件里的宏组件

// 上面的代码将导入/lib/common.ftl模板文件中的所有变量,交将这些变量放置在一个名为com的Map对象中，"my"在freemarker里被称作namespace

16、compress 压缩

// 用来压缩空白空间和空白的行

...

#compress>

17、特殊标签

// 去掉左右空白和回车换行

// 去掉左边空白和回车换行

// 去掉右边空白和回车换行

// 取消上面的效果

18、escape,noescape 对字符串进行HTML编码

// escape指令导致body区的插值都会被自动加上escape表达式,但不会影响字符串内的插值,只会影响到body内出现的插值,使用escape指令的语法格式如下:

First name: ${firstName}

Last name: ${lastName}#noescape>

Maiden name: ${maidenName}

#escape>

// 相同表达式

First name: ${firstName?html}

Last name: ${lastName}

Maiden name: ${maidenName?html}