FreeMarker--表达式和运算符的用法(全面/有示例)

原文网址：FreeMarker--表达式和运算符的用法(全面/有示例)_IT利刃出鞘的博客-CSDN博客

简介

本文介绍FreeMarker的表达式和运算符的用法。

表达式是FreeMarker的核心功能。表达式放置在插值语法（${...}）之中时，表明需要输出表达式的值，表达式语法也可以与FreeMarker标签结合，用于控制输出。

直接指定值

a、字符串

${"我的文件保存在C:\\盘"} 
${'我名字是\"annlee\"'}

输出结果是:

我的文件保存在C:\盘 
我名字是"annlee"

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}"} 
${r"C:\foo\bar"}

输出结果是:

${foo} 
C:\foo\bar

b、数值

表达式中的数值直接输出，不需要引号，小数点使用"."分隔，不能使用分组","符号。FreeMarker目前还不支持科学计数法，所以"1E3"是错误 的。FreeMarker表达式中使用数值需要注意以下几点：

• 数值不能省略小数点前面的0，所以".5"是错误的写法
• 数值8 , +8 , 8.00都是相同的

c、布尔值

直接使用true和false，不使用引号。

d、日期型
FreeMarker支持date、time、datetime三种类型，这三种类型的值无法直接指定，通常需要借助字符串的date、time、datetime三个内建函数进行转换才可以

<#assign test1 = "2009-01-22"?date("yyyy-MM-dd") />;
           <#assign test2 ="16:34:43"?time("HH:mm:ss") />
           <#assign test2 = "2009-01-22 17:23:45"?datetime("yyyy-MM-dd HH:mm:ss") />
           ${test1?string.full}

e、集合

集合以方括号包括,各集合元素之间以英文逗号","分隔,看如下的例子:

<#list ["星期一", "星期二", "星期三", "星期四", "星期五", "星期六", "星期天"] as x> 
${x} 
</#list>

输出结果是:

星期一 
星期二 
星期三 
星期四 
星期五 
星期六 
星期天

除此之外,集合元素也可以是表达式,例子如下:

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

        还可以使用数字范围定义数字集合,如2..5等同于[2, 3, 4, 5],但是更有效率.注意,使用数字范围来定义集合时无需使用方括号,数字范围也支持反递增的数字范围,如5..2 

f、Map集合

Map对象使用花括号包括,Map中的key-value对之间以英文冒号":"分隔,多组key-value对之间以英文逗号","分隔.下面是一个例子:

{"语文":78, "数学":80}

Map对象的key和value都是表达式，但是key必须是字符串.

输出变量值

        FreeMarker的表达式输出变量时，这些变量可以是顶层变量，也可以是Map对象中的变量，还可以是集合中的变量，并可以使用点(.)语法来访问Java对象的属性。下面分别讨论这些情况

a、顶层变量 

所谓顶层变量就是直接放在数据模型中的值，例如有如下数据模型:

Map root = new HashMap();   //创建数据模型 
root.put("name","annlee");   //name是一个顶层变量

对于顶层变量，直接使用${variableName}来输出变量值，变量名只能是字母，数字，下划线，$，@和#的组合，且不能以数字开头号.为了输出上面的name的值，可以使用如下语法:

${name}

b、输出集合元素 

        如果需要输出集合元素，则可以根据集合元素的索引来输出集合元素，集合元素的索引以方括号指定.假设有索引: 

["星期一"，"星期二"，"星期三"，"星期四"，"星期五"，"星期六"，"星期天"]

该索引名为week，如果需要输出星期三，则可以使用如下语法:

${week[2]}   //输出第三个集合元素

此外，FreeMarker还支持返回集合的子集合，如果需要返回集合的子集合，则可以使用如下语法:

week[3..5]   //返回week集合的子集合，子集合中的元素是week集合中的第4-6个元素

c、输出Map元素 

        这里的Map对象可以是直接HashMap的实例，甚至包括JavaBean实例，对于JavaBean实例而言，我们一样可以把其当成属性为key，属性值为value的Map实例。为了输出Map元素的值，可以使用点语法或方括号语法。假如有下面的数据模型:

Map root = new HashMap(); 
Book book = new Book(); 
Author author = new Author(); 
author.setName("annlee"); 
author.setAddress("gz"); 
book.setName("struts2"); 
book.setAuthor(author); 
root.put("info","struts"); 
root.put("book", book);

为了访问数据模型中名为struts2的书的作者的名字,可以使用如下语法:

book.author.name    //全部使用点语法 
book["author"].name 
book.author["name"]    //混合使用点语法和方括号语法 
book["author"]["name"]   //全部使用方括号语法

使用点语法时，变量名字有顶层变量一样的限制，但方括号语法没有该限制，因为名字可以是任意表达式的结果。

字符串操作

上边是文章的部分内容，为便于维护，全文已转移到此网址：FreeMarker-表达式和运算符的用法(全面/有示例) - 自学精灵