Chinaunix首页 | 论坛 | 博客
  • 博客访问: 1087363
  • 博文数量: 282
  • 博客积分: 10865
  • 博客等级: 上将
  • 技术积分: 2480
  • 用 户 组: 普通用户
  • 注册时间: 2006-05-12 12:35
文章存档

2017年(1)

2016年(3)

2015年(10)

2014年(12)

2013年(5)

2012年(10)

2011年(29)

2010年(3)

2008年(13)

2007年(92)

2006年(104)

我的朋友

分类: Java

2007-04-22 18:32:15

3、模板

(1)整体结构

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

Ø         文本:直接输出

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

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

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

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

[BR]
[BR]
  Welcome![BR]
[BR]
[BR]
  <#-- Greet the user with his/her name -->[BR]
 

Welcome ${user}!

[BR]
 

We have these animals:[BR]
 

    [BR]
      <#list animals as being>[BR]
       
  • ${being.name} for ${being.price} Euros[BR]
      [BR]
     
[BR]
[BR]
 
l         [BR]是用于换行的特殊字符序列

l         注意事项:

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

Ø         Interpolation只能在文本中使用

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

<#if <#include 'foo'>='bar'>...
Ø         注释可以位于FTL标记和Interpolation内部,如下面的例子:

Welcome ${user <#-- The name of user -->}!

[BR]

We have these animals:[BR]

    [BR]
    <#list <#-- some comment... --> animals as <#-- again... --> being>[BR]
    ... 
    Ø         多余的空白字符会在模板输出时移除

    (2)指令

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

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

    Ø         开始标记:<#directivename parameters>

    Ø         结束标记:

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

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

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

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


      <#list animals as being>
       
    • ${being.name} for ${being.price} Euros
        <#if use = "Big Joe">
           (except for you)

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

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

    <#list[BR]
      animals       as[BR]
         being[BR]
    >[BR]
    ${being.name} for ${being.price} Euros[BR]
     
    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、+8、08和8.00都是相同的

    Ø         布尔值

    n         true和false,不使用引号

    Ø         序列

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

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

    输出的结果是:

    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]语法,从序列中获得序列片断(也是序列);startIndex和endIndex是结果为数字的表达式

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

    l         字符串操作

    Ø         Interpolation(或连接操作)

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

    ${"Hello ${user}!"}
    ${"${user}${user}${user}${user}"} 
    n         可以使用+操作符获得同样的结果

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

    <#if ${isBig}>Wow!
    <#if "${isBig}">Wow!
    应该写成:

    <#if isBig>Wow!
    Ø         子串

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

    ${user[0]}${user[4]}
    ${user[1..4]}
    结果是(注意第一个字符的索引是0):

    BJ
    ig J
    l         序列操作

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

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

    输出结果是:

    - 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}
    输出结果是(假设x为5):

    -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}
    输出结果是(假设x为5):

    2
    1
    1
    -1
    -1
    l         比较操作符

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

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

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

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

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

    Ø         另一种替代的方法是,使用lt、lte、gt和gte来替代<、<=、>和>=

    l         逻辑操作符

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

    Ø         例子:

    <#if x < 12 && color = "green">
      We have less than 12 things, and they are green.

    <#if !hot> <#-- here hot must be a boolean -->
      It's not hot.
     
    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 & Jerry
    TOM & JERRY 
    l         操作符优先顺序

    操作符组
     操作符
     
    后缀
     [subvarName] [subStringRange] . (methodParams)
     
    一元
     +expr、-expr、!
     
    内建
     ?
     
    乘法
     *、 / 、%
     
    加法
     +、-
     
    关系
     <、>、<=、>=(lt、lte、gt、gte)
     
    相等
     ==(=)、!=
     
    逻辑and
     &&
     
    逻辑or
     ||
     
    数字范围
     ..
     

    (4)Interpolation

    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  -->
阅读(1695) | 评论(0) | 转发(0) |
给主人留下些什么吧!~~