FreeMarker中文参考手册

### FreeMarker中文参考手册知识点概览 #### 一、前言 - **目的与适用人群**：本手册旨在为开发者提供全面深入的FreeMarker使用指南，适用于初学者及具有一定经验的开发者。 - **版本说明**：手册适用于FreeMarker 2.3.18版本。 #### 二、模拟开发指南 ##### 第一章 模板开发入门 - **1.1 简介**：介绍了FreeMarker的基本概念及其工作原理。 - **1.2 模板+数据模型=输出**：阐述了FreeMarker如何通过模板和数据模型生成输出内容。 - **1.3 数据模型一览**：详细列出了可用于FreeMarker的数据模型类型，包括但不限于标量、容器等。 - **1.4 模板一览**：提供了各种模板元素的概述，如指令、表达式等。 ##### 第二章 数值和类型 - **2.1 基本内容**：解释了FreeMarker中数值的基本概念。 - **2.2 类型**：深入探讨了FreeMarker支持的各种数据类型，包括但不限于字符串、数字、日期等。 ##### 第三章 模板 - **3.1 总体结构**：描述了FreeMarker模板的基本结构。 - **3.2 指令**：列举并解释了FreeMarker中可用的指令。 - **3.3 表达式**：详细介绍了FreeMarker中的表达式语法和使用方式。 - **3.4 插值**：解释了如何在模板中插入变量和表达式的值。 ##### 第四章 其它 - **4.1 自定义指令**：说明了如何创建和使用自定义指令。 - **4.2 在模板中定义变量**：指导用户如何在模板内部定义和使用变量。 - **4.3 命名空间**：介绍了FreeMarker中命名空间的概念及其用法。 - **4.4 空白处理**：解释了如何处理模板中的空白字符。 - **4.5 替换（方括号）语法**：探讨了方括号语法的使用场景及其功能。 #### 三、程序开发指南 ##### 第一章 程序开发入门 - **1.1 创建配置实例**：指导如何初始化FreeMarker的配置对象。 - **1.2 创建数据模型**：讲解了如何构建FreeMarker所需的数据模型。 - **1.3 获得模板**：说明了如何加载和准备模板。 - **1.4 合并模板和数据模型**：解释了如何将模板与数据模型结合生成最终输出。 - **1.5 将代码放在一起**：提供了完整的示例代码，演示如何将上述步骤整合到一个程序中。 ##### 第二章 数据模型 - **2.1 基本内容**：概述了数据模型的基础知识。 - **2.2 标量**：解释了标量类型的概念及其用途。 - **2.3 容器**：详细介绍了FreeMarker支持的容器类型，如数组和映射。 - **2.4 方法**：介绍了如何在数据模型中定义和调用方法。 - **2.5 指令**：探讨了数据模型中的指令概念。 - **2.6 节点变量**：解释了节点变量的作用及其使用方式。 - **2.7 对象包装**：介绍了FreeMarker如何处理Java对象。 ##### 第三章 配置 - **3.1 基本内容**：概述了配置的基础知识。 - **3.2 共享变量**：说明了如何设置全局可用的变量。 - **3.3 配置信息**：详细介绍了配置参数及其作用。 - **3.4 模板加载**：解释了模板加载机制及其配置选项。 - **3.5 错误控制**：介绍了如何处理FreeMarker运行时出现的错误。 ##### 第四章 其它 - **4.1 变量**：进一步探讨了变量的高级用法。 - **4.2 字符集问题**：解决了FreeMarker在处理不同字符集时可能出现的问题。 - **4.3 多线程**：指导用户如何使FreeMarker在多线程环境中高效运行。 - **4.4 Bean的包装**：介绍了FreeMarker如何处理JavaBean。 - **4.5 日志**：说明了如何配置和使用FreeMarker的日志功能。 - **4.6 在Servlet中使用FreeMarker**：提供了在Servlet环境中使用FreeMarker的具体步骤。 - **4.7 为FreeMarker配置安全策略**：介绍了如何增强FreeMarker的安全性。 - **4.8 遗留的XML包装实现**：讨论了旧版XML包装方案。 - **4.9 和Ant一起使用FreeMarker**：介绍了如何在Ant脚本中集成FreeMarker。 - **4.10 Jython**：探讨了在Jython环境中使用FreeMarker的方法。 #### 四、内建函数与指令参考 ##### 第一章 内建函数参考文档 - **1.1 处理字符串的内建函数**：列出了所有用于处理字符串的内建函数。 - **1.2 处理数字的内建函数**：列出了所有用于处理数字的内建函数。 - **1.3 处理日期的内建函数**：列出了所有用于处理日期的内建函数。 - **1.4 处理布尔值的内建函数**：列出了所有用于处理布尔值的内建函数。 - **1.5 处理序列的内建函数**：列出了所有用于处理序列的内建函数。 - **1.6 处理哈希表的内建函数**：列出了所有用于处理哈希表的内建函数。 - **1.7 处理节点（XML）的内建函数**：列出了所有用于处理XML节点的内建函数。 - **1.8 很少使用的和专家级的内建函数**：列出了一些不常用但功能强大的内建函数。 ##### 第二章 指令参考文档 - **2.1 if，else，elseif指令**：解释了条件判断指令的用法。 - **2.2 switch，case，default，break指令**：介绍了选择结构指令的使用方法。 - **2.3 list，break**：说明了循环结构指令的使用方式。 - **2.4 include指令**：介绍了如何在模板中包含其他模板。 - **2.5 import指令**：解释了如何导入自定义函数或宏。 - **2.6 noparse指令**：介绍了如何避免解析某些文本。 - **2.7 compress指令**：说明了如何压缩文本输出。 - **2.8 escape，noescape指令**：解释了如何处理特殊字符。 - **2.9 assign指令**：介绍了如何在模板中定义局部变量。 - **2.10 global指令**：说明了如何定义全局变量。 - **2.11 local指令**：介绍了如何定义局部变量。 - **2.12 setting指令**：解释了如何在模板中设置配置选项。 - **2.13 用户自定义指令（<@>）**：介绍了如何创建和使用自定义指令。 - **2.14 macro，nested，return指令**：说明了如何定义和使用宏。 - **2.15 function，return**：解释了如何定义和使用函数。 - **2.16 flush指令**：介绍了如何强制刷新输出。 - **2.17 stop**：说明了如何停止模板执行。 - **2.18 ftl指令**：解释了如何指定模板语言版本。 - **2.19 t，lt，rt**：介绍了如何处理文本。 - **2.20 nt指令**：说明了如何处理空文本。 - **2.21 attempt，recover**：解释了如何处理异常。 - **2.22 visit，recurse，fallback指令**：介绍了如何递归处理数据结构。 #### 五、废弃的FTL结构 - **5.1 废弃的指令列表**：列出了不再推荐使用的指令。 - **5.2 废弃的内建函数列表**：列出了不再推荐使用的内建函数。 - **5.3 老式的macro和call指令**：介绍了已被新指令取代的老式指令。 - **5.4 转换指令**：解释了如何将老式指令转换为新指令。 - **5.5 老式FTL语法**：说明了如何理解并转换老式语法。 - **5.6 #{…}式的数字插值**：解释了一种已废弃的插值语法。 #### 附录A FAQ - **1. JSP和FreeMarker的对比**：比较了JSP和FreeMarker的主要区别，帮助用户根据项目需求选择合适的工具。 以上内容总结了FreeMarker中文参考手册的主要知识点，涵盖了模板开发、程序开发、内建函数、指令使用以及一些高级主题。这些知识点对于理解和掌握FreeMarker的使用至关重要。