FreeMarker2.3.18中文手册：模板与数据模型解析

"FreeMarker中文版文档1是针对FreeMarker 2.3.18版本的手册，由南磊翻译并遵循Creative Commons Attribution 3.0 Unported License。该文档旨在引导用户进行模板开发和程序开发，涵盖了FreeMarker的基础概念、数值与类型、模板结构、自定义指令以及数据模型等内容。" FreeMarker是一个开源的模板引擎，常用于Java应用中生成HTML或其他类型的文本输出。它是Spring框架中的一个组件，用于分离业务逻辑和视图呈现。 1. **简介** FreeMarker是一个声明式的模板语言，它与编程语言分离，使得开发者可以专注于设计模板，而不用关心具体输出的生成过程。FreeMarker的工作原理是结合模板和数据模型来生成输出。 2. **模板 + 数据模型 = 输出** 在FreeMarker中，模板是HTML或其他文本格式的文件，其中包含占位符（称为变量或指令），这些占位符在渲染时会被数据模型中的值替换。数据模型是一个包含了所有要展示数据的对象集合，可以是Java对象、Map、列表等。 3. **数据模型一览** 数据模型可以包含各种数据结构，如标量（字符串、数字等）、容器（列表、集合、数组）、地图（键值对）以及能够返回其他数据的Java方法。这些数据在模板中通过表达式访问。 4. **模板一览** 模板包括模板指令、表达式和插值等元素。指令用于控制流程、包含其他模板或执行特殊操作；表达式用于访问数据模型中的值；插值则允许在文本中嵌入表达式的值。 5. **数值和类型** FreeMarker支持多种数值类型，包括整数、浮点数和双精度数。数值运算遵循标准数学规则。同时，它也有自己的类型系统，包括字符串、布尔值、列表、映射等。 6. **模板结构** 模板通常有结构化的布局，如HTML的头部、主体和尾部。它们可以包含指令（如`#if`、`#foreach`）来控制逻辑流程，以及表达式来插入动态数据。 7. **自定义指令** 开发者可以定义自定义指令来扩展FreeMarker的功能，这些指令可以在模板中像内置指令一样使用，提供特定的应用场景逻辑。 8. **在模板中定义变量** 在模板内部，可以使用`<#assign>`指令来定义临时变量，这些变量只在当前模板作用域内有效。 9. **命名空间** 命名空间允许组织和导入多个模板库，以便重用和管理模板片段。 10. **空白处理** FreeMarker提供了控制输出中空白字符的方式，如是否删除空白行、是否压缩连续空白等。 11. **替换（方括号）语法** 除了 `${}` 之外，FreeMarker还支持方括号 `[]` 语法来安全地获取对象属性，即使对象为null也不会抛出异常。 12. **程序开发指南** 这部分内容指导开发者如何在Java应用中集成FreeMarker，包括创建配置实例、构建数据模型、加载模板、合并数据模型和模板以生成最终输出。 FreeMarker中文版文档1是一个全面的指南，覆盖了FreeMarker的基本概念和高级特性，对于理解和使用FreeMarker进行动态内容生成非常有帮助。