OMG,到底在寻找什么..................
(构造一个完美的J2EE系统所需要的完整知识体系)
posts - 198,  comments - 37,  trackbacks - 0
转贴地址:http://blog.csdn.net/chenyun2000/archive/2004/11/13/180780.aspx

3、模板

1)整体结构

l         模板使用FTLFreeMarker模板语言)编写,是下面各部分的一个组合:

Ø         文本:直接输出

Ø         Interpolation:由${},或#{}来限定,计算值替代输出

Ø         FTL标记:FreeMarker指令,和HTML标记类似,名字前加#予以区分,不会输出

Ø         注释:由<#---->限定,不会输出

l         下面是以一个具体模板例子:

<html>[BR]
<head>[BR]
  <title>Welcome!</title>[BR]
</head>[BR]
<body>[BR]
  <#-- Greet the user with his/her name -->[BR]
  <h1>Welcome ${user}!</h1>[BR]
  <p>We have these animals:[BR]
  <ul>[BR]
  <#list animals as being>[BR]
    <li>${being.name} for ${being.price} Euros[BR]
  </#list>[BR]
  </ul>[BR]
</body>[BR]
</html>  

l         [BR]是用于换行的特殊字符序列

l         注意事项:

Ø         FTL区分大小写,所以list是正确的FTL指令,而List不是;${name}${NAME}是不同的

Ø         Interpolation只能在文本中使用

Ø         FTL标记不能位于另一个FTL标记内部,例如:

<#if <#include 'foo'>='bar'>...</if>

Ø         注释可以位于FTL标记和Interpolation内部,如下面的例子:

<h1>Welcome ${user <#-- The name of user -->}!</h1>[BR]
<p>We have these animals:[BR]
<ul>[BR]
<#list <#-- some comment... --> animals as <#-- again... --> being>[BR]
...  

Ø         多余的空白字符会在模板输出时移除

2)指令

l         FreeMarker中,使用FTL标记引用指令

l         有三种FTL标记,这和HTML标记是类似的:

Ø         开始标记:<#directivename parameters>

Ø         结束标记:</#directivename>

Ø         空内容指令标记:<#directivename parameters/>

l         有两种类型的指令:预定义指令和用户定义指令

l         用户定义指令要使用@替换#,如<@mydirective>...</@mydirective>(会在后面讲述)

l         FTL标记不能够交叉,而应该正确的嵌套,如下面的代码是错误的:

<ul>
<#list animals as being>
  <li>${being.name} for ${being.price} Euros
  <#if use = "Big Joe">
     (except for you)
</#list>
</#if><#-- WRONG! -->
</ul>  

l         如果使用不存在的指令,FreeMarker不会使用模板输出,而是产生一个错误消息

l         FreeMarker会忽略FTL标记中的空白字符,如下面的例子:

<#list[BR]
  animals       as[BR]
     being[BR]
>[BR]
${being.name} for ${being.price} Euros[BR]
</#list    >  

l         但是,<</和指令之间不允许有空白字符

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  

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  -->  
posted on 2006-04-19 18:05 OMG 阅读(298) 评论(0)  编辑  收藏 所属分类: FreeMarker

只有注册用户登录后才能发表评论。


网站导航:
 

<2006年4月>
2627282930311
2345678
9101112131415
16171819202122
23242526272829
30123456

常用链接

留言簿(1)

随笔分类

随笔档案

IT风云人物

文档

朋友

相册

经典网站

搜索

  •  

最新评论

阅读排行榜

评论排行榜