2006-12-21

[翻译] FreeMarker快速上手

关键字: freemarker

创建Configuration实例

首先必须创建一个freemarker.template.Configuration 实例并调整其设置。Configuration 实例保存freemarker的设置，同时处理预解析的模板的创建和缓存。

通常应用程序的生命周期中只会创建一个Configuration实例。

Configuration cfg = new Configuration();
// 指定模板文件的数据源，这里是一个文件目录。

cfg.setDirectoryForTemplateLoading(
        new File("/where/you/store/templates"));
// 指定模板如何发现数据模型，这是一个高级主题，暂且这样使用。
cfg.setObjectWrapper(new DefaultObjectWrapper()); 

目前我们使用单个的Configuration实例。不过如果一个系统有多个独立的组件使用FreeMarker，它们会使用各自的Configuration 实例。 

创建数据模型

我们可以简单地使用java.lang java.util 和自定义的JavaBean构建对象模型，比如我们构建数据模型如下：  

(root)
  |
  +- user = "Big Joe"
  |
  +- latestProduct
      |
      +- url = "products/greenmouse.html"

      |
      +- name = "green mouse" 

如下是构建数据模型的代码：

// Create the root hash
Map root = new HashMap();
// Put string ``user'' into the root
root.put("user", "Big Joe");
// Create the hash for ``latestProduct''
Map latest = new HashMap();
// and put it into the root
root.put("latestProduct", latest);
// put ``url'' and ``name'' into latest
latest.put("url", "products/greenmouse.html");
latest.put("name", "green mouse"); 

也可以使用一个包含url 和 name 属性的JavaBean实例表示lastestProduct。

获取模板

模板通过freemarker.template.Template实例表示。通常从Configuration 实例中获取Template实例，任何时候都可以调用getTemplate方法获取一个Template 实例。假定模板文件test.ftl 保存在先前设置的目录中： 

Template temp = cfg.getTemplate("test.ftl"); 

上述代码将读取，解析/where/you/store/templates/test.ftl文件，创建一个对应的Template实例 。

Configuration 缓存Template 实例, 因此当需要再次获取test.ftl 文件, 将不会创建一个新的Template实例。

合并模板和数据模型

就我们所知，数据模型+模板=输出，通过调用模板的process 方法合并数据模型和模板，process. 方法接受一个数据模型根和一个writer作为参数，将结果输出到Writer。 为简化起见，这里输出到控制台。

Writer out = new OutputStreamWriter(System.out);
temp.process(root, out);
out.flush(); 

一旦获取一个Template 实例，可以合并不同的数据模型和一个模板(Template 实例基本上是无状态的)，而test.ftl只会当Template 实例被创建的时候访问一次。

整合

这是先前代码片断的源文件，不要忘记将freemarker.jar放在CLASSPATH.中。

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

public class Test {

    public static void main(String[] args) throws Exception {
        
        /* ------------------------------------------------------------------- */    
        /* You usually do it only once in the whole application life-cycle:    */    
    
        /* Create and adjust the configuration */
        Configuration cfg = new Configuration();
        cfg.setDirectoryForTemplateLoading(
                new File("/where/you/store/templates"));
        cfg.setObjectWrapper(new DefaultObjectWrapper());

        /* ------------------------------------------------------------------- */    
        /* You usually do these for many times in the application life-cycle:  */    
                
        /* Get or create a template */
        Template temp = cfg.getTemplate("test.ftl");

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

        /* Merge data model with template */
        Writer out = new OutputStreamWriter(System.out);
        temp.process(root, out);
        out.flush();
    }
} 

 

评论
qingfeng825 2008-06-23
我先转载了，留得日后看，
谢谢！
qingfeng825 2008-06-23
very good，思路明晰，条理清楚。
本来想自己整理一篇，但是楼主已经把我要讲得都讲清楚了。
发表评论

您还没有登录，请登录后发表评论