FreeMarker入门到实践：配置与模板引擎解析

"这篇自学笔记主要介绍了FreeMarker模板引擎的核心概念和使用方法，包括Configuration类的设置、模板加载、数据模型的构建以及FreeMarker中的容器类型。" 在FreeMarker中，`Configuration`类是核心入口，它管理着FreeMarker的配置参数、模板加载和缓存。在上述代码示例中，`Configuration`实例被创建并设置了默认编码为UTF-8，同时指定了模板文件的根目录为`WEB-INF/templates`。这个根目录是FreeMarker寻找模板文件的起点。 FreeMarker的工作流程主要包括三个步骤： 1. **获取模板**：根据配置找到对应的模板文件。 2. **创建数据模型（DataModel）**：将Java对象转换为FreeMarker可识别的`TemplateModel`对象，通常我们可以使用Java的基本类型或集合对象。 3. **整合模板与数据模型**：FreeMarker会将数据模型绑定到模板上，进行渲染生成最终的输出。 FreeMarker支持四种基本标量类型，它们对应不同的`TemplateTypeModel`接口实现： - **TemplateBooleanModel**：表示布尔值。 - **TemplateNumberModel**：表示数字。 - **TemplateDateModel**：表示日期。 - **TemplateScalarModel**：表示字符串。 这些接口提供了将Java类型转换为FreeMarker内部处理的方式，如`getAsBoolean()`用于获取布尔值。 FreeMarker中的容器类型允许组织和存储数据： 1. **哈希表（Hash）**：通过键值对存储数据，实现`TemplateHashModel`接口。`TemplateHashModelEx`接口提供更高级的功能，例如访问键的集合。 2. **序列（Sequence）**：类似于数组，实现`TemplateSequenceModel`接口，允许按索引访问元素。 3. **集合（Collection）**：包含多个元素，实现`TemplateCollectionModel`接口，可以迭代其元素。 在实际应用中，我们可以通过实现这些接口或使用预定义的简单类型（如`SimpleHash`、`SimpleList`和`SimpleScalar`）来创建自定义的数据模型，以便于FreeMarker引擎渲染模板时使用。 总结来说，FreeMarker是一个强大的模板引擎，它通过`Configuration`类管理和配置模板，使用`TemplateModel`接口家族将Java对象映射到模板语言，提供哈希表、序列和集合等容器类型以灵活地组织数据。理解和掌握这些核心概念是高效使用FreeMarker的关键。