FreeMarker编程指南.pdf

FreeMarker2.3.10 ―Programmers Guide （中文版） 翻译：Magice （魔冰） QQ: 8163090 前言3 一、快速入门4 1.1、创建配置实例4 1.2、创建数据模型 （Data Model）4 1.3、获取模版 （template）5 1.4、把模版与数据模型合并6 1.5、完整的代码 6 二、数据模型 （Data Model）7 2.1、基础类型7 2.2、Scalar 类型 （单值对应的Data Model）8 2.3、容器类型8 2.4、方法变量9 2.5、转换器变量 10 2.6、节点变量 12 2.7、对象包裹 12 三、配置 （Configuration ） 15 3.1、基础 15 3.2、共享变量 15 3.3、配置参数 16 3.4、加载模板 17 3.5、异常处理 19 四、其它说明 20 4.1、变量20 4.2、字符编码20 4.3、多线程 21 4.5、Bean 包裹21 前言 FreeMarker 官方参考文档总共有四份，它们分别是  Designers Guide （网上已有翻译，主要从FreeMarker 的概念上介绍）  Programmers Guide （本文档所以翻译的部分，主要从框架的设计方面介绍）  XML Processing Guide （对XML 数据模型处理的介绍）  Reference （FreeMarker 的参考文档，语言使用介绍） 中文翻译之所以选择 Programmers Guide 是因为个人觉得该部分对如何实现 FreeMarker 进行了比较深入的阐述。有助于读者很好的了解其运作机制，以及去理解其他 模板引擎 （如Velocity ）的工作机理。 注：由于原文档部分内容直译可能难于被读者理解，所以有些地方采用意译为主，因此在翻译用词上 难免可能 会有出入 ，大家对翻译的内容有任何意见都可以给我直接发邮件告知 motomagice@ 一、快速入门 1.1、创建配置实例 首先你需要创建一个 Configuration （freemarker.template.Configuration ）的实例， 设置其中的某些属性。Configuration 是存放FreeMarker 的Application 级别配置信息的一 个重要地方。同时，它还负责创建及预解析模版(template)。 在应用系统的生命周期中 （servlet ）你只需要初始化创建一次Configure 实例 （因为它 保存的是全局配置信息） Configuration cfg = new Configuration(); // 指定一个加载模版的数据源 // 这里我设置模版的根目录 cfg.setDirectoryForTemplateLoading(new File(/where/you/store/templates)); // 指定模版如何查看数据模型.这个话题是高级主题… // 你目前只需要知道这么用就可以了: cfg.setObjectWrapper(new DefaultObjectWrapper()); 你仅仅只需要这么一个配置就可以了。注意：如果你的系统中有多个独立的模块都要使 用 FreeMarker 那么你就需要多个Configuration 实例 （也就是说你每一个组建都需要一个 私有的配置） 1.2、创建数据模型 （Data Model ） 如果配置简单的数据模型，你可能只需要java.lang 和 java.util 以及一些Java Beans 来构建 FreeMarker 的数据库模型。  字符串使用 java.lang.String .  数字使用 java.lang.Number  布尔使用java.lang.Boolean  数组以及序列使用 java.util.L