Freemarker 应用文档

### Freemarker 应用文档详解 #### 一、Freemarker 概述 Freemarker 是一款基于模板的文本生成工具，使用纯 Java 编写而成。它主要应用于 Web 开发领域，尤其适用于 MVC（Model-View-Controller）架构中的视图层。尽管 Freemarker 具备一定的编程能力，但它更多地依赖于 Java 程序来准备需要展示的数据，而 Freemarker 的主要职责在于根据这些数据生成相应的页面。 #### 二、Freemarker 的核心特点 ##### 1. **通用目标** - **文本多样性**：Freemarker 可以生成各种类型的文本输出，包括但不限于 HTML、XML、RTF 或者 Java 源代码。 - **轻松集成**：它体积小巧且无需 Servlet 环境即可运行，便于集成到现有项目中。 - **灵活的模板加载**：Freemarker 支持从多种来源加载模板，例如本地文件系统、数据库等。 - **多用途输出**：除了将生成的文本保存为本地文件外，还可以作为电子邮件发送或从 Web 应用程序返回给 Web 浏览器。 ##### 2. **强大的模板语言** - **常用指令支持**：提供了如 include、if/elseif/else 和循环结构等基本控制结构。 - **变量管理**：支持在模板中创建和修改变量。 - **复杂表达式支持**：可以在几乎任何地方使用复杂表达式来指定值。 - **宏定义**：允许定义命名的宏，并接受位置参数和嵌套内容。 - **名字空间支持**：通过名字空间帮助管理和重用宏库，避免命名冲突。 - **输出转换**：提供输出转换功能，如 HTML 转义、压缩等，也可自定义转换规则。 ##### 3. **通用数据模型** - **对象封装**：Freemarker 通过插件式对象封装机制，使得 Java 对象能在模板中以变量形式呈现。 - **抽象接口**：可以通过抽象方式表示对象，如 JavaBean、XML 文档等，以便模板开发者更加专注于业务逻辑而非底层技术实现。 ##### 4. **为 Web 准备** - **内置 Web 相关功能**：模板语言内置了处理 Web 相关任务的功能，如 HTML 转义等。 - **JSP 标记库支持**：能够与 JSP 标记库集成，作为 JSP 的替代方案。 - **MVC 设计**：Freemarker 的设计充分考虑了 MVC 架构，便于页面设计人员和程序员之间的分工合作。 ##### 5. **智能国际化和本地化** - **字符集智能化**：内部使用 Unicode，支持多种字符集。 - **格式本地化**：数字、日期和时间格式可以根据不同的本地化需求进行调整。 - **多语言支持**：支持在同一模板中使用多种语言。 ##### 6. **强大的 XML 处理能力** - **XML 遍历指令**：2.3 版本新增了 `<#recurse>` 和 `<#visit>` 指令，用于递归遍历 XML 树。 - **直观的 XML 访问**：提供直观的方式在模板中访问 XML 对象模型。 #### 三、Freemarker 与 Struts 结合的应用 Freemarker 可以与 Struts 等框架结合使用，提供更为灵活和强大的视图层实现。 ##### 1. **环境需求** - **依赖添加**：在 Struts + Spring + Hibernate 的基础上，需要将 `freemarker.jar` 文件添加到项目的 lib 目录中。 - **编辑器安装**：可以通过 Eclipse 的帮助菜单安装 Freemarker 编辑器插件。 ##### 2. **配置示例** - **web.xml 配置**： ```xml <servlet> <servlet-name>freemarker</servlet-name> <servlet-class>freemarker.ext.servlet.FreemarkerServlet</servlet-class> <init-param> <param-name>TemplatePath</param-name> <param-value>/</param-value> </init-param> <init-param> <param-name>NoCache</param-name> <param-value>true</param-value> </init-param> <init-param> <param-name>ContentType</param-name> <param-value>text/html</param-value> </init-param> <init-param> <param-name>template_update_delay</param-name> <param-value>0</param-value> </init-param> <init-param> <param-name>default_encoding</param-name> <param-value>UTF-8</param-value> </init-param> </servlet> ``` 通过上述介绍可以看出，Freemarker 不仅功能强大而且高度灵活，非常适合用于 Web 开发中视图层的构建。无论是从模板语言的设计还是对 Web 应用的支持上，都体现了其优秀的特性和广泛的应用场景。