freemarker教程资源-CSDN文库

需积分: 3 106 浏览量 2018-08-27 16:52:26 上传评论收藏 47KB DOCX 举报

FreeMarker的模板文件并不比HTML页面复杂多少,FreeMarker模板文件主要由如下4个部分组成: 1,文本:直接输出的部分 2,注释:<#-- ... -->格式部分,不会输出 3,插值:即${...}或#{...}格式的部分,将使用数据模型中的部分替代输出 4,FTL指令:FreeMarker指定,和HTML标记类似,名字前加#予以区分,不会输出 ### Freemarker教程详解 #### 一、Freemarker概述与组成部分 **Freemarker**是一种用于生成动态HTML页面的模板引擎。它通过定义模板文件来处理数据模型，并将其转化为最终的输出文档。Freemarker的模板文件并不比HTML页面复杂多少，主要由四个基本组成部分构成： 1. **文本**: 直接输出的部分。这部分内容不会被Freemarker解释，而是直接输出到最终生成的文档中。 2. **注释**: `<#-- ... -->` 格式部分，不会输出。注释内容仅供开发者参考，不会出现在最终的输出文档中。 3. **插值**: 即 `${...}` 或 `#{...}` 格式的部分，将使用数据模型中的内容替代输出。插值是Freemarker中最常用的功能之一，用于显示动态数据。 4. **FTL指令**: Freemarker指令，与HTML标记类似，名字前加`#`予以区分，不会输出。这些指令控制着模板的行为，如循环、条件判断等。 #### 二、示例模板分析下面通过一个简单的Freemarker模板例子来详细了解上述四个部分的应用： ```html <html> <head> <title>Welcome!</title> </head> <body> <#-- 注释部分 --> <#-- 下面使用插值 --> <h1>Welcome ${user}!</h1> <p>We have these animals:</p> <ul> <#-- 使用FTL指令 --> <#list animals as animal> <li>${animal.name} for ${animal.price} Euros</li> </#list> </ul> </body> </html> ``` - **文本**: `<html>`、`<head>`、`<title>`等HTML标签属于文本部分，它们将直接作为输出的一部分。 - **注释**: `<#-- 注释部分 -->` 属于注释部分，只供开发人员查看，不参与输出。 - **插值**: `${user}` 和 `${animal.name}`、`${animal.price}` 属于插值部分，表示使用数据模型中的变量值来替换输出。 - **FTL指令**: `<#list animals as animal>` 是一个典型的FTL指令，用于遍历`animals`列表，并为每个元素执行一次`<li>`标签内的代码。 #### 三、FTL指令规则在Freemarker中，使用FTL标签来使用指令，主要有三种类型的FTL标签： 1. **开始标签**: `<#directiveName parameter>` 2. **结束标签**: `</#directiveName>` 3. **空标签**: `<#directiveName parameter/>` - 实际上，在使用标签时前面的符号`#`也可能会变成`@`，如果该指令是一个用户自定义指令而不是系统内置指令时，应将`#`符号改成`@`符号。 - 在使用FTL标签时，应该有正确的嵌套，而不是交叉使用，这一点类似于XML标签的用法。 - 如果全用不存在的指令，Freemarker不会使用模板输出，而是产生一个错误消息。 - Freemarker会忽略FTL标签中的空白字符。值得注意的是`<`, `/` 和指令之间不允许有空白字符。 #### 四、插值规则 Freemarker的插值有两种类型：通用插值 `${expr}` 和数字格式化插值 `#{expr;format}`。 1. **通用插值**: - 插值结果为字符串值: 直接输出表达式结果。 - 插值结果为数字值: 根据默认格式（由`#setting`指令设置）将表达式结果转换成文本输出。可以使用内建的字符串函数格式化单个插值。 - 插值结果为日期值: 根据默认格式（由`#setting`指令设置）将表达式结果转换成文本输出。同样可以使用内建的字符串函数格式化单个插值。 - 插值结果为布尔值: 根据默认格式（由`#setting`指令设置）将表达式结果转换成文本输出。可以使用内建的字符串函数格式化单个插值。 2. **数字格式化插值**: - 数字格式化插值可采用`#{expr;format}`形式来格式化数字，其中`format`可以是： - `mX`: 小数部分最小X位 - `MX`: 小数部分最大X位例如： ```html <#assign x = 2.582/> <#assign y = 4/> #{x;M2}<#-- 输出2.58 --> #{y;M2}<#-- 输出4 --> #{x;m2}<#-- 输出2.6 --> #{y;m2}<#-- 输出4.0 --> #{x;m1M2}<#-- 输出2.58 --> #{y;m1M2}<#-- 输出4.0 --> ``` #### 五、总结 Freemarker作为一种强大的模板引擎，其核心功能在于通过定义模板文件来处理数据模型，并将其转化为最终的输出文档。通过理解Freemarker的组成部分（文本、注释、插值、FTL指令）及其规则（FTL指令规则、插值规则），我们可以更灵活地应用Freemarker来生成动态内容。无论是简单的HTML页面还是复杂的业务报表，Freemarker都能提供强大的支持。

