FreeMarker API 中文指南:模板与程序开发入门

需积分: 47 11 下载量 157 浏览量 更新于2024-07-19 1 收藏 2.3MB PDF 举报
"freemarker api 中文 帮助文档" FreeMarker是一个开源的Java库,它被设计用来生成HTML、XML或其他类型的文本输出,通常用于Web应用中的服务器端渲染。这个API帮助文档是针对FreeMarker 2.3.16版本的,由Nan Lei翻译,并遵循Creative Commons Attribution 3.0 Unported License。 文档首先介绍了FreeMarker的基本概念,包括它是如何工作以及读者应关注的内容。FreeMarker的核心思想是通过模板和数据模型来生成动态内容。模板是包含文本和指令的文件,而数据模型是提供给FreeMarker用以填充模板的数据结构。两者结合,FreeMarker能够根据数据模型的内容动态生成最终输出。 在“数值和类型”章节中,文档详细讲解了FreeMarker支持的基础数据类型,包括数值、字符串、布尔值等,并讨论了类型转换规则。此外,还介绍了FreeMarker模板的结构,如指令、表达式和插值,这些都是构建模板的关键元素。 进一步深入,文档涵盖了自定义指令的创建,允许开发者扩展FreeMarker的功能。在模板中定义变量和命名空间的功能使模板更加灵活,可以根据需要引入新的数据源。空白处理和替换(方括号)语法则提供了对输出格式控制的手段。 在程序开发指南部分,文档向开发者展示了如何在Java中使用FreeMarker API。从创建配置实例、构建数据模型到加载模板、合并模板与数据模型以及生成输出,每个步骤都有详细的解释。此外,还详细讨论了数据模型的各种组件,如标量、容器、方法、指令等,以及配置对象的设置,如共享变量和配置信息。 FreeMarker API的中文帮助文档对于那些需要在中国开发基于FreeMarker的Java应用的开发者来说是一份宝贵的资源,它帮助开发者理解和利用FreeMarker的强大功能,从而更有效地生成动态内容。这份文档详尽且易懂,是学习和参考FreeMarker技术的必备资料。
2012-08-23 上传
FreeMarker官方参考文档总共有四份,它们分别是  Designer's Guide(网上已有翻译,主要从FreeMarker 的概念上介绍)  Programmer's Guide(本文档所以翻译的部分,主要从框架的设计方面介绍)  XML Processing Guide(对XML数据模型处理的介绍)  Reference(FreeMarker 的参考文档,语言使用介绍) 中文翻译之所以选择 Programmer's Guide 是因为个人觉得该部分对如何实现 FreeMarker 进行了比较深入的阐述。有助于读者很好的了解其运作机制,以及去理解其他 模板引擎(如Velocity)的工作机理。 注:由于原文档部分内容直译可能难于被读者理解,所以有些地方采用意译为主,因此在翻译用词上 难 免 可 能 会 有 出 入 , 大 家 对 翻 译 的 内 容 有 任 何 意 见 都 可 以 给 我 直 接 发 邮 件 告 知 motomagice@yahoo.com.cn 目录 前言.........................................................................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