Freemarker全攻略：HTML模板与指令详解

Freemarker教程全面讲解 FreeMarker是一种强大的模板引擎，用于在Java应用程序中动态生成HTML、XML等文档。本文将深入介绍FreeMarker的关键概念、语法和用法，帮助你更好地理解和掌握这个工具。 1. **环境设置**: Freemarker需要在Java环境中运行，通常通过Maven或Gradle等构建工具集成。首先确保你的项目配置了FreeMarker的相关依赖，并在项目中设置了正确的路径以便访问模板文件。 2. **基础语法**: - **变量表达式**: `${}`和`#{}`是FreeMarker的主要变量引用方式。`${expr}`用于文本替换，而`#{expr}`则提供了更多的格式化选项，如字符串格式化（`#{expr;format}`）、货币格式（`#{expr?string.currency}`）等。 - **指令** (`<#--`和`-->`)：用于注释，区分模板中的HTML元素和FreeMarker代码，使得模板更易于阅读。 3. **控制结构**: - `for`循环：`<#list animals as being>`用于遍历集合，显示每个元素的信息。`being.name`和`being.price`分别表示当前迭代项的属性。 - `if`和`else if`语句：可以根据条件执行不同的代码块。 4. **FTL指令**: - `<#directivename parameter>`和`<#directivename>`是FreeMarker的内置指令，如`<#assign answer=42>`用于变量赋值，`<#if expr>`用于条件判断。FreeMarker指令可以接受参数并执行特定的操作。 - `直接引用` (直接写变量名) 和 `间接引用` (`${}`) 之间的区别在于，前者不需要检查变量是否存在，后者会抛出异常。 5. **数据类型转换**: Freemarker支持多种数据类型转换，例如字符串格式化函数`?string`，可以根据需要将数字转换为货币、百分比等格式。 6. **自定义设置**: 通过`<#set>`指令可以创建和修改FreeMarker的全局设置，如`number_format`变量影响数字的格式输出。 7. **输出安全与异常处理**: 当使用 FreeMarker 时，注意避免XSS攻击，确保输入的数据在输出到HTML之前进行适当的清理和转义。同时，对于未定义的变量使用`?default`操作符来提供默认值，防止因变量未赋值导致的运行时错误。 这篇全面的FreeMarker教程介绍了从基本语法到高级特性的各个方面，包括变量、控制结构、指令以及如何处理数据和安全问题。熟练掌握这些知识将有助于你在实际开发中高效地使用FreeMarker生成动态内容。