FreeMarker入门

这里有个系列博客很不错，应该是最合适的入门教程了。Java模板引擎FreeMarker系列
这里的对FreeMarker的简介也很棒：使用Java对FreeMarker开发Web模板

简介

FreeMarker是一个模板引擎，一个基于模板生成文本输出的通用工具，使用纯Java编写，被主要用来生成HTML页面，特别是基于MVC模式的Web应用的页面。当然，FreeMarker同样可以应用于非Web应用程序环境。虽然FreeMarker具有一些编程的能力，但通常由Java程序准备要显示的数据，由FreeMarker模板显示准备的数据（如下图）

overview

FreeMarker不是一个Web应用框架，也与容器无关，因为它并不知道HTTP或者Servlet。它适合作为Model2框架（如Struts）的视图组件。FreeMarker模板也支持JSP标签库。

Freemarker生成静态页面的过程是，模板引擎读取模板页面，解析其中的标签，完成指令相对应的操作，然后采用键值对的方式传递参数替换模板中的取值表达式，最后根据配置的路径生成一个新的静态页面。

FreeMarker常用标签

${…}：取值标签。表示输出变量的内容。如：${name}可以取得root中key为name的值。${person.name}可以取得成员变量为person的name属性。
<#…>：FTL指令（FreeMarker模板语言标记）如：<#if>表示判断、<#list>表示循环枚举、<#include>表示包含其他页面。
<@…>：宏，自定义标签。
注释：包含在<#--和-->之间。

第一个例子

模板 + 数据模型 = 输出

英文就是 template + data-model = output

首先，创建模板如下：

<html>
<head>
  <title>Welcome!</title>
</head>
<body>
  <h1>Welcome ${user}!</h1>
  <p>Our latest product:
  <a href="${latestProduct.url}">${latestProduct.name}</a>!
</body>
</html>

在程序端，只需要简单的四步：

得到Configuration类的实例。
创建data-model对象。
获取template文件。
把template和data-model捏合到一起产生输出。

代码如下：
首先创建data-model类：

/**
 * Product bean; note that it must be a public class!
 */
public class Product {

    private String url;
    private String name;

    // As per the JavaBeans spec., this defines the "url" bean property
    // It must be public!
    public String getUrl() {
        return url;
    }

    public void setUrl(String url) {
        this.url = url;
    }

    // As per the JavaBean spec., this defines the "name" bean property
    // It must be public!
    public String getName() {
        return name;
    }

    public void setName(String name) {
        this.name = name;
    }

}

主函数：

import freemarker.template.*;
import java.util.*;
import java.io.*;

public class Test {

    public static void main(String[] args) throws Exception {
        
        /* ------------------------------------------------------------------------ */    
        /* You should do this ONLY ONCE in the whole application life-cycle:        */    
    
        /* Create and adjust the configuration singleton */
        Configuration cfg = new Configuration(Configuration.VERSION_2_3_25);
        cfg.setDirectoryForTemplateLoading(new File("/where/you/store/templates"));
        cfg.setDefaultEncoding("UTF-8");
        cfg.setTemplateExceptionHandler(TemplateExceptionHandler.RETHROW_HANDLER);
        cfg.setLogTemplateExceptions(false);

        /* ------------------------------------------------------------------------ */    
        /* You usually do these for MULTIPLE TIMES in the application life-cycle:   */    

        /* Create a data-model */
        Map root = new HashMap();
        root.put("user", "Big Joe");
        Product latest = new Product();
        latest.setUrl("products/greenmouse.html");
        latest.setName("green mouse");
        root.put("latestProduct", latest);

        /* Get the template (uses cache internally) */
        Template temp = cfg.getTemplate("test.ftlh");

        /* Merge data-model with template */
        Writer out = new OutputStreamWriter(System.out);
        temp.process(root, out);
        // Note: Depending on what `out` is, you may need to call `out.close()`.
        // This is usually the case for file output, but not for servlet output.
    }
}

可以看到，有了JSP的知识，FreeMarker还是很好学习的。更多的用法可以参考上面的博客以及官方教程。本篇到此为止。

FreeMarker入门

简介

FreeMarker常用标签

第一个例子

Toconscience

引用和评论

POJ-2663 完美覆盖问题