FreeMarker_Manual_zh_CN.pdf

1.4 模板一览 ................................................................................................... 13

2.1 基本内容 ................................................................................................... 19

2.2 类型 .......................................................................................................... 21

3.1 总体结构 ................................................................................................... 25

3.2 指令 .......................................................................................................... 26

3.3 表达式 ....................................................................................................... 27

3.4 插值 .......................................................................................................... 42

1.1 创建配置实例 ............................................................................................ 60

1.2 创建数据模型 ............................................................................................ 60

1.3 获得模板 ................................................................................................... 61

1.4 合并模板和数据模型 .................................................................................. 62

1.5 将代码放在一起 .......................................................................................... 62

2.1 基本内容 ................................................................................................... 63

2.2 标量 .......................................................................................................... 64

2.3 容器 .......................................................................................................... 65

3.2 共享变量 ................................................................................................... 77

3.3 配置信息 ................................................................................................... 78

3.4 模板加载 ................................................................................................... 80

3.5 错误控制 ................................................................................................... 83

4.1 变量 .......................................................................................................... 86

4.2 字符集问题 ................................................................................................ 87

4.3 多线程 ....................................................................................................... 88

4.4 Bean 的包装 ................................................................................................ 89

4.5 日志 .......................................................................................................... 95

4.6 在 Servlet 中使用 FreeMarker ...................................................................... 95

1.1 节点树 ......................................................................................................110

1.2 将 XML 放到数据模型中 ............................................................................112

1.1 处理字符串的内建函数 .............................................................................130

1.2 处理数字的内建函数 .................................................................................143

1.3 处理日期的内建函数 .................................................................................147

1.4 处理布尔值的内建函数 .............................................................................149

1.5 处理序列的内建函数 .................................................................................150

1.6 处理哈希表的内建函数 .............................................................................155

1.7 处理节点（XML）的内建函数....................................................................156

1.8 很少使用的和专家级的内建函数 ...............................................................157

2.8 escape，noescape 指令...............................................................................170

2.9 assign 指令 ................................................................................................173

2.10 global 指令 ..............................................................................................174

2.11 local 指令 ................................................................................................175

2.12 setting 指令 .............................................................................................176

2.13 用户自定义指令（<@...>） ......................................................................177

2.14 macro，nested，return 指令 ....................................................................180

2.15 function，return 指令...............................................................................184

2.16 flush 指令 ................................................................................................185

2.17 stop 指令.................................................................................................186

2.18 ftl 指令 ....................................................................................................186

5.1 废弃的指令列表 ........................................................................................196

5.2 废弃的内建函数列表 .................................................................................196

1. JSP 和 FreeMarker 的对比 .............................................................................202

2. Velocity 和 FreeMarker 的对比.......................................................................203

3. 为什么 FreeMarker 对 null-s 和不存在的变量很敏感，如何来处理它？ ......203

4. 文档编写了特性 X，但是好像 FreeMarker 并不知道它，或者它的行为和文档描

述的不同，或者一个据称已经修改的 BUG 依然存在。 .....................................204

5. 为什么 FreeMarker 打印奇怪的数字数字格式（比如 1,000,000 或 1 000 000 而不

是 1000000）？ ...............................................................................................204

6. 为什么 FreeMarker 会打印不好的小数和/或分组分隔符号（比如 3.14 而不是 3,14）

.......................................................................................................................205

7. 为什么当我想用如格式打印布尔值时，FreeMarker 会抛出错误，又如何来修正

TemplateTransformModel/ TemplateDirectiveModel 的 实现传 递普通

java.lang.* / java.util.*对象的参数？ ...............................................207

14. 为什么在 myMap[myKey]表达式中不能使用非字符串的键？那现在应该怎么

做？................................................................................................................208

条目的 java.util.Map 的方法。当然，只是想获取 map 的条目。 ...............209

16. 在 FreeMarker 的模板中如何改变序列（lists）和哈希表（maps）？ ...........209

17. 关于 null 在 FreeMarker 模板语言是什么样的？ ......................................210

18. 我该怎么在表达式（作为另外一个指令参数）中使用指令（宏）的输出？ 211

19. 在输出中为什么用“？”来代替字符 X？ ..................................................211

20. 在模板执行完成后，怎么在模板中获取计算过的值？ ................................212

25. FreeMarker 有多快？真的是 2.X 版本的要比 1.X 版本（经典的 FreeMarker）的慢

吗？................................................................................................................214

26. 我的 Java 类怎么才能获取到关于模板结构的信息（比如所有变量的列表）？

2.3.16 版.........................................................................................................218

2.3.15 版.........................................................................................................218

2.3.14 版.........................................................................................................219

2.3.13 版.........................................................................................................220

2.3.12 版.........................................................................................................220

2.3.11 版.........................................................................................................221

2.3.10 版.........................................................................................................222

2.3.9 版 ..........................................................................................................223

2.3.8 版 ..........................................................................................................224