您现在的位置: 365建站网 > 365学习 > freemarker学习笔记_表达式、变量和内建函数

freemarker学习笔记_表达式、变量和内建函数

文章来源:365jz.com     点击数:1426    更新时间:2009-12-02 21:17   参与评论

3)表达式

l         直接指定值

Ø         字符串

n         使用单引号或双引号限定

n         如果包含特殊字符需要转义,如下面的例子:

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

输出结果是:

It's "quoted" and
this is a backslash: \
 
It's "quoted" and
this is a backslash: \ 

n         下面是支持的转义序列:

转义序列

含义

\"

双引号(u0022)

\'

单引号(u0027)

\\

反斜杠(u005C)

\n

换行(u000A)

\r

Return (u000D)

\t

Tab (u0009)

\b

Backspace (u0008)

\f

Form feed (u000C)

\l

<

\g

>

\a

&

\{

{

\xCode

416进制Unicode代码

n         有一类特殊的字符串称为raw字符串,被认为是纯文本,其中的\{等不具有特殊含义,该类字符串在引号前面加r,下面是一个例子:

${r"${foo}"}
${r"C:\foo\bar"}  

输出的结果是:

${foo}
C:\foo\bar  

Ø         数字

n         直接输入,不需要引号

n         精度数字使用“.”分隔,不能使用分组符号

n         目前版本不支持科学计数法,所以“1E3”是错误的

n         不能省略小数点前面的0,所以“.5”是错误的

n         数字8+8088.00都是相同的

Ø         布尔值

n         truefalse,不使用引号

Ø         序列

n         由逗号分隔的子变量列表,由方括号限定,下面是一个例子:

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

输出的结果是:

winter
spring
summer
autumn

n         列表的项目是表达式,所以可以有下面的例子:

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

n         可以使用数字范围定义数字序列,例如2..5等同于[2, 3, 4, 5],但是更有效率,注意数字范围没有方括号

n         可以定义反递增的数字范围,如5..2

Ø         散列(hash

n         由逗号分隔的键/值列表,由大括号限定,键和值之间用冒号分隔,下面是一个例子:

{"name":"green mouse", "price":150}

n         键和值都是表达式,但是键必须是字符串

l         获取变量

Ø         顶层变量: ${variable},变量名只能是字母、数字、下划线、$@#的组合,且不能以数字开头

Ø         从散列中获取数据

n         可以使用点语法或方括号语法,假设有下面的数据模型:

(root)
 |
 +- book
 |   |
 |   +- title = "Breeding green mouses"
 |   |
 |   +- author
 |       |
 |       +- name = "Julia Smith"
 |       |
 |       +- info = "Biologist, 1923-1985, Canada"
 |
 +- test = "title" 

下面都是等价的:

book.author.name
book["author"].name
book.author.["name"]
book["author"]["name"]

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

Ø         从序列获得数据:和散列的方括号语法语法一样,只是方括号中的表达式值必须是数字;注意:第一个项目的索引是0

Ø         序列片断:使用[startIndex..endIndex]语法,从序列中获得序列片断(也是序列);startIndexendIndex是结果为数字的表达式

Ø         特殊变量:FreeMarker内定义变量,使用.variablename语法访问

l         字符串操作

Ø         Interpolation(或连接操作)

n         可以使用${..}(或#{..})在文本部分插入表达式的值,例如:

${"Hello ${user}!"}
${"${user}${user}${user}${user}"}  

n         可以使用+操作符获得同样的结果

${"Hello " + user + "!"}
${user + user + user + user}

n         ${..}只能用于文本部分,下面的代码是错误的:

<#if ${isBig}>Wow!</#if>
<#if "${isBig}">Wow!</#if>

应该写成:

<#if isBig>Wow!</#if>

Ø         子串

n         例子(假设user的值为“Big Joe”):

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

结果是(注意第一个字符的索引是0):

BJ
ig J 

l         序列操作

Ø         连接操作:和字符串一样,使用+,下面是一个例子:

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

输出结果是:

- Joe
- Fred
- Julia
- Kate

l         散列操作

Ø         连接操作:和字符串一样,使用+,如果具有相同的key,右边的值替代左边的值,例如:

<#assign ages = {"Joe":23, "Fred":25} + {"Joe":30, "Julia":18}>
- Joe is ${ages.Joe}
- Fred is ${ages.Fred}
- Julia is ${ages.Julia}  

输出结果是:

- Joe is 30
- Fred is 25
- Julia is 18  

l         算术运算

Ø         +、-、×、/、%,下面是一个例子:

${x * x - 100}
${x / 2}
${12 % 10}

输出结果是(假设x5):

-75
2.5

Ø         操作符两边必须是数字,因此下面的代码是错误的:

${3 * "5"} <#-- WRONG! -->  

Ø         使用+操作符时,如果一边是数字,一边是字符串,就会自动将数字转换为字符串,例如:

${3 + "5"}  

输出结果是:

35

Ø         使用内建的int(后面讲述)获得整数部分,例如:

${(x/2)?int}
${1.1?int}
${1.999?int}
${-1.1?int}
${-1.999?int}

输出结果是(假设x5):

2
1
1
-1
-1

l         比较操作符

Ø         使用=(或==,完全相等)测试两个值是否相等,使用!= 测试两个值是否不相等

Ø         =!=两边必须是相同类型的值,否则会产生错误,例如<#if 1 = "1">会引起错误

Ø         Freemarker是精确比较,所以对"x""x  ""X"是不相等的

Ø         对数字和日期可以使用<<=>>=,但不能用于字符串

Ø         由于Freemarker会将>解释成FTL标记的结束字符,所以对于>>=可以使用括号来避免这种情况,例如<#if (x > y)>

Ø         另一种替代的方法是,使用ltltegtgte来替代<<=>>=

l         逻辑操作符

Ø         &&and)、||or)、!not),只能用于布尔值,否则会产生错误

Ø         例子:

<#if x < 12 && color = "green">
  We have less than 12 things, and they are green.
</#if>
<#if !hot> <#-- here hot must be a boolean -->
  It's not hot.
</#if>  

l         内建函数

Ø         内建函数的用法类似访问散列的子变量,只是使用“?”替代“.”,下面列出常用的一些函数

Ø         字符串使用的:

n         HTML:对字符串进行HTML编码

n         cap_first:使字符串第一个字母大写

n         lower_case:将字符串转换成小写

n         upper_case:将字符串转换成大写

n         trim:去掉字符串前后的空白字符

Ø         序列使用的:

n         size:获得序列中元素的数目

Ø         数字使用的:

n         int:取得数字的整数部分(如-1.9?int的结果是-1

Ø         例子(假设test保存字符串"Tom & Jerry"):

${test?html}
${test?upper_case?html}

输出结果是:

Tom &amp; Jerry
TOM &amp; JERRY  

l         操作符优先顺序

操作符组

操作符

后缀

[subvarName] [subStringRange] . (methodParams)

一元

+expr-expr!

内建

?

乘法

* / %

加法

+-

关系

<><=>=ltltegtgte

相等

===)、!=

逻辑and

&&

逻辑or

||

数字范围

..

4Interpolation

l         Interpolation有两种类型:

Ø         通用Interpolation${expr}

Ø         数字Interpolation#{expr}#{expr; format}

l         注意:Interpolation只能用于文本部分

l         通用Interpolation

Ø         插入字符串值:直接输出表达式结果

Ø         插入数字值:根据缺省格式(由#setting指令设置)将表达式结果转换成文本输出;可以使用内建函数string格式化单个Interpolation,下面是一个例子:

<#setting number_format="currency"/>
<#assign answer=42/>
${answer}
${answer?string}  <#-- the same as ${answer} -->
${answer?string.number}
${answer?string.currency}
${answer?string.percent} 

输出结果是:

$42.00
$42.00
42
$42.00
4,200%

Ø         插入日期值:根据缺省格式(由#setting指令设置)将表达式结果转换成文本输出;可以使用内建函数string格式化单个Interpolation,下面是一个使用格式模式的例子:

${lastUpdated?string("yyyy-MM-dd HH:mm:ss zzzz")}
${lastUpdated?string("EEE, MMM d, ''yy")}
${lastUpdated?string("EEEE, MMMM dd, yyyy, hh:mm:ss a '('zzz')'")}  

输出的结果类似下面的格式:

2003-04-08 21:24:44 Pacific Daylight Time
Tue, Apr 8, '03
Tuesday, April 08, 2003, 09:24:44 PM (PDT)

Ø         插入布尔值:根据缺省格式(由#setting指令设置)将表达式结果转换成文本输出;可以使用内建函数string格式化单个Interpolation,下面是一个例子:

<#assign foo=true/>
${foo?string("yes", "no")}

输出结果是:

yes

l         数字Interpolation#{expr; format}形式可以用来格式化数字,format可以是:

Ø         mX:小数部分最小X

Ø         MX:小数部分最大X

Ø         例子:

           <#-- If the language is US English the output is: -->
<#assign x=2.582/>
<#assign y=4/>
#{x; M2}   <#-- 2.58 -->
#{y; M2}   <#-- 4    -->
#{x; m1}   <#-- 2.6 -->
#{y; m1}   <#-- 4.0 -->
#{x; m1M2} <#-- 2.58 -->
#{y; m1M2} <#-- 4.0  --> 

 

如对本文有疑问,请提交到交流论坛,广大热心网友会为你解答!! 点击进入论坛


发表评论 (1426人查看0条评论)
请自觉遵守互联网相关的政策法规,严禁发布色情、暴力、反动的言论。
用户名: 验证码: 点击我更换图片
最新评论
------分隔线----------------------------