下载struts2 rest freemarker

pojo\PojoFields.ftl

<#-- // Fields -->

<#foreach field in pojo.getAllPropertiesIterator()><#if pojo.getMetaAttribAsBool(field, "gen-property", true)>    /** *//** *//** *//**
<#if pojo.hasMetaAttribute(field, "field-description")>
     ${pojo.getFieldJavaDoc(field, 0)}
</#IF>
<#foreach column in field.columnIterator><#if column.comment?exists && column.comment?trim?length!=0>     * ${column.comment}.
</#IF>
</#FOREACH>
     */
    ${pojo.getFieldModifiers(field)} ${pojo.getJavaTypeName(field, jdk5)} ${field.name}<#if pojo.hasFieldInitializor(field, jdk5)> = ${pojo.getFieldInitialization(field, jdk5)}</#IF>;
</#IF>
</#FOREACH>

pojo\PojoPropertyAccessors.ftl

<#-- // Property accessors -->
<#foreach property in pojo.getAllPropertiesIterator()>
<#if pojo.getMetaAttribAsBool(property, "gen-property", true)>
    /** *//**
<#if pojo.hasFieldJavaDoc(property)>
     * ${pojo.getFieldJavaDoc(property, 4)}
</#IF>
<#foreach column in property.columnIterator><#if column.comment?exists && column.comment?trim?length!=0>     * 取得 ${column.comment}.
</#IF>
</#FOREACH>
     */
    <#include "GetPropertyAnnotation.ftl"/>
    ${pojo.getPropertyGetModifiers(property)} ${pojo.getJavaTypeName(property, jdk5)} ${pojo.getGetterSignature(property)}() {
        return this.${property.name};
    }

    /** *//**
<#if pojo.hasFieldJavaDoc(property)>
     * ${pojo.getFieldJavaDoc(property, 4)}
</#IF>
<#foreach column in property.columnIterator><#if column.comment?exists && column.comment?trim?length!=0>     * 设置 ${column.comment}.
</#IF>
</#FOREACH>
     */
    ${pojo.getPropertySetModifiers(property)} void set${pojo.getPropertyName(property)}(${pojo.getJavaTypeName(property, jdk5)} ${property.name}) {
        this.${property.name} = ${property.name};
    }
</#IF>
</#FOREACH>

org\hibernate\tool\hbm2x\TemplateProducer.java

public void produce(Map additionalContext, String templateName, File destination, String identifier, String fileType, String rootContext) {

        String tempResult = produceToString( additionalContext, templateName, rootContext );

        if(tempResult.trim().length()==0) {
            log.warn("Generated output is empty. Skipped creation for file " + destination);
            return;
        }
        FileWriter fileWriter = null;
        Writer fileWriter = null;
        try {

            th.ensureExistence( destination );    

            ac.addFile(destination, fileType);
            log.debug("Writing " + identifier + " to " + destination.getAbsolutePath() );
            fileWriter = new FileWriter(destination);
            fileWriter = new BufferedWriter(new OutputStreamWriter(new FileOutputStream(destination), "UTF-8"));

            fileWriter.write(tempResult);
        }
        catch (Exception e) {
            throw new ExporterException("Error while writing result to file", e);
        } finally {
            if(fileWriter!=null) {
                try {
                    fileWriter.flush();
                    fileWriter.close();
                }
                catch (IOException e) {
                    log.warn("Exception while flushing/closing " + destination,e);
                }
            }
        }

    }

org\hibernate\tool\hbm2x\jtidy.properties

indent=auto
indent-spaces=4
#indent-attributes=yes
    wrap=180
markup=yes
clean=yes
output-xml=yes
input-xml=yes
show-warnings=yes
trim-empty-elements=yes
input-encoding=utf-8
output-encoding=utf-8

今天终于把他完美实现了，最主要的作用是可以不传入参数和轻松取得需要的参数。

把代码拿出来给大家晒晒：

<#macro topic_new extra...>
  <#if extra?size gt 0>

   <#assign param_forumId>

   ${extra?keys?seq_contains("forum.id")?string("?forum.id=${extra['forum.id']}","")}

   </#assign>

</#if>

<input type="text" value="topic_new.action${param_forumId?if_exists}"/>

</#macro>

关键的：

1. <#if extra?size gt 0>判断不传入参数的情况

2. extra?keys?seq_contains("forum.id")判断是否存在forum.id这个参数

3. ?string("?forum.id=${extra['forum.id']}","")如果不存在则为空，${extra['forum.id']}快速取得forum.id的值

不用再在外面加个list用${extra[attr]}的方式来取数据。

4. ${param_forumId?if_exists}取得上面定义的变量值，用?if_exists实现没有变量时为空，有变量则现实值

一.输出 ${book.name}
空值判断：${book.name?if_exists },
${book.name?default(‘xxx’)}//默认值xxx
${ book.name!"xxx"}//默认值xxx
日期格式：${book.date?string(‘yyyy-MM-dd’)}
数字格式：${book?string.number}–20
${book?string.currency}–<#– $20.00 –>
${book?string.percent}—<#– 20% –>
插入布尔值：
<#assign foo=ture />
${foo?string("yes","no")} <#– yes –>

二．逻辑判断
1:
<#if condition>
….
<#elseif condition2>
….
<#elseif condition3>
……
<#else>
…
</#if>
其中空值判断可以写成<#if book.name?? >

2:
<#switch value>
<#case refValue1>
    …
    <#break>
<#case refValue2>
    …
    <#break>
…
<#case refValueN>
    …
    <#break>
<#default>
    …
</#switch>

三．循环读取
<#list sequence as item>
<#if item_index == 10>
   ${item.id}
   <#break />
</#if>
…
</#list>
实例：
<#if (post.attachments?size > 0)>
<table width="100%" height="20px" cellpadding="0" cellspacing="0" class="post_bodyTable">
<tbody>
<tr>
<td class="post_body_text" valign="bottom">
相关附件：
<#list post.attachments as attach>
   链接：<a href="${attach.physicalFilename}">${attach.realFilename}</a>&nbsp;
   大小：${attach.filesize}&nbsp;描述：${attach.description}&nbsp;上传日期：${attach.uploadDate}
   <br />
</#list>
</td>
</tr>
</tbody>
</table>
</#if>

<#if (post.attachments?size > 0)>
      <table width="100%" height="20px" cellpadding="0" cellspacing="0" class="post_bodyTable">
       <tbody>
        <tr>
         <td class="post_body_text" valign="bottom">
          相关附件：
          <#list post.attachments as attach>
           链接：<a href="${attach.physicalFilename}">${attach.realFilename}</a>&nbsp;
           大小：${attach.filesize}&nbsp;描述：${attach.description}&nbsp;上传日期：${attach.uploadDate}
           <br />
          </#list>
         </td>
        </tr>
       </tbody>
      </table>
      </#if>

实例：

<#macro className indexNumber>
<#if indexNumber?number%2 != 0>
   <#assign class="commonTR1" />
<#else>
   <#assign class="commonTR2" />
</#if>
${class}
</#macro>

freemarker的Configurartion中有默认的编码为ISO-8859-1所以读取有中文的模板时就会变乱码。

解决办法一：通过修改配置文件freemarker.properties，修改默认编码：

locale=zh_CN
default_encoding=gbk
number_format=#
date_format=yyyy-MM-dd
time_format=HH:mm:Ss
datetime_format=yyyy-MM-dd HH:mm:Ss

解决办法二：通过spring或其他第三方工具配置：

<bean id="freemakerCongfig"

    class="org.springframework.web.servlet.view.freemarker.FreeMarkerConfigurer">

       <property name="templateLoaderPath">

           <value>/WEB-INF/web/</value>

       </property>

       <property name="freemarkerSettings">

       <props>

       <prop key="defaultEncoding">gbk</prop>

       </props>

       </property>

    </bean>

注：org.springframework.web.servlet.view.freemarker.FreeMarkerConfigurer在spring-webmvc.jar 包里面，项目要导入这个jar包才可以，或者会找不到类。

