- 1、本文档共21页,可阅读全部内容。
- 2、原创力文档(book118)网站文档一经付费(服务费),不意味着购买了该文档的版权,仅供个人/单位学习、研究之用,不得用于商业用途,未经授权,严禁复制、发行、汇编、翻译或者网络传播等,侵权必究。
- 3、本站所有内容均由合作方或网友上传,本站不对文档的完整性、权威性及其观点立场正确性做任何保证或承诺!文档内容仅供研究参考,付费前请自行鉴别。如您付费,意味着您自己接受本站规则且自行承担风险,本站不退款、不进行额外附加服务;查看《如何避免下载的几个坑》。如果您已付费下载过本站文档,您可以点击 这里二次下载。
- 4、如文档侵犯商业秘密、侵犯著作权、侵犯人身权等,请点击“版权申诉”(推荐),也可以打举报电话:400-050-0827(电话支持时间:9:00-18:30)。
查看更多
FreeMarker编程指南
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
您可能关注的文档
- En空间中张角定理及其应用.pdf
- EPF10K130EBC356-2N中文资料(Altera)中文数据手册「EasyDatasheet - 矽搜」.pdf
- EPF10K130EQI240-2中文资料(Altera)中文数据手册「EasyDatasheet - 矽搜」.pdf
- Eplan P8 的PDF导出设置.pdf
- ERP物料模块-单位转换公式.pdf
- EVO 4G 完美刷机全教程.docx
- EVUS登记需要多久时间?.pdf
- Excel 2003操作.doc
- Excel 2007的合并与拆分操作包括对单元格与单元格内容的合并与拆分.docx
- Excel 2010单元格内容的移动或复制.doc
最近下载
- 2023年物业管理员理论知识考试题库(含答案).pdf
- GBT2550-2016 气体焊接设备 焊接、切割和类似作业用橡胶软管.pdf VIP
- 专升本语文资料.docx VIP
- 西南15G701-2-混凝土结构轻质填充墙构造图集.pdf
- 《在祖国怀抱里课件》小学音乐冀少2011课标版三年级上课件.ppt
- 烹饪专业调研报告.pdf
- 城市轨道交通安全管理项目2城市轨道交通危险源辨识与安全标志.pptx VIP
- 铁工电〔2023〕54号 国铁集团关于印发《普速铁路工务安全规则》的通知.docx VIP
- 新人教版(部编)一年级语文上册《文语文园地六和大人一起读》优质课教案_20.pdf
- 燃气管道第三方施工管理安全技术规范.pdf
文档评论(0)