Java模板引擎Freemarker教程.docx

### Java模板引擎Freemarker教程知识点详解 #### 一、FreeMarker概述 FreeMarker是一个用于生成输出文本的模板引擎，其应用广泛，特别是在Java应用程序中作为视图层的一部分。它支持多种类型的输出文本，包括HTML、XML、JavaScript、邮件、CSV等。FreeMarker通过将数据模型与模板结合来生成输出文本。 #### 二、FreeMarker模板的基本组成部分 FreeMarker模板文件主要包括四个部分：文本、注释、插值和FTL指令。 1. **文本**：直接输出到最终文档的部分，如HTML标签、文本等。 2. **注释**：使用`<#-- ... -->`格式的注释，不会出现在最终输出中。 3. **插值**：使用`${...}`或`# {...}`格式，将数据模型中的变量替换为实际值输出。 4. **FTL指令**：FreeMarker指令，类似于HTML标签但以`<#...>`开头，用于控制模板的逻辑流程。 #### 三、FTL指令规则 1. **开始标签**：`<#directivename parameter>` 2. **结束标签**：`</#directivename>` 3. **空标签**：`<#directivename parameter/>` 这些标签用于定义FreeMarker指令的行为，如循环、条件判断等。当使用非内置指令时，可以使用`@`代替`#`。例如： ```html <#list animals as animal> <li>${animal.name}</li> </#list> ``` #### 四、插值规则 插值是指在模板中引用数据模型中的变量并将其值插入到最终输出中的过程。FreeMarker提供了两种类型的插值：通用插值和数字格式化插值。 1. **通用插值**：`${expr}` - **字符串值**：直接输出表达式结果。 - **数字值**：根据默认格式输出，也可以使用内置函数进行格式化。 - **日期值**：根据默认格式输出，同样支持格式化。 - **布尔值**：根据默认格式输出，支持自定义格式化。 例如，使用`#setting`指令设置数字格式，并展示不同类型的格式化输出： ```html <#set number_format="currency"/> <#assign answer=42/> ${answer} ${answer?string} ${answer?string.number} ${answer?string.currency} ${answer?string.percent} ``` 2. **数字格式化插值**：`#{expr;format}` - 支持特定的格式化选项，如小数位数的最大值（`MX`）和最小值（`mX`）。 例如： ```html <#assign x=2.582/> <#assign y=4/> #{x;M2} #{y;M2} #{x;m2} #{y;m2} #{x;m1M2} #{y;m1M2} ``` #### 五、表达式 FreeMarker支持丰富的表达式语法，用于计算和操作数据模型中的变量。这些表达式可以在插值中使用，也可以作为指令参数的一部分。 - 示例：`<#if user??>${user.name}<#else>Guest</#if>` 在这个例子中，`?`后跟的表达式用于检查变量是否存在且不为空，如果是，则输出用户的名称；否则输出“Guest”。 #### 六、总结 本教程涵盖了FreeMarker的基本使用方法，包括模板的基本结构、FTL指令的使用、插值的类型以及表达式的应用。通过这些知识，开发者能够更好地理解和运用FreeMarker来构建动态文本生成的应用程序。掌握这些基础知识将有助于提高开发效率，实现更复杂的模板逻辑处理。