FreeMarker的基础知识整理

1、Freemarker概念

Freemarker不是web开发的应用程序框架，它是适用于web应用程序框架中的组件。

    FreeMarker引擎本身不知道HTTP协议或者Java Servlet的存在。所以它也可以用于非   web应用程序的开发环境

 

2、模板+数据模型 = 输出

*模板：

        静态的HTML代码+FreeMarker指令元素

    *数据模型：

              来自java对象

    *输出：

          模板存放在web服务器上，当有人来访问这个页面时，FreeMarker将会动转换   模板，生成普通的HTML文本并发送结果到访问者的Web浏览器中去显示

 

3、变量：

       1)哈希表变量：

可以访问子变量名称

          *指定值：

    {"name":"mouse","age":128},键的类型为字符串，如  "name","age"

          *检索：

                 hash.name,hash.age

          *连接：

  使用+来连接两个哈希表，如果两个哈希表含有相同键的项，

                          那么+右侧的哈希表中的项优先

                  <#assign ages = {"joe":23,"fred":24}+{"joe":20,"julia":30}>

                          最后ages.joe=20

       2)序列变量：

                  按顺序存储子变量，使用数字索引访问子变量

            *指定值：

  ["foo","bar",123]

            *检索：

seq[5]

    *切分：

seq[firstindex..lastindex]

                        seq[10..19]表达式会是包含第11个至第20个元素的序列， lastindex可以省略，这样seq[10..]表示包含第11个至最后一个 元素的序列

       

 

       3)标量：

    仅存储单值的变量

             *字符串：

     *指定值：

 "aaa"或者'aaa'

                     *检索：

   获取一个字符name[0]

         *连接：

   "aaa"+"bbb"

         *原生字符串：

            一些特殊的符号没有特殊意义，前面加r，

                 例如${r"${foo}"}会打印${foo}

             *数字：

                   *指定值：

   123.45

             *日期/时间：

                       *指定值：

             *布尔值：

 *指定值：

 true,false

       

6、在模板中要访问子变量，需要从根开始指定路径，每级用点来分隔。

 

7、FreeMarker模板（FTL）的特殊部分：

      1）插值：

         ${表达式}

              *使用：

                *文本：

  <h1>Hello ${name}!</h1>

                *字符串：

<#include "/footer/${company}.html">

          *表达式的结果：

                *字符串插值：

                            当插值在文本区，放在escapse指令中，被插 入的字符串(HTML)会被自动转义

                            <#escape x as x?html>

                            <p>${book}</p><!--如&会被转义为&>

                            <p><#noescape>${pencil}</#noescape></p>

                                </#escape>

        *数字插值：

    使用number_format设置格式

    使用string重写默认格式

 

 

        *日期/时间插值：

   使用time_format,date_format,datetime_format  设置转换格式

   使用string重写默认格式

        *布尔插值：

    布尔类型的变量不能直接放进${}中，需要   ${user?string("yes","no")}

 

      2）FTL标签（指令）：

                  以#符号开头，自定义的标签以@开头，

                  标签不可以在其他标签和插值中使用

 

      3）注释：

              <#--和-->可以放在标签和插值中间

              ${user<#--the name-->}

             <#list <#--some comment-->>

 

8、指令：

       1）if指令：

                 <#if condition>...</if>

                 当condition条件为false时，if标签之间的内容会被忽略

       2）if else指令：

                    <#if condition>

                      aaaaaaaa;

                    <#else>

                      bbbbbbb;

                    </#if>

                    使用<#else>标签可以指定condition为false时执行的程序

       3）list指令：

                  <#list sequence as loopVariable>

                     语句;

                  </#list>

       4)include指令：

                    <#include "aaa.html">

 

9、处理不存在的变量：（变量不存在或者为null）

       1）指定默认值：

                     ${(bianliang ! "aaa")}

                     当bianliang不存时指定bianliang="aaa"，最好是使用括号,

                 如果默认值被省略了，那么结果将会是空串，空序列或空哈希表，

                 但是如果想让默认值为0或者false，则需要指定，不能省略。

                     多级访问变量问题：

                      1）animals.pig.price!0

                         animals和pig变量都需要存在才会给price赋默认值，

                         否则程序报错

                      2）(animals.pig.price)!0

                         animals和pig变量不存在时表达式结果也为0

 

       2）if询问：

                 <#if bianliang??>               

 

10、方法和函数：

               方法来自于数据模型（反射了java对象的方法）

               函数是定义在模板里的，使用函数指令

11、算数运算：

            *加法：+

        *减法：-

        *乘法：*

        *除法：/

        *求模（求余）：%

 

12、比较运算：

            比较运算两边的表达式结果为数字类型

        *相等：=

        *不等：!=

                <   (lt)

           <=  (lte)

            >   (gt)

            >=  (gte)

          *但是<和>需要放在（）中，否则和FTL标签冲突

 

13、逻辑操作：

         逻辑操作两边的表达式结果为布尔类型

         *逻辑或：||

         *逻辑与：&&

         *逻辑非：！

 

14、内建函数：

         内建函数提供变量的不同形式和其它信息。

           *字符串使用的内建函数：

                   *html:

                                       字符串中所有的特殊HTML字符都需要用实       体引用来代替。

                   *cap_first:

       第一个字母变为大写。

                   *lower_case:

 字符串小写形式。

                    

*upper_case:

 字符串大写形式。

                    *trim:

去掉字符串首尾的空格。

                    *string:

 设置输出格式。

          *序列使用的内建函数：

                  Size:

  序列中元素的个数。

          *数字使用的内建函数：

                  int:

 数字的整数部分。

 

15、模板中定义的变量：

             *简单变量：

       能从模板中的任何位置来访问，或者从使用include指令      引入的模板访问。

                   可以使用assign或macro指令来创建或替换这些变量

                       *创建变量：

 <#assign x=1>

                   *替换变量：

 <#assign x=x+3>

 

      *局部变量：

                      设置在宏定义体内，只在宏内可见。生存周期只是宏的    调用过程。可以使用local指令在宏定义体内创建或者替    换局部变量

 

     *循环变量：

  由指令(如list)自动创建，只在指令的开始和结束标记内     有效。

 

     *隐藏变量：

         *模板中定义的变量隐藏数据模型中的变量

         *局部变量隐藏同名的简单变量

         *循环变量隐藏同名的局部变量和简单变量

         *内部循环变量隐藏外部循环变量 

         <#assign x="aaa">

            ${x}                  <#--普通变量-->

                  <#list["loop"] as x>

                   ${x}              <#--循环变量-->

               <#assign x="bbb">  <#--普通变量-->

           ${x}              <#--循环变量-->

              </#list>

              ${x}                   <#--普通变量-->

                       <#local x="local">

                            ${x}              <#--局部变量-->

                        <#list ["loo"] as x>

${x}          <#--循环变量x-->

       </#list>

       ${x}              <#--局部变量-->

         </#local>