FreeMarker设计指南(3)

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

4位16进制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  
    
    

<script type=text/javascript charset=utf-8 src="http://static.bshare.cn/b/buttonLite.js#style=-1&uuid=&pophcol=3&lang=zh"></script> <script type=text/javascript charset=utf-8 src="http://static.bshare.cn/b/bshareC0.js"></script>
阅读(620) | 评论(0) | 转发(0) |
给主人留下些什么吧!~~
评论热议
  • 0
    点赞
  • 0
    收藏
    觉得还不错? 一键收藏
  • 0
    评论

“相关推荐”对你有帮助么?

  • 非常没帮助
  • 没帮助
  • 一般
  • 有帮助
  • 非常有帮助
提交
评论
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

当前余额3.43前往充值 >
需支付:10.00
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、付费专栏及课程。

余额充值