论坛首页 → Java企业应用论坛 →

FreeMarker学习

浏览 20214 次
锁定老帖子 主题：FreeMarker学习
精华帖 (0) :: 良好帖 (3) :: 新手帖 (0) :: 隐藏帖 (0)
作者 正文
  • mht19840918
  • 等级: 初级会员
  • 性别:
  • 文章: 24
  • 积分: 30
  • 来自: 上海
   发表时间：2008-02-26  
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.) 如果使用的指令不存在，会产生一个错误消息。

返回顶楼
         
  • xiebiao110
  • 等级: 初级会员
  • 性别:
  • 文章: 149
  • 积分: 30
  • 来自: 深圳
   发表时间：2008-03-06  
最近发现一个FreeMarker的一个问题，我在页面中用<#if Session.userid="">来判断session中的userid是否为空字符，但是如果你第一次单独打开这个页面的时候，会报Session没定义的错，但从网站的其他页面点到这个页面，就不会报错，好像是第一次访问这个页面的时候，没有初始session,不知道为什么？？？？
返回顶楼
          回帖地址
0 请登录后投票
  • mht19840918
  • 等级: 初级会员
  • 性别:
  • 文章: 24
  • 积分: 30
  • 来自: 上海
   发表时间：2008-03-12  
首先感谢你留言，这个问题我以前也遇到过，最后没有别的办法就嵌套别的标签，
freemarker虽然有少量自己的标签，能完成最最基本的的功能，但是还是不能满足我们的需求，马上发布一个在freemarker中使用struts2标签的文章，希望对你有所帮助
返回顶楼
          回帖地址
0 请登录后投票
  • xly_971223
  • 等级: 五星会员
  • 性别:
  • 文章: 1202
  • 积分: 640
  • 来自: 北京
   发表时间：2008-04-15  
最讨厌freemarker指令写法 <#if.....
还是velocity来的痛快#if
返回顶楼
          回帖地址
0 请登录后投票
  • wufan0023
  • 等级: 初级会员
  • 性别:
  • 文章: 23
  • 积分: 30
  • 来自: hefei
   发表时间：2008-05-23  
xiebiao110 写道
最近发现一个FreeMarker的一个问题，我在页面中用<#if Session.userid="">来判断session中的userid是否为空字符，但是如果你第一次单独打开这个页面的时候，会报Session没定义的错，但从网站的其他页面点到这个页面，就不会报错，好像是第一次访问这个页面的时候，没有初始session,不知道为什么？？？？


可能是你的session对象是在其他位置定义的，如登陆时设置了session对象，而你这个页面又没有提前判断用户是否登陆，所以就会无法提示用户登陆，单独进入也就没有session。freemark恶心的一点也是好的一点就是有个啥变量没法传给他，他就跳出个恶心的黄色页面。
返回顶楼
          回帖地址
0 请登录后投票
  • 163
  • 等级: 初级会员
  • 性别:
  • 文章: 3
  • 积分: 30
   发表时间：2008-08-15  
我将头部文件写在了一个*.lbi文件里面。在其他freemark文件中include进来
在lbi文件里面我写着：
[#if session.Userreg?exists]
hi,[@s.property value="%{#session.Userreg.userName}"/]您好
[#else]
<hi,游客您好
[/#if]


为什么输出时候把代码输出来了呢！并没有输出session中的值。是把我写的这段if什么的代码显示在页面上了呢？
返回顶楼
          回帖地址
1 请登录后投票
  • mickeymak
  • 等级: 初级会员
  • 性别:
  • 文章: 6
  • 积分: 40
  • 来自: 广州
   发表时间：2008-09-04  
我是用FreeMarker来做View层的显示的, 生成静态的HTML文件.

不过我有一个疑问, 是关于多线程并发的, 譬如有两个用户同时调用FreeMarker来生静态文件, 其中的某一个用户先获得对象锁进行静态文件生成的动作, 进行完后会自动redirect到该生成的静态文件. 但刚想转到该文件的时候, 另外一个用户获得了对象锁也进行静态文件的生成动作, 大家知道HTML的生成是流的操作, 生成的过程中是不能被调用显示的. 那么第一个用户不就返回一个"Page NOT Found"的异常了吗? 请问FreeMarker是怎样handle这些多线程并发的? 谢谢~~
返回顶楼
          回帖地址
0 请登录后投票
  • qgz0910
  • 等级: 初级会员
  • 性别:
  • 文章: 2
  • 积分: 30
  • 来自: 佛山
   发表时间：2008-09-25  
xiebiao110 写道
最近发现一个FreeMarker的一个问题，我在页面中用<#if Session.userid="">来判断session中的userid是否为空字符，但是如果你第一次单独打开这个页面的时候，会报Session没定义的错，但从网站的其他页面点到这个页面，就不会报错，好像是第一次访问这个页面的时候，没有初始session,不知道为什么？？？？

  <#if Session.userid=""> 直接<#if userid="">就OK 了 还有 请注意 所有的判断 首先判断是否为null 或者判断对象是否存在 然后才是判断他的值!
返回顶楼
          回帖地址
0 请登录后投票
  • wzt7576
  • 等级: 初级会员
  • 性别:
  • 文章: 15
  • 积分: 0
  • 来自: 济南
   发表时间：2009-02-26  
想问一下，== 这是代表“完全相等”，什么是完全相等啊？
返回顶楼
          回帖地址
0 请登录后投票
论坛首页 → Java企业应用版

跳转论坛:
Global site tag (gtag.js) - Google Analytics