另外，页面编码和charset要跟上面配置的一致才可以，<meta http-equiv="Content-type" content="text/html; charset=gbk">

注意：还有一种常见的导致乱码问题：编辑器或文件保存的编码和页面设置的编码不一致会导致乱码，例如文件的编码(用记事本打开,另存为可以看到文件的编码)为UTF-8而页面的charset=gbk就会出现乱码，反之也一样。

<#list categories as c>
      <#list c.getForums() as f>

     <#if f_index == 0>

      <#assign default_forum_id = "${f.id}" />

     </#if>

    </#list>

</#list>


<div class="forumNameTags" id="forumNameTags">
  ${I18n.getMessage("ForumIndex.forumNameTags")}

<#assign n = 0 />

<#list categories as category>

   <#list category.getForums() as forum>

     <#assign n = n+1 /> 

     <#if n gt 5><#break></#if>//取前五条记录

     <a href="${JForumContext.encodeURL("/forums/show/${forum.id}")}">${forum.name?html}</a>&nbsp;&nbsp;      </#list>

   <#if n gt 5>//在五条记录后面加上一条更多的标签

    <span onclick="showMoreTags('forumNameMoreTags',event,-250,135);"><a href="#this" >${I18n.getMessage("ForumIndex.forumNameTagsMore")}</a></span>

    <#break>

   </#if> 

</#list>

</div>

<div id="forumNameMoreTags" class="popWindow" style="left:0px;top:0px;display:none;">
  <div onclick="hiddenMoreTags('forumNameMoreTags')" class="popWindowTitle">x&nbsp;&nbsp;</div> 

<div class="padding">

<#assign n = 0 />

<#list categories as category>

   <#list category.getForums() as forum>

     <#assign n = n+1 />

     <a href="${JForumContext.encodeURL("/forums/show/${forum.id}")}">${forum.name?html}</a>&nbsp;&nbsp; 

     <#if n gt 2><br/><#assign n = 0 /></#if> //取三条记录

   </#list>

</#list>

</div>

</div>

＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝

生成html

＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝

<div id="forumNameTags" class="forumNameTags">
  热门标签：

     <a href="/apollo/forums/show/1.page">股票大家谈</a>          <a href="/apollo/forums/show/2.page">行业公司研究</a>          <a href="/apollo/forums/show/3.page">投资交易策略</a>          <a href="/apollo/forums/show/4.page">创新产业研究</a>          <a href="/apollo/forums/show/5.page">社区资源下载</a>         <span onclick="showMoreTags('forumNameMoreTags',event,-250,135);"><a href="#this">更多...</a></span>

</div>

<div style="left: 0px; top: 0px; display: none;" class="popWindow" id="forumNameMoreTags">

<div class="popWindowTitle" onclick="hiddenMoreTags('forumNameMoreTags')">x   </div> 

<div class="padding">

     <a href="/apollo/forums/show/1.page">股票大家谈</a>         <a href="/apollo/forums/show/2.page">行业公司研究</a>         <a href="/apollo/forums/show/3.page">投资交易策略</a>         <br/> 

     <a href="/apollo/forums/show/4.page">创新产业研究</a>         <a href="/apollo/forums/show/5.page">社区资源下载</a>         <a href="/apollo/forums/show/7.page">上海个股</a>         <br/> 

     <a href="/apollo/forums/show/6.page">深圳个股</a>         <a href="/apollo/forums/show/8.page">红岭公告区</a>         <a href="/apollo/forums/show/9.page">社区事务处理</a>         <br/> 

     <a href="/apollo/forums/show/10.page">金牌分析师</a>    </div>

</div>

tag_syntax = square_bracket||auto_detect

这也是开发中最常用的方式

————————————————-

classic_compatible=true

可以满足一般需要。默认情况变量为null则替换为空字符串，如果需要自定义，写上${empty!"EmptyValue of fbysss"}的形式即可

———————————————————————–

number_format=#

设置数字格式 以免出现 000.00

—————————————————————

template_update_delay=毫秒

模板延迟加载

<#if listBlogPost?exists && listBlogPost.size != 0 >

<#if Session["cartList"]?exists>       
<#list Session["cartList"] as item>

${pageTitle?default("")}

<#if s?exists>  
${s?if_exists}  
exists用在逻辑判断,而if_exists用来打印东西时用到,如果存在打印,不存在打印空字符串.  
exp1?exists将会被exp1??代替  
exp1?if_exists将会被exp1!代替  
exp1?default(exp2)将会被exp1!exp2.

注：macros里面可以传入多个变量，变量的顺序可以随便写，不传入的变量时为默认值，所有定义变量的时候最好给个默认值。

注：if后面跟的是判断条件，判断条件不能用${变量名}的形式，直接用变量名就可以了

2.条件判断语句 if else
<#if (session.privateMessages > 0)>
${I18n.getMessage("ForumBase.newPm")}: (${session.privateMessages})
<#else>
${I18n.getMessage("ForumBase.privateMessages")}
</#if>

注：if else语句跟普通的不同之处是在中间可以有多句代码，而不是只执行if后面的一句代码

3.嵌套条件判断语句if if else
<#if logged>
<#if !readonly && !replyOnly>
   your code
<#/if>

other code

<#if (session.privateMessages > 0)>
   ${I18n.getMessage("ForumBase.newPm")}: (${session.privateMessages})
<#else>
   ${I18n.getMessage("ForumBase.privateMessages")}
</#if>

other code
</#if>

4.循环指令 list
<#list allCategories as category>
you code
</#list>

<!– 1～3的循环 –>
<#list 1 .. 3 as page>
<@pageLink page, id/>
</#list>

4.嵌套循环指令 list
<#list allCategories as category>
your code:${category.name}

<#list category.getForums() as forum>
   inner code:${category.forum.name}
   <#list moderators as m>
    ${m_index + 1}.${m.name?html}
   </#list>
</#list>

<#if category.name = "">
<#break>
</#if>

other code
</#list>

注：as后面是别名，在循环体中可直接用（类似sql语句表的别名，以用<#break>指令提前结束list循环

。${m_index + 1}.是取list的索引，其中m_index为list的下标，从0开始。

5.导入macros指令 import
<#import "../macros/pagination.ftl" as pagination>
使用：<@pagination.doPagination action, forum.id/>
//<@pagination 为引用macros模板 pagination为对应模板文件的别名
//pagination.doPagination action 为模板文件里面的一个macro－－<#macro doPagination action

id=-1>

6.定义变量指令 assign
<!– 定义一个变量moderators 只能作用于同层或下层 –>
<#assign moderators = forumRepository.getModeratorList(forum.id)/>
<#list moderators as m>
${m.name?html}
</#list>
//其中forumRepository.getModeratorList(forum.id)为变量moderators的值

<#– define a variable to come from pagination.ftl file name as doPagination action macro-

->
<#assign paginationData><@pagination.doPagination action, forum.id/></#assign>
${paginationData}
//其中<@pagination.doPagination action, forum.id/>为变量paginationData的值

7.改变(替换)变量指令 assign
<#assign total = forum.totalPosts/>
<!– 定义一个变量total 值为forum.totalPosts –>
<#if (total == 0 && forum.totalTopics > 0)>
<!– 替换原来变量的值，以后引用total变量的值为forum.totalTopics –>
<#assign total = forum.totalTopics/>
</#if>

8.switch指令
<#switch being.size>
<#case "small">
    This will be processed if it is small
    <#break>
<#case "medium">
    This will be processed if it is medium
    <#break>
<#case "large">
    This will be processed if it is large
    <#break>
<#default>
    This will be processed if it is neither
</#switch>

<#escape x as x?html>
userName: ${userName}
</#escape>
等同于
userName: ${userName?html}

注：escape指令在解析模版时起作用，而不是运行时起作用

9.设置缺省格式指令setting
<#setting number_format = "#"/>
${1.234}
输出1
<#setting number_format="0.##">
${1.234}
输出
1.23

