FreeMarker 中文手册：模板与程序开发指南

"FreeMarker中文手册，用于FreeMarker2.3.19，由南磊翻译，基于Creative Commons Attribution 3.0 Unported License授权。手册涵盖了模板开发和程序开发两个部分，旨在帮助用户理解并使用FreeMarker模板引擎。" FreeMarker是一个开源的Java库，用于生成动态HTML、XML或其他格式的文本输出。它与Java Servlet一起工作，用于生成Web应用中的视图层。FreeMarker将数据模型与模板结合，生成最终的输出，这样开发者可以将表现逻辑与业务逻辑分离。 **前言** FreeMarker手册介绍了FreeMarker的基本概念，建议读者根据自己的需求选择相应章节阅读。文档规约解释了手册的结构和使用方式，同时提供了联系方式以便用户提问或反馈。 **第一部分：模板开发指南** 1. **模板开发入门** - 1.1 简介：介绍FreeMarker的工作原理，即模板结合数据模型产生输出。 - 1.2 模板+数据模型=输出：说明模板是静态模板文本，数据模型是提供给模板的数据。 - 1.3 数据模型一览：列出各种数据模型类型，如标量、列表、映射等。 - 1.4 模板一览：介绍模板的基本结构和元素。 2. **数值和类型** - 2.1 基本内容：讨论数值的表示和操作。 - 2.2 类型：涵盖FreeMarker支持的原始类型，如字符串、数字、布尔值等。 3. **模板** - 3.1 总体结构：描述模板的整体布局和组成部分。 - 3.2 指令：介绍如何在模板中使用指令进行控制流和逻辑操作。 - 3.3 表达式：讲解如何在模板中使用表达式获取数据模型中的值。 - 3.4 插值：解释如何在文本中嵌入变量和表达式的值。 4. **其他** - 4.1 自定义指令：说明如何扩展FreeMarker以创建自定义模板指令。 - 4.2 定义变量：在模板内部定义和使用变量的方法。 - 4.3 命名空间：如何引入和使用命名空间来组织和引用模板元素。 - 4.4 空白处理：控制模板输出中的空白字符。 - 4.5 替换（方括号）语法：关于使用方括号进行文本替换的规则。 **第二部分：程序开发指南** 1. **程序开发入门** - 1.1 创建配置实例：初始化FreeMarker配置，设置模板目录和其他选项。 - 1.2 创建数据模型：构建Java对象作为数据模型供模板使用。 - 1.3 获得模板：加载和解析模板文件。 - 1.4 合并模板和数据模型：将模板与数据模型合并生成输出。 - 1.5 将代码放在一起：示例代码展示如何整合以上步骤。 2. **数据模型** - 2.1 基本内容：概述数据模型的构建和管理。 - 2.2 标量：简单数据类型如字符串、数字的处理。 - 2.3 容器：如列表和映射的处理。 - 2.4 方法：调用数据模型中对象的方法。 - 2.5 指令：在Java代码中使用自定义指令。 - 2.6 节点变量：处理XML或DOM树。 - 2.7 对象包装：FreeMarker如何包装Java对象以便在模板中使用。 3. **配置** - 3.1 配置选项：详述可配置的设置，如模板加载策略、缓存行为等。 手册还包括更多章节，如错误处理、性能优化、国际化和本地化等内容，旨在帮助开发者熟练掌握FreeMarker，提高动态内容生成的效率和灵活性。通过学习这个手册，你可以深入了解FreeMarker的各个方面，并能有效地将其集成到你的Java项目中。