`
fhqibjg
  • 浏览: 55119 次
  • 性别: Icon_minigender_1
  • 来自: 湖南
社区版块
存档分类
最新评论

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集全animals中存主的being对像数据-->
       </#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 &amp; Jerry
TOM &amp; 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  --> 
分享到:
评论

相关推荐

    freemarker基础学习.pdf

    freemarker基础学习,是一本值得研究的书籍。对于初学者来说非常有用。

    freemarker基础v1.1.pdf

    在示例的`pom.xml`中,我们看到父工程指定了Spring Boot的版本为2.1.3.RELEASE,子工程`test-freemarker`包含了必要的依赖,如`spring-boot-starter-freemarker`和`spring-boot-starter-web`,这些依赖使得项目能够...

    FreeMarker的基础知识整理

    FreeMarker 是一种强大的模板语言,主要用于生成动态内容,如HTML页面。...FreeMarker的核心概念是将静态的...对于初学者来说,理解FreeMarker的基础知识,如变量类型、模板结构和插值机制,是掌握这一技术的关键步骤。

    FreeMarker基础语法

    根据提供的文件信息,我们可以深入探讨FreeMarker的基础语法及其在模板引擎中的应用。FreeMarker是一种用于生成文本输出的模板引擎,广泛应用于Web开发中,能够帮助开发者动态生成HTML、XML等格式的内容。接下来,...

    freemarkerdemo 生成word 插入图片

    1. **Freemarker基础知识**:Freemarker是一个基于模板的语言,它允许开发者通过定义模板文件,然后结合Java对象数据,生成动态内容。模板文件中包含了一系列控制结构(如条件语句、循环)和变量引用,这些变量可以...

    freemarker中文学习资料

    1. **Freemarker基础概念** - **模板语言**:Freemarker使用一种简单的、声明式的模板语言,允许开发者编写模板,与后台数据模型结合,生成动态内容。 - **数据模型**:Freemarker模板与应用程序的数据模型进行...

    Freemarker实现excel导出功能

    一、Freemarker基础 1. 模板语言:Freemarker是一种基于模板的语言,它允许开发者通过简单的语法(如 `${}` 和 `#if`)来动态地生成文本输出,如HTML、XML或者,如我们所关注的,Excel文件。 2. 数据模型:在使用...

    freemarker 简单项目示例

    1. **Freemarker基础** - Freemarker是一个基于模板的开源Java库,它允许开发者通过定义模板语言(FTL,Freemarker Template Language)与数据模型相结合,生成动态内容。 - FTL是一种声明式语言,它不包含任何...

    freemarker培训课件

    标题:"Freemarker培训课件" 描述:"Freemarker培训,非常通俗,易懂,请多提宝贵意见" 标签:"Freemarker" 从标题和描述中提取的关键知识点是关于Freemarker的基本概念、其功能和用途,以及如何进行模板开发和...

    freemarker生成doc方案

    一、Freemarker基础 Freemarker是一个基于模板的语言,它与编程语言不同,它专注于数据模型和视图的分离。在Java应用中,你可以创建一个Freemarker模板,将数据模型注入其中,然后Freemarker会根据模板和数据生成...

    freemarker 教程 使用手册

    一、Freemarker基础 1. 模板语言:Freemarker是一种声明式语言,它不包含任何控制结构(如循环、条件语句),而是通过特定的语法来表达数据与模板的结合方式。 2. 变量与数据模型:在Freemarker中,变量是由`${}`...

    excel 导出 freemarker

    一、FreeMarker基础 FreeMarker是一个基于模板的Java库,它允许我们将数据模型与HTML或其他类型的模板结合,生成动态内容。FreeMarker模板语言(FTL)是模板中使用的标记语言,用于控制结构和逻辑。它与Java代码分离...

    freemarker基础代码

    在FreeMarker的基础实现中,有几个核心概念和关键知识点: 1. **模板(Template)**:模板是FreeMarker的基石,它定义了如何展示数据。模板文件通常以`.ftl`为扩展名,其中包含FreeMarker语法,如`${expression}`...

    FreeMarker应用实例和PPT

    - **FreeMarker基础**:解释FreeMarker的基本语法和结构。 - **Struts2整合步骤**:展示如何在Struts2项目中添加FreeMarker支持,配置文件设置,Action和模板的关联。 - **模板示例**:展示一个完整的FreeMarker...

    实用方便freemarker.jar freemarker架包 freemarker生成excel、word、html、xml例子

    1. FreeMarker基础: FreeMarker是一个基于模板的语言,它与编程语言(如Java)分离,允许开发者将数据模型和页面展示逻辑分开。它的核心概念是模板和数据模型。模板是HTML、XML或其他格式的文本文件,其中包含可...

    FreeMarker 设计指南

    一、FreeMarker基础 1. **模板语言**:FreeMarker使用模板语言,它是一种非编程语言,主要用于动态生成HTML或其他文本格式的文档。模板语言包含控制结构(如条件语句和循环)和变量表达式,它们与后台Java代码交互...

    freemarker获取数据

    一、Freemarker基础 1. 模板语言:Freemarker使用一种简单的文本模板语言,它不包含任何编程语句,只有控制结构(如`if`、`for`)和变量引用。变量通常以`${}`或`#set`指令表示。 2. 数据模型:Freemarker与后端...

    freemarker导出word完整案例

    一、Freemarker基础 1. 模板语法:Freemarker的模板由文本和控制结构(如条件语句、循环)组成,其中 `${expression}` 用于输出变量,`&lt;#if&gt;`、`&lt;#foreach&gt;` 等用于控制流程。例如,`${user.name}` 可以输出用户...

    freemarker教程

    一、Freemarker基础 1. 模板语法:Freemarker的模板语言由简单的文本和特殊的指令组成。例如,`${expression}`用于插入变量值,`&lt;#if condition&gt;`和`&lt;#else&gt;`用于条件判断,`&lt;#list items as item&gt;`用于循环遍历。 ...

Global site tag (gtag.js) - Google Analytics