`
563525042
  • 浏览: 49625 次
  • 性别: Icon_minigender_1
  • 来自: 厦门
社区版块
存档分类
最新评论

FreeMarker标签学习

freemarkerhtmljavajsp 
阅读更多
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 & Jerry
TOM & 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>
<＃i nclude "/copyright_footer.html">
注意点：
1.) FreeMarker是区分大小写的；
2.) FTL标记不能位于另一个FTL标记内部，例如：<#if <＃i nclude 'foo'>='bar'>...</if>；
3.) ${…}只能在文本中使用；
4.) 多余的空白字符会在模板输出时去除；
分享到：
| 模板引擎FreeMarker
评论
发表评论

您还没有登录,请您登录后再发表评论

相关推荐

    Freemarker 自定义标签 简单案例

    通过分析这个示例，我们可以学习如何在实际项目中应用自定义标签，以提高模板的可维护性和复用性。 总的来说，理解并掌握Freemarker的自定义标签，不仅可以使模板设计更加灵活，还能帮助我们更好地组织和管理视图层...

    FreeMarker相关学习文档

    4. 国际化支持：通过使用`&lt;#t&gt;`标签，FreeMarker可以轻松实现多语言环境下的文本处理。 三、FreeMarker的常用语法 1. 输出表达式：`${expression}`，用于输出数据模型中的值。 2. 条件语句：`&lt;#if&gt;...&lt;#else&gt;......

    freemarker及jeecms标签使用学习文档

    这篇学习文档将带你深入理解Freemarker的基础知识和高级特性，并通过Jeecms模板标签的使用，让你更好地掌握实际开发中的应用。 1. **Freemarker基础** - **模板语言**：Freemarker使用简单的文本模板语言，将数据...

    freemarker中文学习资料

    这个“freemarker中文学习资料”压缩包提供了详尽的网页版API文档，对于想要深入理解和掌握Freemarker的开发者来说，是一份非常宝贵的资源。 1. **Freemarker基础概念** - **模板语言**：Freemarker使用一种简单的...

    spring mvc freemarker 自定义标签

    在Spring MVC框架中，Freemarker是一个常用的模板引擎，它允许开发者使用简洁的模板语言来动态生成HTML或者其他...在学习和实践中，你应该尝试创建自己的自定义标签，理解它们的工作原理，以便在实际项目中灵活运用。

    freemarker的学习资料、架包、源码

    6. **自定义函数和标签库**：扩展FreeMarker的功能，创建可复用的宏和自定义指令。 在深入学习FreeMarker的同时，阅读官方文档、参考书籍和在线教程是非常有益的。提供的压缩包文件可能包含了FreeMarker的API文档、...

    FreeMarker学习资料

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

    freemarker学习例子

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

    freemarker语法完整版

    - 尽量使用Freemarker自带的标签以提高性能。 **10. 特殊指令** - `r` 原样输出。 - `?` 引出内置指令。 - `@` 用户自定义标签。 **11. 特殊操作符** - `!`: 默认值操作符。 - `??`: 缺失值测试操作符。 **...

    freemarker文档学习

    3. **Freemarker标签** - **内置函数**：如`?html`用于转义HTML实体，`?string`将对象转换为字符串。 - **自定义标签**：开发者可以根据需要创建自己的宏或标签库，增强模板功能。 4. **Freemarker与其他工具的...

    velocity和freemarker的比较

    - **学习曲线**：Velocity的学习曲线较平缓，适合初学者，而FreeMarker可能需要更多时间去熟悉其高级特性。 - **灵活性**：FreeMarker的灵活性更强，可以更好地处理复杂逻辑，而Velocity更强调模板的纯粹性，尽量...

    struts2+freemarker

    5. **自定义标签库**：Struts2支持自定义标签，结合Freemarker的模板，可以创建出易于理解和维护的视图层代码。 6. **错误和异常处理**：Struts2提供了一套完善的异常处理机制，可以在发生错误时跳转到特定的错误...

    freemarker语法

    FreeMarker是一种模板引擎，用于生成文本输出，比如网页、源代码等。...在学习FreeMarker模板语法时，需要注意标签的正确使用、插值的类型和应用场景，以及如何通过设置和函数来控制数据的格式化输出。

    freemarker 学习

    这篇博客文章可能深入探讨了FreeMarker的学习过程，虽然具体内容无法直接获取，但从标题和标签我们可以推测出一些关键知识点。 1. **模板引擎原理**： FreeMarker的工作原理是，它接收数据模型（通常是Java对象）...

    FreeMarker

    FreeMarker详解，内包括freemarker教程_中文版、freemarker中文参考手册、FreeMarker标签使用、freemarker学习文档、freemarker根据模版生成文件使用例子 等文档

    学习Freemarker简介及标签详解大全.pdf

    FreeMarker是一个强大的、开源的模板引擎，主要用于生成文本输出，尤其是HTML Web页面。...通过熟练掌握其标签和指令，开发者可以构建出高效、可维护的视图层，从而提升Web应用的整体性能和用户体验。

    freemarker 2.3.10架包

    4. **国际化与本地化**：Freemarker支持多语言环境，通过`&lt;#t&gt;`指令和`&lt;#lt&gt;`标签，可以轻松实现国际化和本地化的文本输出。 5. **宏和导入**：宏类似于函数，可以复用代码段。`&lt;#macro&gt;`定义宏，`&lt;#import&gt;`或`...

    Freemarker分页

    4. **Freemarker模板**：在Freemarker模板中，你可以使用Struts2提供的`&lt;s:iterator&gt;`标签遍历当前页的数据，同时使用自定义的Freemarker宏或Struts2的`&lt;s:url&gt;`标签生成分页链接。例如，可以创建一个`pagination....

    MyEclipse freemarker插件

    2. **代码提示**：在编写Freemarker模板时，插件会提供智能代码补全功能，帮助开发者快速输入常见的Freemarker标签和指令，提高开发速度。 3. **错误检查**：实时语法检查是这款插件的一大亮点。它能在编写过程中...

Magicbox
Global site tag (gtag.js) - Google Analytics