freemarker2.3.18_中文官方文档.doc

FreeMarker 手册 用于 FreeMarker 2.3.18 Translated By Nan Lei 南磊 译 Copyright： The Chinese translation of the FreeMarker Manual by Nan Lei is licensed under a Creative Commons Attribution 3.0 Unported License (). This licence only applies to the Chinese translation, not to the original (English) FreeMarker Manual. 版权说明： FreeMarker 中文版手册由南磊翻译，本文档基于Creative Commons Attribution 3.0 Unported 授权许可 本许可仅应用于中文版，不对原版英文手册。 目录 FreeMarker 手册 1 用于 FreeMarker 2.3.18 1 目录 2 前言 7 什么是FreeMarker？ 7 我们应该阅读什么内容？ 7 文档规约 8 联系我们 8 几点说明 8 第一部分 模板开发指南 9 第一章 模板开发入门 9 1.1 简介 9 1.2 模板 + 数据模型 = 输出 9 1.3 数据模型一览 10 1.4 模板一览 13 第二章 数值和类型 19 2.1 基本内容 19 2.2 类型 21 第三章 模板 25 3.1 总体结构 25 3.2 指令 26 3.3 表达式 27 3.4 插值 42 第四章 其它 45 4.1 自定义指令 45 4.2 在模板中定义变量 50 4.3 命名空间 53 4.4 空白处理 56 4.5 替换（方括号）语法 59 第二部分 程序开发指南 61 第一章 程序开发入门 61 1.1 创建配置实例 61 1.2 创建数据模型 61 1.3 获得模板 62 1.4 合并模板和数据模型 63 1.5 将代码放在一起 63 第二章 数据模型 65 2.1 基本内容 65 2.2 标量 65 2.3 容器 66 2.4 方法 67 2.5 指令 68 2.6 节点变量 74 2.7 对象包装 75 第三章 配置 79 3.1 基本内容 79 3.2 共享变量 79 3.3 配置信息 80 3.4 模板加载 82 3.5 错误控制 85 第四章 其它 89 4.1 变量 89 4.2 字符集问题 89 4.3 多线程 91 4.4 Bean 的包装 91 4.5 日志 97 4.6 在Servlet 中使用FreeMarker 98 4.7 为FreeMarker 配置安全策略105 4.8 遗留的XML 包装实现 106 4.9 和Ant 一起使用FreeMarker109 4.10 Jython 包装器 110 第三部分 XML 处理指南112 前言112 第一章 揭示XML 文档 113 1.1 节点树 113 1.2 将XML 放到数据模型中 115 第二章 必要的XML 处理 117 2.1 通过例子来学习 117 2.2 形式化描述 124 第三章 声明的XML 处理 129 3.1 基础内容 129 3.2 详细内容 131 第四部分 参考文档 134 第一章 内建函数参考文档 134 1.1 处理字符串的内建函数 134 1.2 处理数字的内建函数 147 1.3 处理日期的内建函数 151 1.4 处理布尔值的内建函数 155 1.5 处理序列的内建函数 156 1.6 处理哈希表的内建函数 161 1.7 处理节点（XML）的内建函数162 1.8 很少使用的和专家级的内建函数 163 第二章 指令参考文档 167 2.1 if，else，elseif 指令 167 2.2 switch，case，default，break 指令169 2.3 list，break 指令 170 2.4 include 指令 171 2.5 import 指令 174 2.6 noparse 指令 175 2.7 compress 指令 176 2.8 escape，noescape 指令177 2.9 assign 指令 179 2.10 global 指令 181 2.11 local 指令 182 2.12 setting 指令 182 2.13 用户自定义指令（@...） 184 2.14 macro，nested，return 指令 186 2.15 function，return 指令190 2.16 flush 指令 192 2.