freemarker中文手册文档.doc

FreeMarker 是一个强大的模板引擎，主要用于生成文本输出，如HTML Web页面。它是用纯Java编写的，不依赖特定的Web容器或HTTP协议，因此既可用于Web应用，也可用于非Web环境。FreeMarker的设计理念是将数据模型和模板分离开来，使得设计人员可以专注于页面布局，而开发人员则负责准备数据。 1. **通用目标** - FreeMarker可以生成多种类型的文本，如HTML、XML、RTF等。 - 它轻量级且易于嵌入到现有系统中，不需要Servlet环境。 - 支持自定义模板加载器，可以从不同来源加载模板。 - 可以生成文本并以各种方式使用，如保存文件、发送电子邮件或直接返回给Web浏览器。 2. **模板语言** - 提供了丰富的指令，如`include`、`if/elseif/else`、循环等。 - 在模板中可以创建和修改变量，以及使用复杂的表达式。 - 包含命名的宏，支持位置参数和嵌套内容，便于代码复用。 - 使用命名空间避免命名冲突，实现模板的模块化。 - 支持自定义的输出转换，用于在输出时进行内容转换。 3. **通用数据模型** - FreeMarker不直接映射到Java对象，而是通过对象封装器，以变量形式在模板中使用数据。 - 支持多种数据类型，如JavaBean、XML文档、SQL查询结果集等，提供抽象接口供模板开发者使用。 4. **Web应用准备** - 内置处理Web相关的任务，如HTML转义。 - 适合Model2 Web框架，可作为JSP的替代。 - 支持集成JSP标签库，遵循MVC模式，分离设计与逻辑。 - 为页面设计师和程序员提供独立的工作空间。 5. **国际化和本地化** - 使用Unicode作为内部字符集，支持多种字符集。 - 数字、日期和时间格式支持本地化。 - 非US字符集可用作变量名称。 - 支持创建针对多种语言的模板。 6. **XML处理** - 提供`<#recurse>`和`<#visit>`指令处理XML树的递归遍历。 - 直观地访问XML对象模型，简化XML数据在模板中的使用。 FreeMarker的快速入门示例展示了其基本工作原理：模板（如HTML）中包含特殊指令，当与数据模型结合后，FreeMarker会替换这些指令，生成最终的输出。例如，模板中 `${user}` 和 `${latestProduct.url}` 等占位符会被实际的用户名称和最新产品的URL所替代。 总结起来，FreeMarker是一个强大而灵活的模板引擎，它为Web开发提供了一种高效、分离的解决方案，允许设计者和开发人员分别关注他们的专业领域，同时提供了丰富的功能来处理复杂的数据和文本生成任务。