10.包含文件指令 include
<#include "header.htm"/>

除了相关的文本外，在FreeMarker模板中可以包括下面三种特定部分：
${…}：称为插补(interpolations)，FreeMarker会在输出时用实际值进行替代。
指令：也叫FreeMarker标记，与HTML标记类似，但用#开始（有些以@开始，在后面叙述）。
注释：包含在<#– 和 –>（而不是<!–和–>）之间文本。

        顶层变量： ${variable}，变量名只能是字母、数字、下划线、$、@和#的组合，且不能以数字开头

        从散列中获取数据

        可以使用点语法或方括号语法，假设有下面的数据模型：

(root)

|

+- book

|   |

|   +- title = "Breeding green mouses"

|   |

|   +- author

|       |

|       +- name = "Julia Smith"

|       |

|       +- info = "Biologist, 1923-1985, Canada"

|

+- test = "title" 

下面都是等价的：

book.author.name

book["author"].name

book.author.["name"]

book["author"]["name"]

         使用点语法，变量名字有顶层变量一样的限制，但方括号语法没有该限制，因为名字是任意表达式的结果

         从序列获得数据：和散列的方括号语法语法一样，只是方括号中的表达式值必须是数字；注意：第一个项目的索引是0

        序列片断：使用[startIndex..endIndex]语法，从序列中获得序列片断（也是序列）；startIndex和endIndex是结果为数字的表达式

         特殊变量：FreeMarker内定义变量，使用.variablename语法访问

l         字符串操作

         Interpolation（或连接操作）

        可以使用${..}（或#{..}）在文本部分插入表达式的值，例如：

${"Hello ${user}!"}

${"${user}${user}${user}${user}"} 

         可以使用+操作符获得同样的结果

${"Hello " + user + "!"}

${user + user + user + user}

         ${..}只能用于文本部分，下面的代码是错误的：

<#if ${isBig}>Wow!</#if>

<#if "${isBig}">Wow!</#if>

应该写成：

<#if isBig>Wow!</#if>

        子串

        例子（假设user的值为“Big Joe”）：

${user[0]}${user[4]}

${user[1..4]}

结果是（注意第一个字符的索引是0）：

BJ

ig J 

l         序列操作

         连接操作：和字符串一样，使用+，下面是一个例子：

<#list ["Joe", "Fred"] + ["Julia", "Kate"] as user>

- ${user}

</#list>

输出结果是：

- Joe

- Fred

- Julia

- Kate

l         散列操作

         连接操作：和字符串一样，使用+，如果具有相同的key，右边的值替代左边的值，例如：

<#assign ages = {"Joe":23, "Fred":25} + {"Joe":30, "Julia":18}>

- Joe is ${ages.Joe}

- Fred is ${ages.Fred}

- Julia is ${ages.Julia} 

输出结果是：

- Joe is 30

- Fred is 25

- Julia is 18 

l         算术运算

         ＋、－、×、／、％，下面是一个例子：

${x * x - 100}

${x / 2}

${12 % 10}

输出结果是（假设x为5）：

-75

2.5

2 

         操作符两边必须是数字，因此下面的代码是错误的：

${3 * "5"} <#-- WRONG! --> 

        使用+操作符时，如果一边是数字，一边是字符串，就会自动将数字转换为字符串，例如：

${3 + "5"} 

输出结果是：

35

        使用内建的int（后面讲述）获得整数部分，例如：

${(x/2)?int}

${1.1?int}

${1.999?int}

${-1.1?int}

${-1.999?int}

输出结果是（假设x为5）：

2

1

1

-1

-1

l         比较操作符

        使用=（或==，完全相等）测试两个值是否相等，使用!= 测试两个值是否不相等

        =和!=两边必须是相同类型的值，否则会产生错误，例如<#if 1 = "1">会引起错误

        Freemarker是精确比较，所以对"x"、"x "和"X"是不相等的

        对数字和日期可以使用<、<=、>和>=，但不能用于字符串

        由于Freemarker会将>解释成FTL标记的结束字符，所以对于>和>=可以使用括号来避免这种情况，例如<#if (x > y)>

        另一种替代的方法是，使用lt、lte、gt和gte来替代<、<=、>和>=

l         逻辑操作符

        &&（and）、||（or）、!（not），只能用于布尔值，否则会产生错误

       例子：

<#if x < 12 && color = "green">

 We have less than 12 things, and they are green.

</#if>

<#if !hot> <#-- here hot must be a boolean -->

 It's not hot.

</#if> 

l         内建函数

         内建函数的用法类似访问散列的子变量，只是使用“?”替代“.”，下面列出常用的一些函数

        字符串使用的：

         html：对字符串进行HTML编码

         cap_first：使字符串第一个字母大写

         lower_case：将字符串转换成小写

         upper_case：将字符串转换成大写

         trim：去掉字符串前后的空白字符

         序列使用的：

         size：获得序列中元素的数目

         数字使用的：

         int：取得数字的整数部分（如-1.9?int的结果是-1）

         例子（假设test保存字符串"Tom & Jerry"）：

${test?html}

${test?upper_case?html}

输出结果是：

Tom & Jerry

TOM & JERRY 

l         操作符优先顺序

操作符组

操作符

后缀

[subvarName] [subStringRange] . (methodParams)

一元

+expr、-expr、!

内建

?

乘法

*、 / 、%

加法

+、-

关系

<、>、<=、>=（lt、lte、gt、gte）

相等

==（=）、!=

逻辑and

&&

逻辑or

||

数字范围

..

（4）Interpolation

l         Interpolation有两种类型：

         通用Interpolation：${expr}

         数字Interpolation：#{expr}或#{expr; format}

l         注意：Interpolation只能用于文本部分

l         通用Interpolation

         插入字符串值：直接输出表达式结果

         插入数字值：根据缺省格式（由#setting指令设置）将表达式结果转换成文本输出；可以使用内建函数string格式化单个Interpolation，下面是一个例子：

<#setting number_format="currency"/>

<#assign answer=42/>

${answer}

${answer?string} <#-- the same as ${answer} -->

${answer?string.number}

${answer?string.currency}

${answer?string.percent} 

输出结果是：

$42.00

$42.00

42

$42.00

4,200%

         插入日期值：根据缺省格式（由#setting指令设置）将表达式结果转换成文本输出；可以使用内建函数string格式化单个Interpolation，下面是一个使用格式模式的例子：

${lastUpdated?string("yyyy-MM-dd HH:mm:ss zzzz")}

${lastUpdated?string("EEE, MMM d, ''yy")}

${lastUpdated?string("EEEE, MMMM dd, yyyy, hh:mm:ss a '('zzz')'")} 

输出的结果类似下面的格式：

2003-04-08 21:24:44 Pacific Daylight Time

Tue, Apr 8, '03

Tuesday, April 08, 2003, 09:24:44 PM (PDT)

         插入布尔值：根据缺省格式（由#setting指令设置）将表达式结果转换成文本输出；可以使用内建函数string格式化单个Interpolation，下面是一个例子：

<#assign foo=true/>

${foo?string("yes", "no")}

输出结果是：

yes

l         数字Interpolation的#{expr; format}形式可以用来格式化数字，format可以是：

         mX：小数部分最小X位

         MX：小数部分最大X位

         例子：

           <#-- If the language is US English the output is: -->

<#assign x=2.582/>

<#assign y=4/>

#{x; M2}   <#-- 2.58 -->

#{y; M2}   <#-- 4    -->

#{x; m1}   <#-- 2.6 -->

#{y; m1}   <#-- 4.0 -->

#{x; m1M2} <#-- 2.58 -->

#{y; m1M2} <#-- 4.0 --> 

缺省值: name!"unknown" 或者 (user.name)!"unknown" 或者 name! 或者 (user.name)!

null值检查: name?? or (user.name)??

