FreeMarker是一个开源的Java模板引擎，它用于生成动态HTML、XML或其他格式的文本输出。在Web开发中，FreeMarker常与MVC模式的后端框架（如Spring MVC）结合使用，将业务逻辑处理后的数据与预先设计的HTML模板结合，生成最终的网页。下面将深入探讨FreeMarker的基本概念、工作原理以及如何创建一个简单的实例。
1. **基本概念**
- **模板（Template）**: 模板是FreeMarker的核心，它是HTML或XML等静态文件，其中包含特定的FreeMarker指令和变量，用于表示数据的占位符。
- **数据模型（Data Model）**: 数据模型是Java对象的集合，包含了要在模板中展示的数据。这些对象可以是简单的字符串、数字，也可以是复杂的Java类实例。
- **输出**: FreeMarker通过将模板与数据模型合并，生成最终的输出文本。
2. **FreeMarker工作原理**
当FreeMarker引擎接收到一个模板和数据模型后，它会解析模板中的指令和变量，用数据模型中的值替换它们，然后生成最终的输出。FreeMarker支持多种控制结构，如条件语句（`if`、`?if`）、循环（`#foreach`）、以及自定义函数（`<#function>`）。
3. **创建FreeMarker简单实例**
- **步骤1：设置环境**
你需要在项目中引入FreeMarker库。如果是Maven项目，可以在pom.xml中添加依赖：
```xml
<dependency>
<groupId>org.freemarker</groupId>
<artifactId>freemarker</artifactId>
<version>2.3.30</version>
</dependency>
```
- **步骤2：创建模板文件**
创建一个名为`index.ftl`的模板文件，内容如下：
```
<html>
<body>
<h1>Welcome, ${user.name}!</h1>
<p>Your email is: ${user.email}</p>
</body>
</html>
```
- **步骤3：准备数据模型**
在Java代码中创建数据模型：
```java
Map<String, Object> dataModel = new HashMap<>();
User user = new User("张三", "zhangsan@example.com");
dataModel.put("user", user);
```
- **步骤4：配置FreeMarker并生成输出**
初始化FreeMarker配置并解析模板：
```java
Configuration cfg = new Configuration(Configuration.VERSION_2_3_30);
cfg.setDirectoryForTemplateLoading(new File("src/main/resources/templates"));
Template template = cfg.getTemplate("index.ftl");
StringWriter writer = new StringWriter();
template.process(dataModel, writer);
String output = writer.toString();
System.out.println(output);
```
4. **模板语法**
- `${expression}`: 输出表达式的值，例如`${user.name}`将输出用户名。
- `#if` 和 `#else`: 条件判断，如`<#if user.isAdmin>true admin</#if><#else>normal user</#else>`。
- `#foreach`: 循环，例如遍历数组或集合。
- `#set`: 定义变量，如`<#set title="Welcome Page">`。
5. **最佳实践**
- 分离模板和业务逻辑：模板只负责展示，而数据处理应在后端完成。
- 优化性能：避免在模板中进行复杂的逻辑计算。
- 使用模板继承和导入来重用模板片段。
以上就是一个FreeMarker的简单实例，展示了如何使用FreeMarker将Java对象与HTML模板结合，生成动态网页。在实际开发中，FreeMarker的强大功能远不止于此，它能帮助开发者实现灵活、高效且易于维护的视图层。
freeMarker实例(简单).rar （10个子文件） 
freeMarkerPrj 
FreeMarkerTest.java 1KB
freemarker.jar 860KB
