`

FreeMarker学习

阅读更多
FreeMarker是一个用Java编写的模板引擎,主要用来生成HTML Web页面,特别是基于MVC模式的应用程序。虽然FreeMarker具有一些编程的能力,但不像PHP,通常由Java程序准备要显示的数据,由FreeMarker模板生成页面。  FreeMarker可以作为Web应用框架一个组件,但它与容器无关,在非Web应用程序环境也能工作的很好。 FreeMarker适合作为MVC的视图组件,还能在模板中使用JSP标记库。

<html>
<head>
  <title>Welcome!</title>
</head>
<body>
  <h1>Welcome ${user}!</h1>
  <p>Our latest product:
  <a href="${latestProduct.url}">${latestProduct.name}</a>!
</body>
</html> 
上面的例子中,在简单的HTML中加入了一些由${…}包围的特定FreeMarker的指令,这个文件就称为模板了。而user、latestProduct.url和latestProduct.name来自于数据模型,由Java程序提供,模板设计者就不用关心数据从哪来的。

FreeMarker模板中可以包括下面四种特定部分:
一.) 文本:直接输出
二.) FTL标记(FreeMarker模板语言标记):类似于HTML标记,名字前加#(有些以@开始,用户自定义标记)予以区分,不会输出。
字符串- 使用单引号或双引号限定;如果包含特殊字符需要转义符:${"It's \"quoted\" andthis is a backslash: \\"}
有一类特殊的字符串:${r"C:\foo\bar"},输出结构为:C:\foo\bar,在引号前面加r被认为是纯文本。
数字-直接输入,不需要引号。${08}, ${+8}, ${8.00} and ${8} 都是相同的
布尔值-true和false,不使用引号
Sequences(序列)-由逗号分隔的变量列表,由方括号限定,类似java中的一维数组:

<#list ["winter", "spring", "summer", "autumn"] as x>
${x}
</#list>
输出结果:
winter
spring
summer
autumn

例二:[2 + 2, [1, 2, 3, 4], "whatnot"]
例三:2..5,等同于[2, 3, 4, 5];5..2,等同于[5,4,3,2]。注意方括号是不需要的。

Hashes(散列)-由逗号分隔的键-值列表,由大括号限定,键和值之间用冒号分隔:{"name":"green mouse", "price":150},键和值都是表达式,但是键必须是字符串。

获取变量-${variable},变量名只能是字母、数字、下划线、$、@和#的组合,且不能以数字开头。下列表达式是等价的:
book.author.name
book["author"].name
book.author.["name"]
book["author"]["name"]

获取Sequence(序列)片断-使用[startindex..endindex],例如:seq中存储了"a", "b", "c", "d","e",那么seq[1..2]包含了b和c两个值。

可以使用.variablename语法访问FreeMarker内置变量。

字符串操作
{"Hello ${user}!"} <==> ${"Hello " + user + "!"}
${"${user}${user}${user}${user}"} <==> ${user + user + user + user}

${…}只能在文本中使用,下面是错误的代码:
<#if ${isBig}>Wow!</#if>
<#if "${isBig}">Wow!</#if>  //此处的代码也是错误的,因为if指令需要的是boolean,实际的却是个字符串

子字符串的操作,假设user的值为"Big Joe":
${user[0]}${user[4]}  <==>  BJ
${user[1..4]}  <==> ig J

Sequences(序列)操作

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

Hashes(散列)操作

<#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 

算术运算

<#-- x的值设定为5 -->
${x * x - 100}
${x / 2}
${12 % 10}
结果:
-75
2.5
2

注意: 操作符两边必须是数字;使用"+"时,如果一边是数字,一边是字符串,就会自动将数字转换为字符串。

使用内建的指令int获得整数部分:

${(x/2)?int}
${1.1?int}
${1.999?int}
${-1.1?int}
${-1.999?int}
结果:
2
1
1
-1
-1

比较操作符-<#if expression>...</#if>
1.)使用=(或==,完全相等)测试两个值是否相等,使用!= 测试两个值是否不相等
2.)=和!=两边必须是相同类型的值,否则会产生错误,例如<#if 1 = "1">会引起错误
3.)Freemarker是精确比较,所以"x"、"x  "和"X"是不相等的
4.)对数字和日期可以使用<、<=、>和>=,但不能用于字符串
5.)由于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> 

内置函数-用法类似访问hash(散列)的子变量,只是使用"?"替代".",例如:user?upper_case
下面列出常用的一些函数:
对于字符串
html-对字符串进行HTML编码
cap_first-使字符串第一个字母大写
lower_case-将字符串转换成小写
trim-去掉字符串前后的空白字符
对于Sequences(序列)
size-获得序列中元素的数目
对于数字
int-取得数字的整数部分(如-1.9?int的结果是-1)

例一:

<#-- test的值为Tom & Jerry -->
${test?html}
${test?upper_case?html}
结果:
Tom &amp; Jerry
TOM &amp; JERRY

例二:

<#-- seasons的值为"winter", "spring", "summer", "autumn" -->
${seasons?size}
${seasons[1]?cap_first} <#-- left side can by any expression -->
${"horse"?cap_first} 
结果:
4
Spring
Horse 

方法的调用
${repeat("What", 3)}
${repeat(repeat("x", 2), 3) + repeat("What", 4)?upper_case}
结果:
WhatWhatWhat
xxxxxxWHATWHATWHATWHAT

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

三.) 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%

例二:

${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)

例三:

<#assign foo=true/>
${foo?string("yes", "no")}
结果:
yes

例四:

<#-- x is 2.582 and y is 4 -->
#{x; M2}   <#-- 2.58 -->
#{y; M2}   <#-- 4    -->
#{x; m1}   <#-- 2.6 -->
#{y; m1}   <#-- 4.0 -->
#{x; m1M2} <#-- 2.58 -->
#{y; m1M2} <#-- 4.0  --> 
说明:mX-小数部分最小X位;MX-小数部分最大X位。

四.) 注释:<#--和-->

下面是一个常用的模板例子:

<p>We have these animals:
<table border=1>
  <tr><th>Name<th>Price
  <#list animals as being>
  <tr>
    <td>
      <#if being.size = "large"><b></#if>
      ${being.name}
      <#if being.size="large"></b></#if>
    <td>${being.price} Euros
  </#list>
</table>
<#include "/copyright_footer.html">
注意点:
1.) FreeMarker是区分大小写的;
2.) FTL标记不能位于另一个FTL标记内部,例如:<#if <#include 'foo'>='bar'>...</if>;
3.) ${…}只能在文本中使用;
4.) 多余的空白字符会在模板输出时去除;
5.) 如果使用的指令不存在,会产生一个错误消息。

分享到:
评论
11 楼 jxzh3013 2012-07-31  
xiebiao110 写道
最近发现一个FreeMarker的一个问题,我在页面中用<#if Session.userid="">来判断session中的userid是否为空字符,但是如果你第一次单独打开这个页面的时候,会报Session没定义的错,但从网站的其他页面点到这个页面,就不会报错,好像是第一次访问这个页面的时候,没有初始session,不知道为什么????

对于""和null,freemarker都认为是空值,不存在的值,所以应该是你的判断问题
10 楼 wzt7576 2009-02-26  
想问一下,== 这是代表“完全相等”,什么是完全相等啊?
9 楼 qgz0910 2008-09-25  
xiebiao110 写道
最近发现一个FreeMarker的一个问题,我在页面中用<#if Session.userid="">来判断session中的userid是否为空字符,但是如果你第一次单独打开这个页面的时候,会报Session没定义的错,但从网站的其他页面点到这个页面,就不会报错,好像是第一次访问这个页面的时候,没有初始session,不知道为什么????

  <#if Session.userid=""> 直接<#if userid="">就OK 了 还有 请注意 所有的判断 首先判断是否为null 或者判断对象是否存在 然后才是判断他的值!
8 楼 mickeymak 2008-09-04  
我是用FreeMarker来做View层的显示的, 生成静态的HTML文件.

不过我有一个疑问, 是关于多线程并发的, 譬如有两个用户同时调用FreeMarker来生静态文件, 其中的某一个用户先获得对象锁进行静态文件生成的动作, 进行完后会自动redirect到该生成的静态文件. 但刚想转到该文件的时候, 另外一个用户获得了对象锁也进行静态文件的生成动作, 大家知道HTML的生成是流的操作, 生成的过程中是不能被调用显示的. 那么第一个用户不就返回一个"Page NOT Found"的异常了吗? 请问FreeMarker是怎样handle这些多线程并发的? 谢谢~~
7 楼 163 2008-08-15  
我将头部文件写在了一个*.lbi文件里面。在其他freemark文件中include进来
在lbi文件里面我写着:
[#if session.Userreg?exists]
hi,[@s.property value="%{#session.Userreg.userName}"/]您好
[#else]
<hi,游客您好
[/#if]


为什么输出时候把代码输出来了呢!并没有输出session中的值。是把我写的这段if什么的代码显示在页面上了呢?
6 楼 wufan0023 2008-05-23  
xiebiao110 写道
最近发现一个FreeMarker的一个问题,我在页面中用<#if Session.userid="">来判断session中的userid是否为空字符,但是如果你第一次单独打开这个页面的时候,会报Session没定义的错,但从网站的其他页面点到这个页面,就不会报错,好像是第一次访问这个页面的时候,没有初始session,不知道为什么????


可能是你的session对象是在其他位置定义的,如登陆时设置了session对象,而你这个页面又没有提前判断用户是否登陆,所以就会无法提示用户登陆,单独进入也就没有session。freemark恶心的一点也是好的一点就是有个啥变量没法传给他,他就跳出个恶心的黄色页面。
5 楼 grape927 2008-05-23  
其实我是刚学,还没领悟
4 楼 grape927 2008-05-23  
那确实,不是一般的
3 楼 xly_971223 2008-04-15  
最讨厌freemarker指令写法 <#if.....
还是velocity来的痛快#if
2 楼 mht19840918 2008-03-12  
首先感谢你留言,这个问题我以前也遇到过,最后没有别的办法就嵌套别的标签,
freemarker虽然有少量自己的标签,能完成最最基本的的功能,但是还是不能满足我们的需求,马上发布一个在freemarker中使用struts2标签的文章,希望对你有所帮助
1 楼 xiebiao110 2008-03-06  
最近发现一个FreeMarker的一个问题,我在页面中用<#if Session.userid="">来判断session中的userid是否为空字符,但是如果你第一次单独打开这个页面的时候,会报Session没定义的错,但从网站的其他页面点到这个页面,就不会报错,好像是第一次访问这个页面的时候,没有初始session,不知道为什么????

相关推荐

    freemarker学习资料汇总

    本压缩包集合了丰富的Freemarker学习资源,涵盖从基础到进阶的各种知识点,以下是这些文档中可能包含的详细内容: 1. **Freemarker中文手册.pdf**: 这份手册通常会详细介绍Freemarker的基本概念,如模板语言、...

    FreeMarker学习资料

    ### FreeMarker 学习资料详解 #### 一、FreeMarker 模板文件构成 FreeMarker 是一种用于生成动态文档的工具,它通过结合固定的文本、注释、变量(插值)以及指令(FTL标签)来创建动态内容。具体而言,FreeMarker ...

    freemarker学习

    Freemarker的核心思想是将数据模型与模板结合,通过模板来呈现准备好的数据。 在开始使用Freemarker之前,你需要先下载相关的jar包。你可以访问FreeMarker的官方网站...

    freemarker 学习

    综上,FreeMarker学习的内容广泛且深入,涵盖了模板语言的使用、配置、源码解析、最佳实践等多个方面。通过学习FreeMarker,开发者可以更好地控制和生成动态内容,提高代码的可读性和可维护性。

    freemarker学习例子

    这个“freemarker学习例子”应该包含了一些基础到进阶的Freemarker用法,帮助初学者快速上手。 在Freemarker中,主要涉及以下几个核心概念: 1. **模板(Templates)**:模板是Freemarker的核心,它是HTML或其他文本...

    freemarker学习资料

    在快速入门中,我们看到FreeMarker的基本工作原理是通过模板中的特定指令,如`${...}`,将动态数据插入到静态模板中。例如,以下模板展示了如何欢迎用户并显示最新产品的信息: ```html &lt;title&gt;Welcome! &lt;h1&gt;...

    Freemarker 学习笔记一 【乱码解决】

    这篇“Freemarker学习笔记一【乱码解决】”将指导我们如何解决这个问题。 首先,我们需要了解乱码的常见原因。在Java Web开发中,乱码通常与以下因素有关: 1. **文件编码**:Freemarker模板文件(.ftl)的编码...

    Freemarker学习笔记

    Freemarker学习笔记可以帮助初学者了解,快速掌握Freemarker

    FreeMarker 学习手册

    FreeMarker 学习手册 详细介绍FreeMarker模板技术的手册

    FreeMarker学习笔记

    ### FreeMarker 学习笔记知识点总结 #### 一、FreeMarker 概览 FreeMarker 是一个用 Java 编写的模板引擎,它可以帮助开发者快速生成 HTML 页面或其他格式的文档。其核心概念包括模板、数据模型以及如何将两者结合...

    FreeMarker学习资料整理

    下面,我们将深入探讨FreeMarker的基础知识、应用场景以及如何进行学习。 1. **基础概念** - **模板**:FreeMarker的核心是模板,它是由开发者编写的HTML或XML文件,其中嵌入了特定的FreeMarker语法,用于动态生成...

    FreeMarker学习代码小结

    在本篇文章中,我们将深入探讨FreeMarker的学习要点,包括其基本概念、语法以及实际应用。 一、基本概念 1. 模板(Template):FreeMarker的中心是模板文件,它是一种特殊的文本文件,包含固定文本和变量。变量是由...

    FreeMarker相关学习文档

    提供的"FreeMarker相关学习文档"可能包括模板语法详解、最佳实践、示例代码等内容,可以帮助初学者快速上手。通过阅读这些资料,你可以深入了解FreeMarker的各个方面,从而更好地利用这个强大的模板引擎。 总结,...

    Freemarker学习总结.pdf

    以下是对Freemarker中Sequence、Hash以及字符串操作函数的详细说明。 一、Sequence的内置函数: 1. `sequence?first`:返回Sequence的第一个元素,如果Sequence为空,返回null。 2. `sequence?last`:返回Sequence...

    Freemarker 学习总结

    以下是对 Freemarker 学习内容的详细总结: 一、Sequence 内置函数 1. `sequence?first`: 获取序列的第一个元素。 2. `sequence?last`: 获取序列的最后一个元素。 3. `sequence?reverse`: 反转序列中的元素顺序。 4...

Global site tag (gtag.js) - Google Analytics