023_运行时变量和范围

1. 当调用Template.process方法时, 它会在方法内部创建一个Environment对象, 在process返回之前一直使用。该对象存储模板执行时的运行状态信息。除了这些, 它还存储由模板中指令, 如: assign, macro, local或global创建的变量。它不会尝试修改传递给process的数据模型对象, 也不会创建或替换存储在配置中的共享变量。

2. 当你想要读取一个变量时, FreeMarker将会以这种顺序来查找, 直到发现了完全匹配的的变量名称才会停下来:

2.1. 在Environment中:

2.1.1. 如果在循环中, 在循环变量的集合中。循环变量是由如list等指令来创建的。

2.1.2. 如果在宏中, 在宏的局部变量集合中。局部变量可以由local指令创建。而且, 宏的参数也是局部变量。

2.1.3. 在当前的命名空间中。可以使用assign指令将变量放到一个命名空间中。

2.1.4. 在由global指令创建的变量集合中。FTL将它们视为数据模型的普通成员变量一样来控制它们。也就是说, 它们在所有的命名空间中都可见, 你也可以像访问一个数据模型中的数据一样来访问它们。

2.2. 在传递给process方法的数据模型对象中。

2.3. 在Configuration对象存储的共享变量集合中。

3. 在实际操作中, 来自模板设计者的观点是这6种情况应该只有4种, 因为从那种观点来看, 后面3种(由global创建的变量, 真实的数据模型对象, 共享变量)共同构成了全局变量的集合。