Freemarker快速参考指南：总结与示例解析

"这篇文档是关于Freemarker的详尽总结，旨在提供快速查询和学习的手册，适合初学者和经验丰富的开发者。Freemarker是一种常见的页面展现技术，用于Web项目开发。文档涵盖了Freemarker模板的基本组成部分，包括文本、注释、插值和FTL指令，并提供了实例来帮助理解。" 在Freemarker模板中，四个关键组成部分是： 1. **文本**：这是模板中直接输出到最终HTML页面的部分，不做任何处理。 2. **注释**：使用`<#---->`包围的文本不会出现在最终输出中，用于开发者注解。 3. **插值**：`${}`或`#{}`内的表达式会被数据模型中的对应值替换并输出。通用插值 `${expr}` 可以处理各种类型的值，而数字格式化插值 `#{expr;format}` 允许对数字进行特定格式化。 4. **FTL指令**：FreeMarker特有的指令，以`#`开头，如`<#list>`，用于控制模板逻辑。用户定义的指令前缀为`@`。 关于**FTL指令规则**： - FreeMarker的FTL标签类似于HTML标签，有开始、结束和空标签形式。 - 指令的正确嵌套很重要，错误使用会导致错误消息而非输出。 - 使用`@`代替`#`用于用户自定义指令。 - FTL标签内部的空白字符通常会被忽略，且`<`, `/`, 和指令之间不应有空白。 **插值规则**： - 通用插值 `${expr}`： - 字符串值会直接输出。 - 数字值会按照默认格式输出，也可以通过`#,##0.00`等模式进行格式化。 - `null`值会转为空字符串。 - 非字符串、非数字的表达式结果会尝试转换为字符串。 例如，模板中`<h1>Welcome ${user}!</h1>`会将`user`变量的值插入到欢迎消息中。 **插值的特殊情况**： - 如果表达式结果是`null`，则插值会显示为空字符串。 - 如果表达式抛出异常，Freemarker默认会输出一个错误消息，但可以通过配置改变这种行为。 这份文档提供了Freemarker的基础知识和实用技巧，帮助开发者高效地理解和使用Freemarker进行页面渲染，减少查阅官方文档的次数，提高开发效率。对于初学者，它是一个理想的入门指南；对于有经验的开发者，它可以作为日常开发的快速参考手册。