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

"FreeMarker中文文档，用于FreeMarker2.3.18，由南磊翻译，基于Creative Commons Attribution 3.0 Unported License授权。文档涵盖了模板开发和程序开发两个部分，旨在帮助用户理解并使用FreeMarker进行动态内容生成。" FreeMarker是一款强大的、轻量级的模板引擎，主要被用来生成HTML或其他类型的文本输出，尤其适用于Web应用程序中的视图层。它是Java平台上的一个开源项目，允许开发者将内容呈现逻辑与业务逻辑分离，使得模板设计人员和程序员可以各自专注于自己的工作领域。 ### 前言 FreeMarker手册旨在提供全面的指南，介绍如何使用FreeMarker创建模板以及在程序中集成FreeMarker。手册分为两大部分：模板开发指南和程序开发指南。 ### 模板开发指南 #### 第一章 - 模板开发入门 - **1.1 简介**：解释了FreeMarker的基本概念，强调了模板与数据模型的结合生成输出。 - **1.2 模板+数据模型=输出**：介绍了模板如何与数据模型交互以产生最终的输出。 - **1.3 数据模型一览**：展示了数据模型的结构，包括对象、列表、映射等。 - **1.4 模板一览**：探讨了模板的基本元素，如指令、表达式和插值。 #### 第二章 - 数值和类型 - **2.1 基本内容**：讲述了FreeMarker中的基本数据类型，如数字、字符串等。 - **2.2 类型**：详细说明了FreeMarker支持的Java类型以及它们之间的转换规则。 #### 第三章 - 模板 - **3.1 总体结构**：描述了模板的整体结构和布局。 - **3.2 指令**：介绍了FreeMarker的内置指令，如`#if`, `#foreach`, `#include`等。 - **3.3 表达式**：讲解了如何在模板中使用表达式来获取和操作数据。 - **3.4 插值**：讨论了如何在文本中插入变量和表达式的值。 #### 第四章 - 其它 - **4.1 自定义指令**：说明了如何扩展FreeMarker，创建自定义的模板指令。 - **4.2 定义变量**：解释了在模板内部声明和使用变量的方法。 - **4.3 命名空间**：涵盖了命名空间的概念，允许组织和导入外部指令。 - **4.4 空白处理**：讨论了如何控制输出中的空白字符。 - **4.5 替换（方括号）语法**：介绍了使用方括号进行变量替换的规则。 ### 程序开发指南 #### 第一章 - 程序开发入门 - **1.1 创建配置实例**：讲解了如何初始化FreeMarker的配置对象。 - **1.2 创建数据模型**：指导如何构建Java对象以提供给FreeMarker模板。 - **1.3 获取模板**：说明了从文件系统或类路径加载模板的步骤。 - **1.4 合并模板和数据模型**：解释了如何将模板与数据模型合并生成输出。 - **1.5 将代码放在一起**：给出了一个简单的示例，演示了整个流程。 #### 第二章 - 数据模型 - **2.1 基本内容**：概述了数据模型的重要性和作用。 - **2.2 标量**：讨论了表示单个值的数据模型元素。 - **2.3 容器**：介绍了列表、集合、映射等容器类型。 - **2.4 方法**：描述了如何在模板中调用Java对象的方法。 FreeMarker文档不仅包含了上述内容，还涉及更高级的主题，如模板错误处理、缓存策略、国际化支持等。通过深入学习这个中文文档，开发者可以熟练地运用FreeMarker来构建高效、可维护的模板系统。