FreeMarker 2.3.10 程序员指南：快速入门与核心概念

"FreeMarker快速入门教程，包括创建配置实例、构建数据模型、获取和合并模版等内容，适合初学者学习。" FreeMarker是一个流行的Java模板引擎，常用于Web开发中生成动态HTML或其他文本格式的文件。这个快速入门指南旨在帮助开发者快速掌握FreeMarker的基本用法。 ### 一、快速入门 1. 创建配置实例 在使用FreeMarker时，首先要创建一个`Configuration`对象，它是FreeMarker的核心组件，用于存储应用级别的配置信息。你可以通过这个对象来设定FreeMarker的行为，例如模板的加载路径和默认字符编码。创建配置实例的示例代码如下： ```java Configuration cfg = new Configuration(Configuration.VERSION_2_3_30); cfg.setDirectoryForTemplateLoading(new File("/path/to/templates")); ``` 2. 创建数据模型（DataModel） 数据模型是FreeMarker模板用来访问应用程序数据的对象。它可以是简单的Java对象、集合、Map或者其他复杂结构。例如，你可以将一个HashMap作为数据模型传递给FreeMarker： ```java Map<String, Object> dataModel = new HashMap<>(); dataModel.put("name", "John Doe"); dataModel.put("age", 30); ``` 3. 获取模版（Template） 使用配置实例，你可以加载并获取模板文件，如下所示： ```java Template template = cfg.getTemplate("template.ftl"); ``` 4. 把模版与数据模型合并 将数据模型与模板合并，生成最终的输出字符串： ```java StringWriter result = new StringWriter(); template.process(dataModel, result); String output = result.toString(); ``` ### 二、数据模型（DataModel） FreeMarker支持多种数据类型： - 基础类型：如String、Number、Boolean等。 - Scalar类型：单个值对应的DataModel，比如字符串、数字。 - 容器类型：List、Set、Map等可以包含多个元素的数据结构。 - 方法变量：允许调用Java对象的方法。 - 转换器变量：用于将对象转换成特定格式。 - 节点变量：处理XML或DOM节点。 - 对象包裹：FreeMarker提供了自动将Java对象包装成DataModel的能力。 ### 三、配置（Configuration） 配置对象允许你设置FreeMarker的全局属性，如： - 基础：设置版本、模板加载策略等。 - 共享变量：定义全局变量，可在所有模板中使用。 - 配置参数：如模板缓存大小、默认编码等。 - 加载模板：指定模板的加载源，如文件系统、类路径等。 - 异常处理：设置错误处理策略，如是否显示错误信息。 ### 四、其它说明 - 变量：FreeMarker模板中的变量表达式，如`${name}`。 - 字符编码：可以设置模板的读取和输出编码。 - 多线程：FreeMarker是线程安全的，可以在多线程环境中使用。 - Bean包裹：FreeMarker可以自动将Java Bean的属性映射到模板变量。 通过这个快速入门，你可以开始编写和理解FreeMarker模板，但要深入掌握FreeMarker，还需要阅读更详细的文档，如官方的Programmer's Guide和Reference。这个教程的翻译者魔冰提供了一种理解和实践FreeMarker的良好起点，帮助读者理解其工作原理，并与其他模板引擎进行比较。如果你在学习过程中遇到问题，可以通过邮件与他交流。