freemarker

第一章：基本

一、if指令
    <# if condition>
    <#else>
    </#if>

二、list指令
    <#list sequence as loopVariable>repeatThis</#list>
        repeatThis 部分将会在给定的 sequence 遍历时在每项中重复，从第一项开始，
        一个接着一个。 在所有的重复中， loopVariable 将持有当前项的值。 这个循环变量仅
        存在于<#list …>和</#list>标签之间。

三、include指令
    <#include "/copyright_footer.html">

四、联合使用指令
    <#list animals as begin>
    <tr>
        <td>
            <#if begin.size == "large"><font size="+1"></#if>
            ${being.name}
            <#if begin.size == "large"></font></#if>
        </td>${begin.price} Euros
    </tr>
    </#list>
五、不存在的变量： 不允许，但是定义了处理规则之后是可以的。
    方式一：指定默认值: ${变量名!默认值}
        <h1>Welcome ${user!"DefaultValue"}</h1>
    方式二：结合if指令使用：
        <#if user??><h1>Welcome ${user}</h1></#if>

         变量名??  ：如果存在返回true，否则返回flase。

    补充：
        关 于 多 级 访 问 的 变 量 ， 比 如 animals.python.price ， 书 写 代 码 ：
        animals.python.price!0 ，仅当 animals.python 存在而仅仅最后一个子变
        量 price 可能不存在（这种情况下我们假设价格是 0）。 如果 animals 或者 python
        不存在，那么模板处理过程将会以“未定义的变量”错误而停止。 为了防止这种情况的发生，
        可以这样来书写代码(animals.python.price) !0。这种情况下当 animals 或
        python 不存在时表达式的结果仍然是 0。 对于 ??也是同样用来的处理这种逻辑的：
        animals.python.price?? 对比(animals.python.price)?? 来看。


第二章： 数值和类型
一、数值
二、类型
    一】标量
        1）字符串：简单文本
        2）数字：整数和非整数是不区分的，只有单一的数字类型。 3/2=1.5
        3）布尔值：代表了逻辑上的对与错。(模版中可以使用true和false)
        4）日期：日期变量可以存储和日期/时间相关的数据。
    二】容器
        1）哈希表：每个子变量都可以通过一个唯一的名称来查找，这个名称是不受限制的字
                    符串。 哈希表并不确定其中子变量的顺序，也就是说没有第一个变量，第二个变量
                    这样的说法，变量仅仅是通过名称来访问的。
        2）序列：每个子变量通过一个整数来标识，
                 子变量是有序的，整数通常被称为子变量的索引
                 子变量的数值类型不需要完全一致。
        3）从模板设计者角度来看，集是有限制的序列。不能获取集的大小，也不能通过
           索引取出集中的子变量，但是它们仍然可以通过 list 指令来遍历。
    三】子程序：
        1）方法和函数：
            函数/方法也可以是其他函数或方法的参数或者返回值，并可以把它们定义成变量。
            区别：
                方法：来自于数据模型，反射了java对象的方法
                函数：定义于模版内。
            可以用同一种方式来使用。

第三章 模版
一、总体结构    
    Text文本:照原样输出
    interpolation 插值:${变量名}
    FTL tags 标签: FTL标签和HTML标签很相似,给FreeMarker指示
    comments 注释：<#--注释的内容-->  会被FreeMarker忽略掉，更不会在输出内容中显示。

    注意：
        1）FTL标签不可以在其他FTL标签和插值中使用：<#if <#include ‘foo‘>=‘bar‘>>...</if>
        2）注释相反可以放在FTL标签和插值中间使用
                eg:
                    ${user <#--The name of user-->}      <#List <#-- some comment --> animals as <#--again-->></#list>
二、指令
    预定义指令：<#directivename parametes>...</#directivename>
    自定义指令：<@mydirective parameters>...</@mydirective>
三、表达式
        插值:       ${(5+8)/2}   打印6.5
        指令参数   <#if 2 < 3 >   成立(2<3为rue)
    一】字符串
        1)"some text" 和 ‘some text‘ 形式相等。
        2)\为转移字符  eg: \\ \" \‘
        3)表明字符串为原生字符串,加r  ${r"${foo}"}  ${r"c:\foo\bar"}
        
    二】序列
        使用逗号来分隔其中的每个子变量，然后把整个列表放到方括号中
            列举：<#list ["winter", "spring", "summer", "autumn" as x]>${x}</#list>
            范围: 2..5 等价于[2, 3, 4, 5] 但是使用前者(没有[]符号)会更有效率（内存占用少而且速度快）。