FreeMarker模板语言详解与使用指南

需积分: 9 103 浏览量更新于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页未读，立即下载

ligang626

粉丝: 0
资源: 3

FreeMarker模板语言详解与使用指南

freemarker 自定义freeMarker标签

eclipse的freemarker插件

FREEMARKER

freemarker

Freemarker

freeMarker

基于vue的社区互助平台--论文.zip

分布式系统中ZooKeeper入门与实战初探

高分毕业设计基于XGBoost的O2O优惠券使用预测分析系统设计与实现源码+详细文档说明

高分springboot毕设+vue高校学生求职就业平台-Java源码.zip

最新资源