FreeMarker模板语言详解与使用指南
需积分: 9 130 浏览量
更新于2024-09-12
收藏 35KB DOC 举报
"FreeMarker是一个开源的Java模板引擎，用于生成动态HTML、XML或其他格式的文本。它与Java代码分离，允许开发者通过定义数据模型来填充模板，生成所需的输出。FreeMarker的使用主要包括模板文件的四个组成部分：文本、注释、插值和FTL指令。在模板中，插值用于替换数据模型中的值，而FTL指令则控制模板的逻辑流程。"
FreeMarker模板文件的主要结构：
1. **文本**：这是模板中直接输出的部分，不进行任何处理。
2. **注释**：以`<#---->`形式存在，这些内容在生成最终输出时不显示。
3. **插值**：有两种形式 `${expr}` 和 `#{expr}`。前者是通用插值，后者用于数字格式化。插值可以是字符串、数字或日期类型。例如：
- 字符串值：直接输出表达式结果。
- 数字值：根据预设格式转换并输出，可以使用`#setting`指令设置默认格式，也可以用内建函数进行格式化，如货币、百分比等。
- 日期值：同样依据默认格式转换，可以自定义多种格式输出，包括时间区域。
4. **FTL指令**：FreeMarker的控制结构，如 `<#if>`、`<#foreach>`、`<#assign>` 等，它们类似于HTML标签，但以`#`开头。有些用户自定义指令使用`@`符号。
FreeMarker的FTL指令分为三种：
- **开始标签**：`<#directivename parameters>`
- **结束标签**：`</#directivename>`
- **空标签**：`<#directivename parameters/>`
指令`#setting`用于全局配置，例如设置日期和数字的默认格式。`#assign`用于在模板范围内创建变量。`#if`和`#else`用于条件判断，`#foreach`用于循环遍历集合。
举例说明，以下是一段简单的FreeMarker模板示例：
```html
<html>
<head>
<title>${pageTitle}</title>
</head>
<body>
<h1>Welcome, ${user.name}!</h1>
<#list products as product>
<p>Product: ${product.name}, Price: ${product.price?string.currency}</p>
</#list>
</body>
</html>
```
在这个例子中，`${pageTitle}`和`${user.name}`是插值，`#list`是FTL指令，用于遍历`products`集合。
FreeMarker的优势在于其简洁的语法和与业务逻辑的分离，使得模板易于维护，同时提高了开发效率。开发者只需要关注数据模型的构建，而视图的呈现则由FreeMarker自动处理。这在Web应用开发中尤其有用，因为它使开发者能够专注于后端逻辑，而设计师可以专注于页面布局。
一、FreeMarker 模板文件主要有 4 个部分组成
1、文本，直接输出的部分
2、注释，即<#--...-->格式不会输出
3、插值（Interpolation）：即 ${..}或者#{..}格式的部分,将使用数据模型中的部分替代输
出
4、FTL 指令：FreeMarker 指令，和 HTML 标记类似，名字前加#予以区分，不会输出。
FTL 指令规则
FreeMarker 有三种 FTL 标签，这和 HTML 的标签是完全类似的
开始标签：<#directivename parameters>
结束标签：</#directivename>
空标签： <#directivename parameters />
实际上，使用标签时前面的#符号也可能变成@，如果该指令是一个用户指令而不是系
统内建指令时，应将#符号改为@符号
插值规则
FreeMarker 的插值有如下两种类型
1、通用插值：${expr}
2、数字格式化插值：#{expr}或者#{expr;format}
通用插值，有可以分为四种情况
a、插值结果为字符串值：直接输出表达式结果
b、插值结果为数字值：根据默认格式(#setting 指令设置)将表达式结果转换成文本输出
可以使用内建的字符串函数格式单个插值，例如
<#setting number_format = "currency" />
<#assign price = 42 />
${price}
${price?string}
${price?string.number}
${price?string.currency}
${price?string.percent}
c、输出值为日期值：根据默认格式(由 #setting 指令设置)将表达式结果转换成文本输出，
可以使用内建的字符串函数格式化单个插值，例如
<#assign lastUpdated = "2009-01-07 15:05"?datetime("yyyy-MM-dd HH:mm") />
${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')'")};
${lastUpdated?string.short};
${lastUpdated?string.long};
${lastUpdated?String.full};
d、插值结果为布尔值
<#assign foo=true />
${foo?string("是 foo","非 foo")}
下载后可阅读完整内容，剩余6页未读，立即下载
点击了解资源详情
点击了解资源详情
点击了解资源详情
点击了解资源详情
点击了解资源详情
2024-12-27 上传
2024-12-27 上传
2024-12-27 上传
ligang626
- 粉丝: 0
- 资源: 3
我的内容管理
展开
