FreeMarker 2.3.10 教程：程序员指南

"Freemarker教程" 本教程主要介绍了Freemarker 2.3.10版本的程序员指南，适合初学者学习。Freemarker是一个强大的模板语言，常用于生成HTML或其他类型的文本文件，尤其在Java Web开发中广泛应用。这个中文教程聚焦于如何使用Freemarker进行实际编程，帮助读者理解其工作原理。 一、快速入门 在开始使用Freemarker时，首要步骤是创建一个`Configuration`实例。`Configuration`类是Freemarker的核心，存储了应用程序级别的配置信息，如模板加载路径、模板编码等。它还负责模板的预解析和加载。在Web应用中，通常在初始化阶段创建一个全局的`Configuration`实例，并在整个应用生命周期中使用。 1.1、创建配置实例 ```java Configuration cfg = new Configuration(Configuration.VERSION_2_3_30); cfg.setDirectoryForTemplateLoading(new File("/path/to/templates")); ``` 这里，`setDirectoryForTemplateLoading()`方法设置了模板文件所在的目录。 1.2、创建数据模型（DataModel） 数据模型是Freemarker用来访问应用程序数据的对象。你可以将Java对象或集合包装成数据模型，以便在模板中使用。 ```java Map<String, Object> dataModel = new HashMap<>(); dataModel.put("name", "John Doe"); ``` 1.3、获取模版（template） 使用`Configuration`实例加载模板文件。 ```java Template template = cfg.getTemplate("example.ftl"); ``` 1.4、把模版与数据模型合并 将数据模型与模板合并，生成最终的输出文本。 ```java StringWriter out = new StringWriter(); template.process(dataModel, out); ``` 1.5、完整的代码 整合上述步骤，形成一个简单的Freemarker模板处理示例。 二、数据模型（DataModel） 数据模型包括各种类型的变量，如基本类型、标量、容器、方法变量、转换器变量、节点变量和对象包裹。这些变量可以是Java对象的直接引用，也可以是自定义的包装器。 三、配置（Configuration） 配置部分涵盖了设置共享变量、配置参数、模板加载策略、异常处理等方面，确保Freemarker根据应用程序需求正确运行。 四、其它说明 - 变量：Freemarker支持多种类型的变量表达式，如内置变量、用户定义变量等。 - 字符编码：配置模板的字符编码，以确保正确处理非ASCII字符。 - 多线程：Freemarker支持多线程环境，但需要注意线程安全问题。 - Bean包裹：可以直接使用Java Bean的属性，无需额外的映射操作。 这份中文教程选择了对Programmer's Guide的翻译，因为它深入解释了如何在实际项目中使用Freemarker，对于理解其工作原理和与其他模板引擎（如Velocity）的对比非常有帮助。如果在阅读过程中遇到难以理解的地方，作者鼓励读者通过邮件交流。