资源推荐

资源详情

资源评论

 的模板文件并不比  页面复杂多少 模板文件主要由如下  个部

分组成

文本直接输出的部分

注释格式部分不会输出

插值即或格式的部分将使用数据模型中的部分替代输出

 指令 指定和  标记类似名字前加予以区分不会输出

下面是一个  模板的例子包含了以上所说的  个部分





 !"#$

$

"%

注释部分 

下面使用插值 

 !"&'#$

( )'*+'

&

使用  指令 

+'*+''+*,

++*,*-"+*,(+!.&"'

+'

&

$"%

$

 指令规则

在  中使用  标签来使用指令 有  种  标签这和  标签是完

全类似的

开始标签+!)*(

结束标签$+!)*

空标签+!)*($

实际上使用标签时前面的符号也可能变成/如果该指令是一个用户指令而不是系统内建

指令时应将符号改成/符号

使用  标签时应该有正确的嵌套而不是交叉使用这和 0 标签的用法完全一样如果全

用不存在的指令 不会使用模板输出而是产生一个错误消息 会忽略

 标签中的空白字符值得注意的是$和指令之间不允许有空白字符

插值规则

 的插值有如下两种类型  通用插值 1(2 数字格式化插值 1( 或

1(2-"

通用插值

对于通用插值又可以分为以下  种情况

插值结果为字符串值直接输出表达式结果

插值结果为数字值根据默认格式3由'4*, 指令设置5将表达式结果转换成文本输出可以

使用内建的字符串函数格式化单个插值如下面的例子

'4"**&6-"78!&*!%8$

''+,**'97$

*'9

*'9:'+*,''*'9

*'9:'+*,*&

*'9:'+*,!&*!%

*'9:'+*,(!*

*'9

输出结果是

;;



;;

;;<

插值结果为日期值根据默认格式3由'4*, 指令设置5将表达式结果转换成文本输出可以

使用内建的字符串函数格式化单个插值如下面的例子

'=(:'+*,38%%%%''>>>>85

'=(:'+*,38...??%%85

'=(:'+*,38....%%%%''?3?>>>?5?85

输出结果是

;;@;;@;@;@;@A!+B!C%+,+

&D(@?;

&'%D(+;@;;;@;@;@A3AC5

插值结果为布尔值根据默认格式3由'4*, 指令设置5将表达式结果转换成文本输出可以

使用内建的字符串函数格式化单个插值如下面的例子

''+,*-""7&$

-"":'+*,38%'88*"85

输出结果是

%'

数字格式化插值

数字格式化插值可采用1(2-"形式来格式化数字其中 -" 可以是

0小数部分最小 0 位

0小数部分最大 0 位

如下面的例子

''+,*17E@$

如果某段文本中包含大量的特殊符号 提供了另一种特殊格式可以在指定字符串

内容的引号前增加  标记在  标记后的文件将会直接输出看如下代码

8-""8

8GH-""H8

输出结果是

-""

GH-""H

数值

表达式中的数值直接输出不需要引号小数点使用88分隔不能使用分组88符号

目前还不支持科学计数法所以8.8是错误的在  表达式中使用数值需要注意以

下几点

数值不能省略小数点前面的 ;所以8E8是错误的写法

数值 @L@@;; 都是相同的

布尔值

直接使用 & 和 -'不使用引号

集合

集合以方括号包括各集合元素之间以英文逗号88分隔看如下的例子

+'M8星期一88星期二88星期三88星期四88星期五88星期六88星期天8N'1

1

$+'

输出结果是

星期一

星期二

星期三

星期四

星期五

星期六

星期天

除此之外集合元素也可以是表达式例子如下

MLMN89*"8N

还可以使用数字范围定义数字集合如 E 等同于MEN但是更有效率注意使用数字范

围来定义集合时无需使用方括号数字范围也支持反递增的数字范围如 E

E( 对象

( 对象使用花括号包括( 中的 %)& 对之间以英文冒号88分隔多组 %)& 对之

间以英文逗号88分隔下面是一个例子

8语文8I@8数学8@;

( 对象的 % 和 )& 都是表达式但是 % 必须是字符串

输出变量值

 的表达式输出变量时这些变量可以是顶层变量也可以是 ( 对象中的变量还

可以是集合中的变量并可以使用点35语法来访问 O) 对象的属性下面分别讨论这些情况

顶层变量

所谓顶层变量就是直接放在数据模型中的值例如有如下数据模型

(""7*9'(352$$创建数据模型

""(&38*88**852$$* 是一个顶层变量

对于顶层变量直接使用)+P来输出变量值变量名只能是字母数字下划线/

和的组合且不能以数字开头号为了输出上面的 * 的值可以使用如下语法

*

输出集合元素

如果需要输出集合元素则可以根据集合元素的索引来输出集合元素集合元素的索引以方括

号指定假设有索引

M8星期一88星期二88星期三88星期四88星期五88星期六88星期天8N该索引名为 9如果

需要输出星期三则可以使用如下语法

9MN$$输出第三个集合元素

此外 还支持返回集合的子集合如果需要返回集合的子集合则可以使用如下语

法

9MEN$$返回 9 集合的子集合子集合中的元素是 9 集合中的第 F 个元素

输出 ( 元素

这里的 ( 对象可以是直接 '( 的实例甚至包括 O)Q* 实例对于 O)Q* 实例而

言我们一样可以把其当成属性为 %属性值为 )& 的 ( 实例为了输出 ( 元素的值

可以使用点语法或方括号语法假如有下面的数据模型

(""7*9'(352

Q""""7*9Q""352

D&"&"7*9D&"352

&"'P38**852

&"'D''38,>852

""'P38'&'852

""'D&"3&"52

""(&38+*-"88'&'852

""(&38""8""52

为了访问数据模型中名为 '&' 的书的作者的名字可以使用如下语法

""&"*$$全部使用点语法

""M8&"8N*

""&"M8*8N$$混合使用点语法和方括号语法

""M8&"8NM8*8N$$全部使用方括号语法

剩余30页未读，继续阅读

评论收藏

内容反馈

xghanyu6698

粉丝: 2
资源: 3

freemarker教程

freemarker

Freemarker教程(中文版)

FreeMarker教程pdf版

freemarker\Freemarker教程_中文版

Freemarker教程及jar包

Freemarker教程_中文版

FreeMarker教程中文版

Freemarker 教程

FreeMarker教程

Freemarker教程 中文版

Freemarker教程_中文版.pdf

Freemarker教程+中文版

Java生成word文档Freemarker教程

Java模板引擎Freemarker教程.docx

最新资源

Freemarker教程中文版