如果想打印${，则需要将{转义，可以写成"$\{user}"，或者可以用生字符（r指令）：$(r "${xx}"}
序列构成：<#list ["winter", "spring", "summer", "autumn"] as x>${x}</#list>
不同的对象可以存放在一个序列里面，比如：[2 + 2, [1, 2, 3, 4], "whatnot"]. 第一个是数字，第二个是序列，第三个是字符串。
可用采用start..end的方式来定义一个数字序列，start可以小于end，同时，end也可以省略。
hash取值支持一下四种模式：book.author.name, book["author"].name, book.author.["name"], book["author"]["name"].

特殊变量是指freemaker引擎本身定义的变量。访问时，以.variable_name的语法访问。
变量表达式支持嵌套模式，比如：${"Hello ${user}!"}。
变量表达式在指令中的使用情况：
变量表达式可以在指令中，用“”的方式存在，不如：<#include "/footer/${company}.html">.
但是不允许下面的方式存在： <#if ${isBig}>Wow!</#if>, 正确写法是：<#if isBig>Wow!</#if>.
而且 <#if "${isBig}">Wow!</#if>写法也不正确，因为"${isBig}"返回的是字符串，不是boolean类型。

字符串中取字符或字符串采用以下语法：${user[0]},${user[0..2]} ${user[4..]},${user?string(4)}
序列操作：
    加法：<#list ["Joe", "Fred"] + ["Julia", "Kate"] as user> 但要注意串联之后的读取速度变慢。
    子序列：seq[1..4]
序列和hash的串联都只能用于两个相加，不能有多个相加的模式，hash相加，如果两个相加的hash存在相同的key，则后面会覆盖前面的。
在使用>=或者>时，需要注意一些问题，因为freemaker会将>解释成标记的关闭符，为了解决这个问题，需要在表达式加上括号，比如： <#if (x > y)>. 或者使用 &gt; and &lt符号来代替。
无值变量（包括无该变量，null，返回void，无属性等）：unsafe_expr!default_expr or unsafe_expr! or (unsafe_expr)!default_expr or (unsafe_expr)!
缺省值可以是任何类型，不一定是数字，比如：hits!0 或者 colors!["red", "green", "blue"].
如果缺省值忽略，那么将会默认为空串、空序列或者空hash，因为freemarker支持多类型的值。不过要让默认值为0或false，则不能省略缺省值。
非顶层变量的无值处理：
    product.color!"red"：只处理product不为空，color为空的缺省值处理，如果product为空，则freemaker会抛出异常。(product.color)!"red"：则会处理product为空，color为空，或者没有color属性的无值情况。
无值变量的判断操作：unsafe_expr?? or (unsafe_expr)??

判断变量是否是无值。
普通变量插入方式: ${expression},${3+5);
数字变量插入方式: #{expression} or #{expression; format}：过期。
变量只能用于文本区或者是字符串里面，比如：<h1>Hello ${name}!</h1>以及 <#include "/footer/${company}.html">
数字值的插入：根据缺省的number_format输出，以及可以通过setting来达到设置数字格式的目的，也可以通过内置函数string来改变输出格式。
日期类型的格式设置：date_format, time_format 和 datetime_format
定义宏：
    不带参数：<#macro 宏名>...</#macro>，引用<@宏名 />
    带参数：<#macro 宏名 参数...>...</#macro>，引用<@宏名 参数1=值1.../>，带有参数的宏，调用是参数的值必须和参数的个数相同。当然也可以在宏定义时给参数一些默认值。比如：<#macro greet person color="black">
宏里面的嵌套内容：
<#macro border>
   <table border=4 cellspacing=0 cellpadding=4><tr><td>
<#nested>
   </tr></td></table>
</#macro>
在宏的定义body中加入<#nested>指令。嵌套的内容可以是任何正确的ftl块。
宏的本地变量在嵌套内容中是不可见的。
宏定义时，<#nest>指令相当于调用定义的内容，而使用宏时，nest body相当于定义。

<#macro repeat count>   <#list 1..count as x>     <#nested x, x/2, x==count>   </#list></#macro><@repeat count=4 ; c, halfc, last>   ${c}. ${halfc}<#if last> Last!</#if></@repeat> 

定义变量：

    在模板中定义的变量将会隐藏（不是更改）数据模型根下面的同名的变量。

模板中的3种类型变量：

    1：plain variables，能够在模板中的任何地方访问，一个模板include另外一个模板，也可以访问被包含模板的变量。可以通过assign或者macro指令产生或替换变量。

    如果要访问数据模型中的变量，则可以通过.global来访问：

    <#assign user = "Joe Hider">

    ${user}           <#– prints: Joe Hider –>

    ${.globals.user} <#– prints: Big Joe–>

    2：Local variables，宏定义body中用local指令创建或者替换。

    3：Loop variables:由list指令产生。

namespaces:

<#import "/lib/my_test.ftl" as my> <#– the hash called "my" will be the "gate" –>

<@my.copyright date="1999-2002"/>

${my.mail}

设置命名空间里面的变量：<#assign mail="jsmith@other.com" in my>

命名空间与数据模型：命名空间的ftl可以访问数据模型的变量。同样命名空间的变量也会隐藏数据模型中同名的变量。

空白问题：

1：White-space stripping，默认为enabled，清除ftl标记带来的空白以及缩进。处理模板的空白。

2：t, rt, lt指令。

3：ftl的参数strip_text.

用compress directive或者transform来处理输出。

<#compress>…</#compress>：消除空白行。

<@compress single_line=true>…/@compress将输出压缩为一行。

可替换语法：

freemarker可用"["代替"<".在模板的文件开头加上[#ftl].

    宏的定义可以查看相关的文档，里面介绍得很清楚，下面来看看它的一个用法（javaeye帖子里有讨论）。

    /WEB-INF/template/common/common.ftl：

<#macro html title>
        <head>
        <meta http-equiv="Content-Type" content="text/html; charset=GBK" />
        <title>${title}</title>
        <link rel="stylesheet" rev="stylesheet" href="/oa/file/css.css" type="text/css" media="all" />
        </head>

        <body>
        <#nested/>
        </body>

        </html>
</#macro>

    然后在freemarker.properties里定义：
auto_import=/WEB-INF/template/common/common.ftl as c

    然后其他的ftl文件就可以使用它了

    test.ftl：
    <@c.html title="OA">
      你的内容
    </@c.html>

    如果不在freemarker.properties里定义，可以在每个文件里包含这个ftl：
<#import "/WEB-INF/template/common/common.ftl" as c>

    不同的场合有不同的运用。使用得好的话，将会大大节省你的开发时间。

macro, nested, return
语法

<#macro name param1 param2 … paramN>
…
<#nested loopvar1, loopvar2, …, loopvarN>
…
<#return>
…
</#macro>
用例
<#macro test foo bar="Bar" baaz=-1>
Test text, and the params: ${foo}, ${bar}, ${baaz}
</#macro>
<@test foo="a" bar="b" baaz=5*5-2/>
<@test foo="a" bar="b"/>
<@test foo="a" baaz=5*5-2/>
<@test foo="a"/>

输出

Test text, and the params: a, b, 23
Test text, and the params: a, b, -1
Test text, and the params: a, Bar, 23
Test text, and the params: a, Bar, -1

定义循环输出的宏

<#macro list title items>
<p>${title?cap_first}:
<ul>
       <#list items as x>
         <li>${x?cap_first}
       </#list>
</ul>
</#macro>
<@list items=["mouse", "elephant", "python"] title="Animals"/>

输出结果
<p>Animals:
<ul>
         <li>Mouse
         <li>Elephant
         <li>Python
</ul>

包含body的宏

<#macro repeat count>
<#list 1..count as x>
       <#nested x, x/2, x==count>
</#list>
</#macro>
<@repeat count=4 ; c halfc last>
${c}. ${halfc}<#if last> Last!</#if>
</@repeat>

输出

1. 0.5
2. 1
3. 1.5
4. 2 Last!

——————————————————————————–

注意在使用的时候：别忘了双引号。

<#import "/pagelibs/book.ftl" as book>

<@workorder.price value="${book.price}" />

宏Macro
宏是在模板中使用macro指令定义

l.1 基本用法

宏是和某个变量关联的模板片断，以便在模板中通过用户定义指令使用该变量，下面是一个例子：

<#macro greet> <font size="+2">Hello Joe!</font></#macro>
调用宏时，与使用FreeMarker的其他指令类似，只是使用@替代FTL标记中的#。

<@greet></@greet> <#–<@greet/>–>
在macro指令中可以在宏变量之后定义参数，如：

<#macro greet person> <font size="+2">Hello ${person}!</font></#macro>
可以这样使用这个宏变量：

<@greet person="Fred"/>
但是下面的代码具有不同的意思：

<@greet person=Fred/>
这意味着将Fred变量的值传给person参数，该值不仅是字符串，还可以是其它类型，甚至是复杂的表达式。

宏可以有多参数，下面是一个例子：

<#macro greet person color> <font size="+2" color="${color}">Hello ${person}!</font></#macro>
可以这样使用该宏变量，其中参数的次序是无关的：

<@greet person="Fred" color="black"/>
可以在定义参数时指定缺省值，否则，在调用宏的时候，必须对所有参数赋值：

<#macro greet person color="black"> <font size="+2" color="${color}">Hello ${person}!</font></#macro>
注意：宏的参数是局部变量，只能在宏定义中有效。

嵌套内容
FreeMarker的宏可以有嵌套内容，<#nested>指令会执行宏调用指令开始和结束标记之间的模板片断，举一个简单的例子：

<#macro border> <table border=4 cellspacing=0 cellpadding=4><tr><td>    <#nested> </tr></td></table></#macro>
执行宏调用：

<@border>The bordered text</@border>
输出结果：

<table border=4 cellspacing=0 cellpadding=4><tr><td>    The bordered text </tr></td></table>
<#nested>指令可以被多次调用，每次都会执行相同的内容。

<#macro do_thrice> <#nested> <#nested> <#nested></#macro><@do_thrice> Anything.</@do_thrice>
FMPP 输出结果：

Anything.Anything.Anything.
嵌套内容可以是有效的FTL，下面是一个有些复杂的例子，我们将上面三个宏组合起来：

<@border> <ul> <@do_thrice>    <li><@greet person="Joe"/> </@do_thrice> </ul></@border>
输出结果：

<table border=4 cellspacing=0 cellpadding=4><tr><td> <ul>    <li><font size="+2">Hello Joe!</font><li><font size="+2">Hello Joe!</font><li><font size="+2">Hello Joe!</font></ul></tr></td></table>
宏定义中的局部变量对嵌套内容是不可见的，例如：

<#macro repeat count> <#local y = "test"> <#list 1..count as x>    ${y} ${count}/${x}: <#nested> </#list></#macro><@repeat count=3>${y?default("?")} ${x?default("?")} ${count?default("?")}</@repeat>
输出结果：

test 3/1: ? ? ?test 3/2: ? ? ?test 3/3: ? ? ?
在宏定义中使用循环变量
nestted指令也可以有循环变量（循环变量的含义见下节），调用宏的时候在宏指令的参数后面依次列出循环变量的名字，格式如下：

<@ macro_name paramter list; loop variable list[,]>
例如：

<#macro repeat count> <#list 1..count as x>    <#nested x, x/2, x==count> </#list></#macro><@repeat count=4 ; c, halfc, last> ${c}. ${halfc}<#if last> Last!</#if></@repeat>
这里count是宏的参数，c, halfc,last则为循环变量，输出结果：

1. 0.5 2. 1 3. 1.5 4. 2 Last!
循环变量和宏标记指定的不同不会有问题，如果调用时少指定了循环变量，那么多余的值不可见。调用时多指定了循环变量，多余的循环变量不会被创建：

<@repeat count=4 ; c, halfc, last> ${c}. ${halfc}<#if last> Last!</#if></@repeat><@repeat count=4 ; c, halfc> ${c}. ${halfc}</@repeat><@repeat count=4> Just repeat it…</@repeat>
在模板中定义变量
在模板中定义的变量有三种类型：

plain变量：可以在模板的任何地方访问，包括使用include指令插入的模板，使用assign指令创建和替换。
局部变量：在宏定义体中有效，使用local指令创建和替换。
循环变量：只能存在于指令的嵌套内容，由指令（如list）自动创建；宏的参数是局部变量，而不是循环变量
局部变量隐藏（而不是覆盖）同名的plain变量；循环变量隐藏同名的局部变量和plain变量，下面是一个例子：

<#assign x = "plain">${x} <#– we see the plain var. here –><@test/>6. ${x} <#– the value of plain var. was not changed –><#list ["loop"] as x>    7. ${x} <#– now the loop var. hides the plain var. –>    <#assign x = "plain2"> <#– replace the plain var, hiding does not mater here –>    8. ${x} <#– it still hides the plain var. –></#list>9. ${x} <#– the new value of plain var. –><#macro test> 2. ${x} <#– we still see the plain var. here –> <#local x = "local"> 3. ${x} <#– now the local var. hides it –> <#list ["loop"] as x>    4. ${x} <#– now the loop var. hides the local var. –> </#list> 5. ${x} <#– now we see the local var. again –></#macro>
输出结果：

1. plain 2. plain 3. local 4. loop 5. local 6. plain 7. loop 8. loop 9. plain2
内部循环变量隐藏同名的外部循环变量，如：

<#list ["loop 1"] as x> ${x} <#list ["loop 2"] as x>    ${x}    <#list ["loop 3"] as x>      ${x}    </#list>    ${x} </#list> ${x}</#list>
输出结果：

loop 1    loop 2      loop 3    loop 2 loop 1
模板中的变量会隐藏（而不是覆盖）数据模型中同名变量，如果需要访问数据模型中的同名变量，使用特殊变量global，下面的例子假设数据模型中的user的值是Big Joe：

<#assign user = "Joe Hider">${user}          <#– prints: Joe Hider –>${.globals.user} <#– prints: Big Joe –>
名字空间
通常情况，只使用一个名字空间，称为主名字空间，但为了创建可重用的宏、变换器或其它变量的集合（通常称库），必须使用多名字空间，其目的是防止同名冲突

创建库
下面是一个创建库的例子（假设保存在lib/my_test.ftl中）：

<#macro copyright date> <p>Copyright (C) ${date} Julia Smith. All rights reserved. <br>Email: ${mail}</p></#macro> <#assign mail = "jsmith@acme.com">
使用import指令导入库到模板中，Freemarker会为导入的库创建新的名字空间，并可以通过import指令中指定的散列变量访问库中的变量：

<#import "/lib/my_test.ftl" as my><#assign mail="fred@acme.com"><@my.copyright date="1999-2002"/>${my.mail}${mail}
输出结果：

<p>Copyright (C) 1999-2002 Julia Smith. All rights reserved. <br>Email: jsmith@acme.com</p>jsmith@acme.comfred@acme.com
可以看到例子中使用的两个同名变量并没有冲突，因为它们位于不同的名字空间。还可以使用assign指令在导入的名字空间中创建或替代变量，下面是一个例子：

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

jsmith@acme.comjsmith@other.com
数据模型中的变量任何地方都可见，也包括不同的名字空间，下面是修改的库：

<#macro copyright date> <p>Copyright (C) ${date} ${user}. All rights reserved.</p></#macro><#assign mail = "${user}@acme.com">
假设数据模型中的user变量的值是Fred，则下面的代码：

<#import "/lib/my_test.ftl" as my><@my.copyright date="1999-2002"/>${my.mail}
输出结果：

<p>Copyright (C) 1999-2002 Fred. All rights reserved.</p>Fred@acme.com
选择Velocity还是FreeMarker?
Velocity是另外一个优秀的模板引擎，它是FreeMarker的有力竞争者。但是它的模板语言不够强大，也不够严谨。

除开FreeMarker内建的Velocity所没有的强大函数外，FreeMarker还在以下方面更胜一筹：

与Velocity 相比，FreeMarker 对表现逻辑和业务逻辑的划分更为严格，Freemarker在模板中不允许对Servlet API进行直接操作（而Velocity可以），如FreeMarker 中禁止对HttpServletRequest 对象直接访问（但可以访问HttpServletRequest对象中的Attribute）。通过更加严格的隔离机制，牵涉逻辑处理的操作被强制转移到逻辑层。从而完全保证了层次之间的清晰性。

另外一个Velocity无法实现的特性，也是最具备实际意义的特性：FreeMarker提供了强大的宏。

此 外，FreeMarker对JSP Tag提供了良好支持。我们可以将FreeMarker看作是仅允许使用TAG的JSP页面（实际上，FreeMarker的表达式语法与EL语法也非常类似）。从开发角度而言，只允许使用TAG的JSP页面，已经在很大程度上保证了页面表现逻辑与业务逻辑的分离。程序员在JSP Script中混杂逻辑代码的原因，大部分是出于慵懒，只要无法在页面模板中直接编写Java代码，相信程序员也不会去专门编写一个JSP TAG来刻意违反层次划分原则。

原来的例子：http://javadou.com/freemarker-how-to-use-135/

BuildHTML.java

package example;
import java.io.*;
import java.util.*;
import javax.servlet.ServletException;
import javax.servlet.http.*;
import freemarker.template.*;
public class BuildHTML extends HttpServlet{
  private Configuration cfg;

  public void init()

  {   
//初始化FreeMarker配置        
 //创建一个Configuration实例        
cfg = new Configuration();        
//设置FreeMarker的模版文件位置   
cfg.setServletContextForTemplateLoading(getServletContext(),"templates");

  }

public void doGet(HttpServletRequest request,HttpServletResponse response) throws ServletException,IOException
  {   
//建立数据模型    Map root = new HashMap();   
//放入对应数据key value    root.put("user","zdz");   
//取得模版文件    Template t =cfg.getTemplate("hello.ftl");   
 //开始准备生成输出,输出到文件中    File file = new File(getServletContext().getRealPath("/") + "/hello.html");         if (!file.exists())             file.createNewFile();         Writer out = new FileWriter(file);    //合并数据模型和模版，并将结果输出到out中    try    {     t.process(root,out);// 用模板来开发servlet可以只在代码里面加入动态的数据    }    catch(TemplateException e)    {     throw new ServletException("处理Template模版中出现错误", e);    }

  }

  }

web.xml的配置

<?xml version="1.0" encoding="UTF-8"?>
  <web-app version="2.4" xmlns="http://java.sun.com/xml/ns/j2ee"

  xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"

  xsi:schemaLocation="http://java.sun.com/xml/ns/j2ee

  http://java.sun.com/xml/ns/j2ee/web-app_2_4.xsd">

  <servlet>    <servlet-name>Hello</servlet-name>    <servlet-class>example.Hello</servlet-class>

  </servlet>

  <servlet-mapping>    <servlet-name>Hello</servlet-name>    <url-pattern>*.do</url-pattern>

  </servlet-mapping>

  <servlet>    <servlet-name>BuildHTML</servlet-name>    <servlet-class>example.BuildHTML</servlet-class>

  </servlet>

  <servlet-mapping>    <servlet-name>BuildHTML</servlet-name>    <url-pattern>*.b</url-pattern>

  </servlet-mapping>

  <welcome-file-list>    <welcome-file>index.html</welcome-file>

  </welcome-file-list>

  </web-app>

========================

打开ie输入http://localhost:8080/testFM/zdz.b

则在D:\Tomcat 5.5\webapps\testFM目录下生成了hello.html

效果跟http://localhost:8080/testFM/hello.do 一样，以后就可以直接访问这个html页面了，更新内容只要执行下xxx.b就可以了。

<action name="Action1" class="com.abc.Action1">
  <result>/page.jsp</result>

</action>

这里的view是一个jsp页面，也可以改成是一个freemarker模板页面：

<action name="Action1" class="com.abc.Action1">
  <result type="freemarker">/fm.ftl</result>

</action>

当然我们希望能在fm.ftl上使用struts2的标签，需要在fm.ftl页面最开始添加对struts2标签的引用：

<#assign s=JspTaglibs["/WEB-INF/struts-tags.tld"] />

引用前把struts2-core-2.0.x.x.jar包里的META-INF/struts-tags.tld 复制到 /WEB-INF/struts-tags.tld

默认是不支持JspTaglibs的引用的，这里还需要一个额外的配置，修改web.xml，添加如下内容：

<servlet>
  <servlet-name>JspSupportServlet</servlet-name>

<servlet-class>

             org.apache.struts2.views.JspSupportServlet

</servlet-class>

<load-on-startup>1</load-on-startup>

</servlet>

一个简单的fm.ftl文件的例子：

<#assign s=JspTaglibs["/WEB-INF/struts-tags.tld"] />
  <html>

<head>

<meta http-equiv="Content-Type" content="text/html; charset=GB2312">

<title>Insert title here</title>

</head>

<body>

<@s.form action="Action1.action">

<@s.textfield name="username"></@s.textfield>

<@s.textfield name="password"></@s.textfield>

<@s.submit value="提交"/>

</@s.form>

<br/>登录用户名：${username}

</body>

</html>

注意：struts2在freemarker页面中标签写法和jsp页面的写法不同，freemarker里是<@s.form>，jsp里是<s:form>，一定不要写错了！

使用时发现对中文的支持不好，显示时中文出现乱码，这里修改下struts.xml配置文件：

<constant name="struts.i18n.encoding" value="gb2312" />

现在就可以在struts2中正常使用freemarker了!

package example;
  import java.util.*;

import java.io.*;

import freemarker.template.*;


public class HelloFreeMarker
  {

    private Configuration cfg; 

    public void init() throws Exception

{

        //初始化FreeMarker配置

        //创建一个Configuration实例

        cfg = new Configuration();

        //设置FreeMarker的模版文件位置

        cfg.setDirectoryForTemplateLoading(new File("WebRoot/templates"));//这个路径一定要设置正确

    }

public void process()throws Exception

{

        Map root = new HashMap();

        root.put("name", "zdz"); 

   root.put("msg" , "您已经完成了一个FreeMarker的示例");

        Template t = cfg.getTemplate("runInMain.ftl");

        t.process(root, new OutputStreamWriter(System.out));

}

public static void main(String[] args)throws Exception
  {

   HelloFreeMarker hf = new HelloFreeMarker();

   hf.init();

   hf.process(); 

}

}

＝＝＝＝＝＝＝＝＝＝＝

加入一个模板runInMain.ftl

====================

${name}，你好！${msg}

====================

用elcipse运行java类，

如果在控制台看到：

zdz，你好！您已经完成了一个FreeMarker的示例

则说明成功了。

＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝＝

除了相关的文本外，在FreeMarker模板中可以包括下面三种特定部分：

1. ${…}：称为插补(interpolations)，FreeMarker会在输出时用实际值进行替代。
2. 指令：也叫FreeMarker标记，与HTML标记类似，但用#开始（有些以@开始，在后面叙述）。
3. 注释：包含在<#– 和 –>（而不是<!–和–>）之间文本。

控制指令

if指令

if指令与大部分程式语言一样，也支持<#else if..>，不再赘述。

<#if animals.python.price < animals.elephant.price>   Pythons are cheaper than elephants today.<#else>   Pythons are not cheaper than elephants today.</#if>

list指令

list指令将遍历Sequences里的每一个元素。list指令有两个隐含的特殊变量：

1. item_index 该变量将返回元素在Sequences里的索引值。
2. item_has_next 该变量是boolean型，false表明该元素是Sequences里的最后一个元素。

<p>We have these animals:<table border=1>   <tr><th>Id<th>Name<th>Price   <#list animals as being>   <tr><td>${being_index+1}<td>${being.name}<td>${being.price} Euros   </#list></table>

上面的模板可以依次列印出三种动物的名字和价格，being_index和being_has_next则是它的特殊变量。

可以用<#break>指令提前结束list循环。

switch指令

与其他语言的switch语句类似。

<#switch being.size>   <#case "small">      This will be processed if it is small      <#break>   <#case "medium">      This will be processed if it is medium      <#break>   <#case "large">      This will be processed if it is large      <#break>   <#default>      This will be processed if it is neither</#switch>

<#escape x as x?html>

First name: ${firstName}

Last name: ${lastName}

Maiden name: ${maidenName}</#escape>

等同于：

First name: ${firstName?html}

Last name: ${lastName?html}

Maiden name: ${maidenName?html}

escape指令在解析模版时起作用，而不是运行时起作用。

escape指令还能嵌套使用，子继承父的escape规则。

<#escape x as x?html>

Customer Name: ${customerName}

Items to ship:

<#escape x as itemCodeToNameMap[x]>

${itemCode1}

${itemCode2}

${itemCode3}

${itemCode4}

</#escape></#escape>

等同于：Customer Name: ${customerName?html}

Items to ship:

${itemCodeToNameMap[itemCode1]?html}

${itemCodeToNameMap[itemCode2]?html}

${itemCodeToNameMap[itemCode3]?html}

${itemCodeToNameMap[itemCode4]?html}

九：assign指令

<#assign name=value>
or
<#assign name1=value1name2=value2... nameN=valueN>
or
<#assign same as above... in namespacehash>
or
<#assign name>   capture this
</#assign>
or
<#assign name in namespacehash>   capture this
</#assign>创建或者替换一个已经存在的变量，只能作用于顶层变量。
不好的做法：<#assign x>Hello ${user}!</#assign>更改为：<#assign x="Hello ${user}!">

十：global指令

<#global name=value>

or

<#global name1=value1name2=value2... nameN=valueN>or<#global name>

</#global>

十一：local指令

<#local name=value>

or

<#local name1=value1name2=value2... nameN=valueN>or<#local name>

</#local>只能用于macro的定义body中。

十二：setting指令：

<#setting name=value>

name的取值范围：

local：number_format：

boolean_format:缺省值为"true,false"

date_format, time_format, datetime_format

time_zone：url_escaping_charset

classic_compatible

十三：用户自定义指令

<@macro_or_transfparam1=val1param2=val2...paramN=valN/><@macro_or_transfparam1=val1param2=val2...paramN=valN ; lv1, lv2, ..., lvN/><@macro_or_transf...>    ...
</@macro_or_transf>

<@macro_or_transf...>    ...
</@><@macro_or_transfval1, val2, ..., valN/>

十四：macro,nested,return

<#macro nameparam1param2… paramN>

…

<#nested loopvar1, loopvar2, …, loopvarN>

…

<#return>

…

</#macro>

十五：function, return

<#function nameparam1param2… paramN>

… <#return returnValue>

…

</#function>

<#function avg x y>

<#return (x + y) / 2>

</#function>

${avg(10, 20)}

十六：flush

<#flush>

十七：stop

<#stop>

or

<#stop reason>取消处理模版。

十八：ftl指令

<#ftl param1=value1param2=value2…paramN=valueN>

ftl指令必须放在ftl文件的最上面。

参数范围：

encoding：

strip_whitespace

strip_text

strict_syntax

十九：t, lt, rt

二十：attempt, recover

<#attempt>

attempt block<#recover>

recover block

</#attempt>

<#attempt>

Optional content: ${thisMayFails}

<#recover>

Ops! The optional content is not available.

</#attempt>

<#escape x as x?html>

First name: ${firstName}

Last name: ${lastName}

Maiden name: ${maidenName}</#escape>

等同于：

First name: ${firstName?html}

Last name: ${lastName?html}

Maiden name: ${maidenName?html}

escape指令在解析模版时起作用，而不是运行时起作用。

escape指令还能嵌套使用，子继承父的escape规则。

<#escape x as x?html>

Customer Name: ${customerName}

Items to ship:

<#escape x as itemCodeToNameMap[x]>

${itemCode1}

${itemCode2}

${itemCode3}

${itemCode4}

</#escape></#escape>

等同于：Customer Name: ${customerName?html}

Items to ship:

${itemCodeToNameMap[itemCode1]?html}

${itemCodeToNameMap[itemCode2]?html}

${itemCodeToNameMap[itemCode3]?html}

${itemCodeToNameMap[itemCode4]?html}

九：assign指令

<#assign name=value>
or
<#assign name1=value1name2=value2... nameN=valueN>
or
<#assign same as above... in namespacehash>
or
<#assign name>
  capture this
</#assign>
or
<#assign name in namespacehash>
  capture this
</#assign>创建或者替换一个已经存在的变量，只能作用于顶层变量。
不好的做法：<#assign x>Hello ${user}!</#assign>更改为：<#assign x="Hello ${user}!">

十：global指令

<#global name=value>

or

<#global name1=value1name2=value2... nameN=valueN>or<#global name>

</#global>

十一：local指令

<#local name=value>

or

<#local name1=value1name2=value2... nameN=valueN>or<#local name>

</#local>只能用于macro的定义body中。

十二：setting指令：

<#setting name=value>

name的取值范围：

local：number_format：

boolean_format:缺省值为"true,false"

date_format, time_format, datetime_format

time_zone：url_escaping_charset

classic_compatible

十三：用户自定义指令

<@macro_or_transfparam1=val1param2=val2...paramN=valN/><@macro_or_transfparam1=val1param2=val2...paramN=valN ; lv1, lv2, ..., lvN/><@macro_or_transf...>
  ...
</@macro_or_transf>

<@macro_or_transf...>
  ...
</@><@macro_or_transfval1, val2, ..., valN/>

十四：macro,nested,return

<#macro nameparam1param2… paramN>

…

<#nested loopvar1, loopvar2, …, loopvarN>

…

<#return>

…

</#macro>

十五：function, return

<#function nameparam1param2… paramN>

… <#return returnValue>

…

</#function>

<#function avg x y>

<#return (x + y) / 2>

</#function>

${avg(10, 20)}

十六：flush

<#flush>

十七：stop

<#stop>

or

<#stop reason>取消处理模版。

十八：ftl指令

<#ftl param1=value1param2=value2…paramN=valueN>

ftl指令必须放在ftl文件的最上面。

参数范围：

encoding：

strip_whitespace

strip_text

strict_syntax

十九：t, lt, rt

二十：attempt, recover

<#attempt>

attempt block<#recover>

recover block

</#attempt>

<#attempt>

Optional content: ${thisMayFails}

<#recover>

Ops! The optional content is not available.

</#attempt>

<html>

<head>

<title>hello!</title>

</head>

<body>

<h1>hello ${user}!</h1>

</body>

</html>

4. 在src目录下创建example包 和Hello.java文件，代码如下：

package example;

import java.io.*;

import java.util.*;


import javax.servlet.ServletException;
  import javax.servlet.http.*;

import freemarker.template.*;

public class Hello extends HttpServlet{
  private Configuration cfg;

public void init()

{

   //初始化FreeMarker配置

        //创建一个Configuration实例

        cfg = new Configuration();

        //设置FreeMarker的模版文件位置

   cfg.setServletContextForTemplateLoading(getServletContext(),"templates");

}

public void doGet(HttpServletRequest request,HttpServletResponse response) throws ServletException,IOException
  {

   //建立数据模型

   Map root = new HashMap();

   //放入对应数据key value

   root.put("user","zdz");

   //取得模版文件

   Template t =cfg.getTemplate("hello.ftl");

   //开始准备生成输出

        //使用模版文件的charset作为本页面的charset

        //使用text/html MIME-type

        response.setContentType("text/html; charset=" + t.getEncoding());

   PrintWriter out = response.getWriter();

   //合并数据模型和模版，并将结果输出到out中

   try

   {

    t.process(root,out);// 用模板来开发servlet可以只在代码里面加入动态的数据

   }

   catch(TemplateException e)

   {

    throw new ServletException("处理Template模版中出现错误", e);

   }

}

}

5.配置web.xml 代码如下：

<?xml version="1.0" encoding="UTF-8"?>
  <web-app version="2.4" 

xmlns="http://java.sun.com/xml/ns/j2ee" 

xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" 

xsi:schemaLocation="http://java.sun.com/xml/ns/j2ee

http://java.sun.com/xml/ns/j2ee/web-app_2_4.xsd">

<servlet>

    <servlet-name>Hello</servlet-name>

    <servlet-class>example.Hello</servlet-class>

</servlet>

<servlet-mapping>

    <servlet-name>Hello</servlet-name>

    <url-pattern>*.do</url-pattern>

</servlet-mapping>

<welcome-file-list>

      <welcome-file>index.html</welcome-file>

</welcome-file-list>

</web-app>

6.在WebRoot下面新建引导页面index.html，代码如下：

<html>
  <head>

<title>Hello FreeMarker Example</title>

<meta http-equiv="Content-type" content="text/html; charset=utf-8">

</head>

<body>

点击下面链接看看效果：

<hr>

<a href="hello.do">调用Hello模板</a> 

</body>

</html>

7.把testFM项目部署到tomcate并启动服务。

8.打开浏览器，输入地址：http://localhost:8080/testFM/

9.点击调用Hello模板 链接，如果出现hello zdz!则说明模板调用成功了！

1. String内置的JavaScript转换： js_string
用途：用于JavaScript转义，转换’,",换行等特殊字符
模板: <script>
alert("${errorMessage?js_string}");
</script>
输出: <script>
alert("Readonly\’s pet name is \"Cross Bone\"");
</script>

2.内置的默认值处理：default
用途: 用于处理默认值
模本: User: $…{userLogin.name?default("Anonymous")}

<td>$…{(employee.department.manager.name)?default("&nbsp;")}</td>
输出: User: Anonymous
<td>&nbsp;</td>
注，可以对整个对象树加上()，再用内置处理器这种方便的做法.

3. Sequence内置的计数器: xxx_index
用途：显示序号
模板:
<#list employees as e>
$…{e_index}. $…{e.name}
</#list>
输出:

1. Readonly
2. Robbin

4. Sequence内置的分段器: chunk
用途：某些比较BT的排版需求
模板:
<#assign seq = ['a', 'b', 'c', 'd', 'e', 'f', 'g', 'h', 'i', 'j']>
<#list seq?chunk(4) as row>
<ul>
<li><#list row as cell>$…{cell} </#list></li>
</ul>
</#list>

<#list seq?chunk(4, ‘-’) as row>
<tr>
<td><#list row as cell>$…{cell} </#list></td>
</tr>
</#list>
输出:
<ul>
<li>a</li>
<li>b</li>
<li>c</li>
<li>d</li>
</ul>
<ul>
<li>e</li>
<li>f</li>
<li>g</li>
<li>h</li>
</ul>
<ul>
<li>i</li>
<li>j</li>
</ul>

<tr>
<td>a</td>
<td>b</td>
<td>c</td>
<td>d</td>
</tr>
<tr>
<td>e</td>
<td>f</td>
<td>g</td>
<td>h</td>
</tr>
<tr>
<td>i</td>
<td>j</td>
<td>-</td>
<td>-</td>
</tr>

sort

Returns the sequence sorted in ascending order. This will work only if all subvariables are strings, or if all subvariables are numbers, or, since FreeMarker 2.3.1, if all subvariables are date values (date, time, or date+time). If the subvariables are strings, it uses locale (language) specific lexical sorting (which is usually not case sensitive). For example:

<#assign ls = ["whale", "Barbara", "zeppelin", "aardvark", "beetroot"]?sort>
<#list ls as i>${i} </#LIST>

will print (with US locale at least):

aardvark Barbara beetroot whale zeppelin

sort_by Returns the sequence of hashes sorted by the given hash subvariable in ascending order. The rules are the same as with the sort built-in, except that the subvariables of the sequence must be hashes, and you have to give the name of a hash subvariable that will decide the order. For example:

<#assign ls = [
  {"name":"whale", "weight":2000},
  {"name":"Barbara", "weight":53},
  {"name":"zeppelin", "weight":-200},
  {"name":"aardvark", "weight":30},
  {"name":"beetroot", "weight":0.3}
]>
Order by name:
<#list ls?sort_by("name") as i>
- ${i.name}: ${i.weight}
</#LIST>

Order by weight:
<#list ls?sort_by("weight") as i>
- ${i.name}: ${i.weight}
</#LIST>  

will print (with US locale at least) Order by name: – aardvark: 30 – Barbara: 53 – beetroot: 0.3 – whale: 2000 – zeppelin: -200 Order by weight: – zeppelin: -200 – beetroot: 0.3 – aardvark: 30 – Barbara: 53 – whale: 2000 Since FreeMarker 2.3.1, if the subvariable that you want to use for the sorting is on a deeper level (that is, if it is a subvariable of a subvariable and so on), then you can use a sequence as parameter, that specifies the names of the subvariables that lead down to the desired subvariable. For example:

<#assign members = [
    {"name": {"first": "Joe", "last": "Smith"}, "age": 40},
    {"name": {"first": "Fred", "last": "Crooger"}, "age": 35},
    {"name": {"first": "Amanda", "last": "Fox"}, "age": 25}]>
Sorted by name.last:
<#list members?sort_by(['name', 'last']) as m>
- ${m.name.last}, ${m.name.first}: ${m.age} years old
</#LIST>  

will print (with US locale at least): Sorted by name.last: – Crooger, Fred: 35 years old – Fox, Amanda: 25 years old – Smith, Joe: 40 years old

接下来把安装过程大略的介绍一下：

打开菜单项 Help -> Software updates -> Find and install….

选择单选项 "Search for new features to install".
点击 new Remote Site…, 输入 "FreeMarker"  作为名字以及 "http://www.freemarker.org/eclipse/update" 作为更新的地址
选中复选框 "FreeMarker"
点击下一步或完成按钮根据提示完成插件的安装
安装完毕后该插件自动关联*.ftl文件，你也可以在下面对话框中进行自行设置.

网址：

FreeMarker的官方主页： http://freemarker.sourceforge.net
下载地址：http://sourceforge.net/projects/freemarker
FreeMarker与Velocity的对比：http://www.javayou.com/showlog.jspe?log_id=657

比如在页面中需要有个单纯的遍历(以年度为例),无需调用任何数据，很方便

当数据超过3位的时候,freemarker会自动用逗号截取 格式如:2,008

如何解决呢？

加.toString(),如：${(userId).toString()}加?c,如：${(userId)?c} freemarker配置文件freemarker.properties加上number_format=#

判断是否为空:

<#if xxList[0]?exists>

不然当xxList没有数据的时候 ，很大很大一个黄页就等着你了

截取字符串长度：

有的时候我们在页面中不需要显示那么长的字符串，比如新闻标题，这样用下面的列子就可以自定义显示的长度

< lt. <= lte. > gt. >= gte

<#if jstbqkVO.gzdd?length lt 8>
           <a>${jstbqkVO.gzdd?default("")}</a>
      <#else>
           <a title="${jstbqkVO.gzdd}">${jstbqkVO.gzdd[0..3]?default("")}...</a>
</#IF>

意思就是如果这个字符串的长度小于8，那么就正常显示，反之则取4位

嵌套list:

很多时候，数据库里存储的都是编号，而页面上需要显示的汉字，而且不在一张表里，看列子

<#list kcList as kcVO>
           <#if kcVO.kch=jsskVO.kch> （kcVO里有编号和名称，而jsskVO里只有编号）
                  ${kcVO.kcm}
           </#IF>
</#LIST>