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] 但是使用前者(没有[]符号)会更有效率（内存占用少而且速度快）。