freemarker基础

fhqibjg

浏览: 54952 次
性别:
来自: 湖南

最近访客更多访客>>

hitwangzhuo

蓝骑士

raingel520

wpd

博主相关

博客

微博

相册

留言

关于我

文章分类

社区版块

存档分类

博客分类：

freemarker

freemarker 文档资料

[文章freemarker手册]

   FreeMarker是一个模板引擎，一个基于模板生成文本输出的通用工具，使用纯Java编写，被设计用来生成HTML Web页面，特别是基于MVC模式的应用程序，但FreeMarker不是一个Web应用框架，而适合作为Web应用框架一个组件。

   我们可以用它生各种文本文件:html,xml,java源代码等，由于是轻量级的，所以易于嵌入到你的产品中，而不需要servlet环境。你可以按照你的需要生成文本，保存到本地，或是应用程序发送给web浏览器。

   FreeMarker模板可以包括下面三种特定部分：
     1,${…}：称为interpolations，FreeMarker会在输出时用实际值进行替代
     2,TL标记（FreeMarker模板语言标记）：类似于HTML标记，为了与HTML标记区分，用#开始（有些以@开始，在后面叙述）
     3, 注释：包含在<#--和-->（而不是）之间
   相关指令：
     1, if指令
        <#if animals.python.price < animals.elephant.price>
             .....
       <#else>
             .....
       </#if>

    2, list指令
        <#list animals as being>
           ${being.name} 
       </#list>

    3, include指令
       <html>
       <head>
        <body>
          <h1>Test </h1>
       <p>Blah blah...
        <#include "/copyright_footer.html">
       </body>
      </html>

在FreeMarker中，使用FTL标记引用指令
有三种FTL标记，这和HTML标记是类似的：
    开始标记：<#directivename parameters>
    结束标记：</#directivename>
    空内容指令标记：<#directivename parameters/>
   有两种类型的指令：预定义指令和用户定义指令
   用户定义指令要使用@替换#，如<@mydirective>..</@mydirective>（会在后面讲述）
   FTL标记不能够交叉，而应该正确的嵌套如下面的代码是错误的：
     <ul>
      <#list animals as being>
        <li>${being.name} for ${being.price} Euros
      <#if use = "Big Joe">
       (except for you)
     </#list>
      </#if> <#-- WRONG! -->
   </ul>

表达式
    直接指定值
      一，字符串
          1,使用单引号或双引号限定
       2,如果包含特殊字符需要转义
      二，数字
1 直接输入，不需要引号
2 精度数字使用“.”分隔，不能使用分组符号
3目前版本不支持科学计数法，所以“1E3”是错误的
4不能省略小数点前面的0，所以“.5”是错误的
5数字8、+8、08和8.00都是相同的
      三，布尔值
true和false，不使用引号
      四，序列
由逗号分隔的子变量列表，由方括号限定，下面是一个例子：
              <#list ["winter", "spring", "summer", "autumn"] as x>
               ${x}
            </#list>
      输出的结果是：
          winter
         spring
         summer
         autumn
     五，列表的项目是表达式，所以可以有下面的例子：
                 [2 + 2, [1, 2, 3, 4], "whatnot"]
       1可以使用数字范围定义数字序列，例如2..5等同于[2, 3, 4, 5]，但是更有效率，注意数字范围没有方括号
        2可以定义反递增的数字范围，如5..2
       3散列（hash）
        4由逗号分隔的键/值列表，由大括号限定，键和值之间用冒号分隔，下面是一个例子：
{"name":"green mouse", "price":150}
         键和值都是表达式，但是键必须是字符串
         获取变量
         顶层变量： ${variable}，变量名只能是字母、数字、下划线、$、@和#的组合，且不能以数字开头


         使用内建的int（后面讲述）获得整数部分，例如：
${(x/2)?int}
${1.1?int}
${1.999?int}
${-1.1?int}
${-1.999?int}
输出结果是（假设x为5）：
2
1
1
-1
-1
         比较操作符
         使用=（或==，完全相等）测试两个值是否相等，使用!= 测试两个值是否不相等
         =和!=两边必须是相同类型的值，否则会产生错误，例如<#if 1 = "1">会引起错误
         Freemarker是精确比较，所以对"x"、"x "和"X"是不相等的
         对数字和日期可以使用<、<=、>和>=，但不能用于字符串
         由于Freemarker会将>解释成FTL标记的结束字符，所以对于>和>=可以使用括号来避免这种情况，例如<#if (x > y)>
         另一种替代的方法是，使用lt、lte、gt和gte来替代<、<=、>和>=
         逻辑操作符
         &&（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>
         内建函数
         内建函数的用法类似访问散列的子变量，只是使用“?”替代“.”，下面列出常用的一些函数
         字符串使用的：
         html：对字符串进行HTML编码
         cap_first：使字符串第一个字母大写
         lower_case：将字符串转换成小写
         upper_case：将字符串转换成大写
         trim：去掉字符串前后的空白字符
         序列使用的：
         size：获得序列中元素的数目
         数字使用的：
         int：取得数字的整数部分（如-1.9?int的结果是-1）
         例子（假设test保存字符串"Tom & Jerry"）：
${test?html}
${test?upper_case?html}
输出结果是：
Tom & Jerry
TOM & JERRY
         操作符优先顺序
操作符组操作符
后缀 [subvarName] [subStringRange] . (methodParams)
一元 +expr、-expr、!
内建 ?
乘法 *、 / 、%
加法 +、-
关系 <、>、<=、>=（lt、lte、gt、gte）
相等 ==（=）、!=
逻辑and &&
逻辑or ||
数字范围 ..
（4）Interpolation
         Interpolation有两种类型：
         通用Interpolation：${expr}
         数字Interpolation：#{expr}或#{expr; format}
         注意：Interpolation只能用于文本部分
         通用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
         数字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 -->

分享到：