freemarker的简单入门程序

　　本文主要介绍了freemarker的常用标签<#list>   <#import>  <#assign>  <#if> <#else> <#elseif>标签，并配有相应的案例。

在这里我想先介绍freemarker一个比较重要的概念：顶层变量：所谓顶层变量就是存在数据模型中的变量.

<#assign>标签的作用就是替换和创建顶层变量。

先看本项目的目录结果如下图所示：

其中FreeMarkerTest2是一个测试程序：

a.ftl和b.ftl是写freemarker标签的地方（.ftl文件就是freemarker template 文件中的意思，翻译成中文是：freemarker 模板文件）

FreeMarkeerTest2的代码如下：

 package com.supwisdom;

 import freemarker.template.Configuration;
 import freemarker.template.Template;

 import java.io.File;
 import java.io.PrintWriter;
 import java.util.ArrayList;
 import java.util.Date;
 import java.util.HashMap;
 import java.util.Map;

 /**
  * Created by ${秦林森} on 2017/8/1.
  */
 public class FreeMarkerTest2 {
     public static void main(String[] args) throws Exception{
         //创建freemarker配置实例
         Configuration cfg = new Configuration();
         //这个template是目录中的文件夹名：
         cfg.setDirectoryForTemplateLoading(new File("template"));
         //创建数据模型
         Map root=new HashMap<>();
         ArrayList<Object> objects = new ArrayList<>();
         for(int i=1;i<=7;i++){
             objects.add("星期"+i);
      }
         HashMap<String, Address> map = new HashMap<>();
         map.put("1",new Address("中国","北京"));
         map.put("2",new Address("美国","华盛顿"));
         map.put("3",new Address("尼日利亚","内罗毕"));
         root.put("user","秦林森");
         root.put("lis",objects);
         root.put("date",new Date());
         root.put("map",map);
         //加载模板文件
         Template template=cfg.getTemplate("b.ftl");
         //显示生成数据：
         PrintWriter out = new PrintWriter(System.out);
         template.process(root,out);
         out.flush();
         out.close();
     }
 }

b.ftl的代码如下：其中我认为遍历map集合比较难，已用红色标出。

 <#assign user="林肯"><#--替换一个顶层变量-->
 ${user!}你是最棒的。you will conquer the world.
 <#assign user=4>

     <#list lis as n>
     ${n}
     </#list>
 <#list lis as a>
 ${a}
 </#list>

 <#--时间的格式化输出-->
 ${date?string("yyyy_MM_dd HH:mm:ss")}
 <#assign user="仁慈"><#--创建一个顶层变量,所谓顶层变量就是直接放在数据模型中的值。-->
 <#assign number=[1,2,3]><#--这句话相当于java语言中的int[] number=[1,2,3];赋值操作-->
 ${number[0]}
 <#assign subs="01234">
 ${subs[0..1]}

 ${subs[1..4]}
 <#--遍历map集合首先要得到keys-->
22 <#assign keys=map?keys>
23 <#list keys as c>
24   key:  ${c} 国家:${map["${c}"]["country"]} 城市：${map["${c}"].city}
25 </#list>
 <#--这两种拼接字符串的效果是一样的-->
 ${"hellooewio${user}"}
 ${"hello"+user!}

 if else标签的使用：
 <#--给a先赋值-->
 <#assign a=7>
 <#if a gt 6><#--这里推荐使用gt代替数学中的大于符号">"-->
     a大于6
 </#if>
 if else使用：
 <#assign b=5>
 <#if b gt 6>
     b 大于6
 <#else>
     b小于6
 </#if>
 if elseif else的使用：
 <#assign c=4>
 <#if c gt 4>
     c大于4
 <#elseif c lt 4>
     c小于4
 <#else>
 c等于4.
 </#if>

 freemarker的内建函数：
 <#assign a="i you me">
 <#assign b="I YOU ME">
 <#assign c="<h>people</h>">
 <#--内建函数cap_first,lower_case,upper_case-->
 ${a?cap_first}<#--把a的第一个首字母变为大写-->
 ${b?lower_case}<#--把b的字符串转化为小写-->
 ${a?upper_case}<#--把a字符串转为大写-->
 ${c?html}<#--对字符串进行hmtl编码，本例输出的结果是：&lt;h&gt;people&lt;/h&gt;-->

 空值处理运算符:! ??
 ${oewoei!"人民"}<#--如果数据模型中不存在oewoei这个变量时，赋一个初始值"人民"-->
 ${"oiieo"!}<#--如果数据模型中不存在oiieo这个变量时，赋一个初始值""-->
 <#if oweio??><#--oweio在数据模型中存在时输出存在，反之输出不存在-->
     oweio存在
 <#else>
 oweio不存在。
 </#if>
 include指令的使用，它相当于把一个文件的内容加到本文件中。
 <#include "sixi.txt">

 自定义指令宏指令（没有任何参数的）：
 <#macro a>
     <#if oweioo??>
         存在
         <#else>
             不存在
     </#if>
 </#macro>
 调用自定义指令：(无参的)
 <@a></@a>

 <#macro m2 a b c >
 ${a}+${b}+${c}
 </#macro>
 <@m2 a="老高" b="老张" c="老马" />
 把a.ftl文件导入到b.flt中：
 命名空间命名的：
 一个重要的规则就是路径不应该包含大写字母，为了分隔词语，使用下划线_，就像
 wml_form（而不是 wmlForm）。

 <#import "a.ftl" as aaa>
 <#--调用a.ftl中的变量和方法（宏）-->
 <@aaa.bo>
     I am chinese
 </@aaa.bo>
 ${aaa.mail}

a.ftl文件的代码如下：

 <#--自定义bo这个宏-->
<#macro bo>
     <table>
         <tr>
             <td>
                 <#nested>
             </td>
             <td>
                 <#nested>
             </td>
         </tr>
     </table>
 </#macro>

 <@bo>
     I love china.
     I love LuAn
 </@bo>
 <#assign mail="123@qq.com">

Address类的代码如下：

 package com.supwisdom;

 /**
  * Created by ${秦林森} on 2017/7/31.
  */
 public class Address {
     private String country;
     private String city;

     public Address(String country, String city) {
         this.country = country;
         this.city = city;
     }

     public String getCountry() {
         return country;
     }

     public void setCountry(String country) {
         this.country = country;
     }

     public String getCity() {
         return city;
     }

     public void setCity(String city) {
         this.city = city;
     }
 }

具体的参考资料可通过下列网址下载：里面有尚学堂的视频和freemarker中文手册。

http://pan.baidu.com/s/1slJilAl