FreeMarker编程指南：快速入门与配置详解

"Freemarker编程指南[文字版][中文]" Freemarker是一款强大的开源模板引擎，主要用于生成动态HTML或其他文本格式的输出，常用于Web开发中的视图层。本指南主要基于FreeMarker 2.3.10版本，旨在帮助程序员更好地理解和使用这一技术。 一、快速入门 在开始使用FreeMarker时，首先需要创建一个`Configuration`实例，这是FreeMarker的核心配置对象，用于存储应用程序级别的配置信息，并管理模板的加载和预解析。以下是一个简单的创建配置实例的步骤： 1.1、创建配置实例 ```java import freemarker.template.Configuration; Configuration config = new Configuration(Configuration.VERSION_2_3_30); config.setDirectoryForTemplateLoading(new File("/path/to/templates")); // 设置模板目录 ``` 1.2、创建数据模型（DataModel） 数据模型是FreeMarker用来呈现模板的数据结构。它可以是Java对象、集合、Map等。例如，你可以创建一个简单的Java Bean作为数据模型： ```java public class MyDataModel { public String message = "Hello, World!"; } MyDataModel dataModel = new MyDataModel(); ``` 1.3、获取模版（template） 使用配置实例加载模板文件： ```java Template template = config.getTemplate("example.ftl"); ``` 1.4、把模版与数据模型合并 将数据模型与模板合并，生成最终的输出： ```java StringWriter writer = new StringWriter(); template.process(dataModel, writer); String output = writer.toString(); ``` 1.5、完整的代码 整合以上步骤，可以得到一个完整的FreeMarker模板渲染示例。 二、数据模型（DataModel） FreeMarker支持多种数据类型，包括基本类型、容器类型、方法变量、转换器变量和节点变量等。数据模型可以是Java对象的直接映射，也可以是自定义包装器。 2.1、基础类型 包括字符串、数字、布尔值等。 2.2、Scalar类型 表示单个值的数据模型。 2.3、容器类型 如List、Set、Map等，用于存储多个值。 2.4、方法变量 允许模板调用Java对象的方法。 2.5、转换器变量 用于将Java对象转换成适合模板处理的形式。 2.6、节点变量 处理XML或DOM树结构。 2.7、对象包裹 FreeMarker可以自动将Java对象包裹成DataModel，或者自定义包裹逻辑。 三、配置（Configuration） 配置对象包含许多设置，如模板加载、异常处理等。 3.1、基础 设置模板加载目录、缓存策略等。 3.2、共享变量 全局可访问的变量，可在模板中直接使用。 3.3、配置参数 调整FreeMarker的行为，如模板语言的默认设置。 3.4、加载模板 从文件系统、URL或类路径加载模板。 3.5、异常处理 配置如何处理模板执行过程中的错误。 四、其它说明 4.1、变量 FreeMarker模板中的变量表达式，如`${variable}`。 4.2、字符编码 模板和输出的字符编码设置。 4.3、多线程 FreeMarker支持多线程环境，但模板实例不是线程安全的。 4.4、Bean包裹 FreeMarker可以自动将Java Bean的属性暴露给模板。 4.5、Bean包裹 允许自定义Java Bean属性的访问方式。 这个指南涵盖了FreeMarker的基础使用，包括配置、数据模型和模板处理。通过深入学习，开发者可以掌握FreeMarker的高级特性和最佳实践，从而更高效地利用它来生成动态内容。