【FreeMarker】【模板文件FTL】模板命名空间（模板库，import指令）

命名空间

如果想创建可以重复使用的宏，函数和其他变量的集合，说就是引用library库。使用多个命名空间是必然的。只要考虑你在一些项目中，或者想和他人共享使用的时候，你是否有一个很大的宏的集合。但要确保库中没有宏（或其他变量）名和数据模型中变量同名，而且也不能和模板中引用其他库中的变量同名。通常来说，变量因为名称冲突也会相互冲突。所以要为每个库中的变量使用不同的命名空间。

创建一个库（FTL）

建立一个简单的库，例如：

<#macro copyright date>
<p>Copyright (C) ${date} Julia Smith. All rights reserved.</p>
</#macro>
<#assign mail = "jsmith@acme.com">

把上面的这些定义存储在文件lib/my_test.ftl中（目录是你存放模板的位置）。

假设想在aWebPage.ftl中使用这个模板。如果在aWebPage.ftl使用<#include "/lib/my_test.ftl">，那么就会在主命名空间中创建两个变量，这样就不是很好，因为想让它们只在同一个命名空间”My Test Library”中。所以就不得不使用import指令来代替include了。

这个指令和include很相似，但是它会为lib/my_test.ftl创建一个空的命名空间，然后在那里执行。lib/my_test.ftl会发现它自己在一个新的环境中，那里只有数据模型的变量可以来呈现（因为它们在那里面都是可见的），然后会在这个环境中创建两个变量。现在来看这很不错，但是如果想访问aWebPage.ftl中的两个变量，而它们使用的是主命名空间，就不能看到其他命名空间中的变量。解决方法是import指令不仅仅创建命名空间，而且要通过import的调用者（本例中的主命名空间）创建一个新的哈希表变量，这就成为进入新的命名空间的大门。那么aWebPage.ftl就像下面这样：

<#import "/lib/my_test.ftl" as my>

<@my.copyright date="1999-2002"/>
${my.mail}

打印出：

<p>Copyright (C) 1999-2002 Julia Smith. All rights reserved.</p>
jsmith@acme.com

在引入的命名空间中创建/替换变量

偶尔想要在一个被包含的命名空间上创建或替换一个变量。那么可以使用assign指令在完成。

例如：

<#import "/lib/my_test.ftl" as my>
${my.mail}
<#assign mail="jsmith@other.com" in my>
${my.mail}

打印出：

jsmith@acme.com
jsmith@other.com

命名空间和数据模型

数据模型中的变量在任何位置都是可见的。如果在数据模型中有一个名为user的变量，那么lib/my_test.ftl也能访问它，aWebPage.ftl当然也能。

命名空间的生命周期

命名空间由使用的import指令中所写的路径来识别。如果想多次import这个路径，那么只会为第一次的import引用创建命名空间执行模板。后面相同路径的import只是创建一个哈希表当作访问相同命名空间的“门”。