IT教程 | 加入收藏 | 简体 | 繁体
GUI编程:Java基础StrutsSpringHibernateIbatis框架整合GUI编程Ejb分布式开发
当前位置: 首页 > Java教程 > GUI编程

FreeMarker模板的核心功能:表达式

2014-02-12来源:[www.121ask.com]热度:0℃ 【字体:

FreeMarker模板的核心功能:表达式.

表达式是FreeMarker模板的核心功能,表达式放置在插值语法${}之中时,表明需要输出表达式的值;表达式语法也可与FreeMarker 标签结合,用于控制输出.实际上FreeMarker的表达式功能非常强大,它不仅支持直接指定值,输出变量值,也支持字符串格式化输出和集合访问等功能. 

★1 直接指定值 

使用直接指定值语法让FreeMarker直接输出插值中的值,而不是输出变量值.直接指定值可以是字符串,数值,布尔值,集合和MAP对象. 

1,字符串 
直接指定字符串值使用单引号或双引号限定,如果字符串值中包含特殊字符需要转义,看下面的例子: 
${"我的文件保存在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 

2,数值 
表达式中的数值直接输出,不需要引号.小数点使用"."分隔,不能使用分组","符号.FreeMarker目前还不支持科学计数法,所以"1E3"是错误的.在FreeMarker表达式中使用数值需要注意以下几点: 
1,数值不能省略小数点前面的0,所以".5"是错误的写法 
2,数值8 , +8 , 8.00都是相同的 

3,布尔值 
直接使用true和false,不使用引号. 

4,集合 
集合以方括号包括,各集合元素之间以英文逗号","分隔,看如下的例子: 
<#list ["星期一", "星期二", "星期三", "星期四", "星期五", "星期六", "星期天"] as x> 
${x} 
</#list> 
输出结果是: 
星期一 
星期二 
星期三 
星期四 
星期五 
星期六 
星期天 

除此之外,集合元素也可以是表达式,例子如下: 
[2 + 2, [1, 2, 3, 4], "whatnot"] 

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

5,Map对象 
Map对象使用花括号包括,Map中的key-value对之间以英文冒号":"分隔,多组key-value对之间以英文逗号","分隔.下面是一个例子: 
{"语文":78, "数学":80} 
Map对象的key和value都是表达式,但是key必须是字符串 
[NextPage]
★2 输出变量值 

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

1,顶层变量 
所谓顶层变量就是直接放在数据模型中的值,例如有如下数据模型: 
Map root = new HashMap();   //创建数据模型 
root.put("name","annlee");   //name是一个顶层变量 

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

2,输出集合元素 
如果需要输出集合元素,则可以根据集合元素的索引来输出集合元素,集合元素的索引以方括号指定.假设有索引: 
["星期一","星期二","星期三","星期四","星期五","星期六","星期天"].该索引名为week,如果需要输出星期三,则可以使用如下语法: 
${week[2]}   //输出第三个集合元素 

此外,FreeMarker还支持返回集合的子集合,如果需要返回集合的子集合,则可以使用如下语法: 
week[3..5]   //返回week集合的子集合,子集合中的元素是week集合中的第4-6个元素 

3,输出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"]   //全部使用方括号语法 

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

★3, 字符串操作 

FreeMarker的表达式对字符串操作非常灵活,可以将字符串常量和变量连接起来,也可以返回字符串的子串等. 

字符串连接有两种语法: 
1,使用${..}或#{..}在字符串常量部分插入表达式的值,从而完成字符串连接. 
2,直接使用连接运算符+来连接字符串 

例如有如下数据模型: 
Map root = new HashMap(); root.put("user","annlee"); 
下面将user变量和常量连接起来: 
${"hello, ${user}!"}   //使用第一种语法来连接 
${"hello, " + user + "!"} //使用+号来连接 
上面的输出字符串都是hello,annlee!,可以看出这两种语法的效果完全一样. 

值得注意的是,${..}只能用于文本部分,不能用于表达式,下面的代码是错误的: 
<#if ${isBig}>Wow!</#if> 
<#if "${isBig}">Wow!</#if> 
应该写成:<#if isBig>Wow!</#if> 

截取子串可以根据字符串的索引来进行,截取子串时如果只指定了一个索引值,则用于取得字符串中指定索引所对应的字符;如果指定两个索引值,则返回两个索引中间的字符串子串.假如有如下数据模型: 
Map root = new HashMap(); root.put("book","struts2,freemarker"); 
可以通过如下语法来截取子串: 
${book[0]}${book[4]}   //结果是su 
${book[1..4]}     //结果是tru 
[NextPage]
★4 集合连接运算符 

这里所说的集合运算符是将两个集合连接成一个新的集合,连接集合的运算符是+,看如下的例子: 
<#list ["星期一","星期二","星期三"] + ["星期四","星期五","星期六","星期天"] as x> 
${x} 
</#list> 
输出结果是:星期一 星期二 星期三 星期四 星期五 星期六 星期天 

★5 Map连接运算符 

Map对象的连接运算符也是将两个Map对象连接成一个新的Map对象,Map对象的连接运算符是+,如果两个Map对象具有相同的key,则右边的值替代左边的值.看如下的例子: 
<#assign scores = {"语文":86,"数学":78} + {"数学":87,"Java":93}> 
语文成绩是${scores.语文} 
数学成绩是${scores.数学} 
Java成绩是${scores.Java} 
输出结果是: 
语文成绩是86 
数学成绩是87 
Java成绩是93 

★6 算术运算符 

FreeMarker表达式中完全支持算术运算,FreeMarker支持的算术运算符包括:+, - , * , / , % 看如下的代码: 
<#assign x=5> 
${ x * x - 100 } 
${ x /2 } 
${ 12 %10 } 
输出结果是: 
-75   2.5   2 

在表达式中使用算术运算符时要注意以下几点: 
1,运算符两边的运算数字必须是数字 
2,使用+运算符时,如果一边是数字,一边是字符串,就会自动将数字转换为字符串再连接,如:${3 + "5"},结果是:35 

使用内建的int函数可对数值取整,如: 
<#assign x=5> 
${ (x/2)?int } 
${ 1.1?int } 
${ 1.999?int } 
${ -1.1?int } 
${ -1.999?int } 
结果是:2 1 1 -1 -1 
[NextPage]
★7 比较运算符 

表达式中支持的比较运算符有如下几个: 
1,=或者==:判断两个值是否相等. 
2,!=:判断两个值是否不等. 
3,>或者gt:判断左边值是否大于右边值 
4,>=或者gte:判断左边值是否大于等于右边值 
5,<或者lt:判断左边值是否小于右边值 
6,<=或者lte:判断左边值是否小于等于右边值 

注意:=和!=可以用于字符串,数值和日期来比较是否相等,但=和!=两边必须是相同类型的值,否则会产生错误,而且FreeMarker是精确比较,"x","x ","X"是不等的.其它的运行符可以作用于数字和日期,但不能作用于字符串,大部分的时候,使用gt等字母运算符代替>会有更好的效果,因为 FreeMarker会把>解释成FTL标签的结束字符,当然,也可以使用括号来避免这种情况,如:<#if (x>y)> 

★8 逻辑运算符 

逻辑运算符有如下几个: 
逻辑与:&& 
逻辑或:|| 
逻辑非:! 
逻辑运算符只能作用于布尔值,否则将产生错误 

★9 内建函数 

FreeMarker还提供了一些内建函数来转换输出,可以在任何变量后紧跟?,?后紧跟内建函数,就可以通过内建函数来轮换输出变量.下面是常用的内建的字符串函数: 
html:对字符串进行HTML编码 
cap_first:使字符串第一个字母大写 
lower_case:将字符串转换成小写 
upper_case:将字符串转换成大写 
trim:去掉字符串前后的空白字符 

下面是集合的常用内建函数 
size:获取序列中元素的个数 

下面是数字值的常用内建函数 
int:取得数字的整数部分,结果带符号 

例如: 
<#assign test="Tom & Jerry"> 
${test?html} 
${test?upper_case?html} 
结果是:Tom &amp; Jerry   TOM &amp; JERRY 
[NextPage]
★10 空值处理运算符 

FreeMarker对空值的处理非常严格,FreeMarker的变量必须有值,没有被赋值的变量就会抛出异常,因为FreeMarker未赋值的变量强制出错可以杜绝很多潜在的错误,如缺失潜在的变量命名,或者其他变量错误.这里所说的空值,实际上也包括那些并不存在的变量,对于一个Java的 null值而言,我们认为这个变量是存在的,只是它的值为null,但对于FreeMarker模板而言,它无法理解null值,null值和不存在的变量完全相同. 

为了处理缺失变量,FreeMarker提供了两个运算符: 
!:指定缺失变量的默认值 
??:判断某个变量是否存在 

其中,!运算符的用法有如下两种: 
variable!或variable!defaultValue,第一种用法不给缺失的变量指定默认值,表明默认值是空字符串,长度为0的集合,或者长度为0的Map对象. 

使用!指定默认值时,并不要求默认值的类型和变量类型相同.使用??运算符非常简单,它总是返回一个布尔值,用法为:variable??,如果该变量存在,返回true,否则返回false 

★11 运算符的优先级 

FreeMarker中的运算符优先级如下(由高到低排列): 
1,一元运算符:! 
2,内建函数:? 
3,乘除法:*, / , % 
4,加减法:- , + 
5,比较:> , < , >= , <= (lt , lte , gt , gte) 
6,相等:== , = , != 
7,逻辑与:&& 
8,逻辑或:|| 
9,数字范围:.. 

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

以上IT文章《FreeMarker模板的核心功能:表达式》由名客技术网[www.121ask.com]提供阅读!
推广信息
推广信息
名客技术网是一个免费为广大IT技术人员提供IT教程,绿色软件,asp/php/jsp/java/net等实例视频教程,CMS教程,破解软件下载以及学习相关源码、知识的IT网站。
名客技术网如果无意之中侵犯了您的版权,请来电告知,本站将在3个工作日内删除 QQ:175352796
Copyright 2011-2017 Powered by 121ASK.COM, All Rights Reserved.
备案号:鄂ICP备11013833号-3