**FreeMarker快速入门**
FreeMarker是一个强大的、开源的模板引擎，它主要用于生成动态内容，尤其在Web应用中广泛使用。它的主要目标是将业务逻辑与显示逻辑分离，使得开发者可以专注于编写应用程序，而设计师可以专注于页面设计。FreeMarker与Java语言紧密集成，但不包含任何Java代码，因此模板文件对非程序员也友好。
### 1. 安装与配置
你需要从FreeMarker官方网站下载最新版本的FreeMarker库。将其添加到你的Java项目的`lib`目录下，如果是Maven或Gradle项目，可以在pom.xml或build.gradle文件中添加依赖。
```xml
<!-- Maven -->
<dependency>
<groupId>org.freemarker</groupId>
<artifactId>freemarker</artifactId>
<version>2.3.30</version>
</dependency>
// Gradle
dependencies {
implementation 'org.freemarker:freemarker:2.3.30'
}
```
### 2. 基本概念
- **模板（Template）**：FreeMarker的核心是模板文件，通常使用`.ftl`扩展名。模板包含静态文本和变量、控制结构等。
- **数据模型（Data Model）**：这是模板用来获取数据的对象集合，可以是Java Map、POJO、Java集合等。
- **配置（Configuration）**：定义FreeMarker的运行时环境，如模板加载路径、缓存策略等。
### 3. 模板语法
- **变量（Variable）**：用`${}`包围，如`${name}`表示输出变量`name`的值。
- **文本（Text）**：模板中的所有非指令文本都会被原样输出。
- **注释（Comment）**：用`<#-- ... -->`包围，内容不会被输出。
- **三元运算符（Conditional Expressions）**：`<#if>`、`<#else>`和`<#elseif>`用于条件判断。
- **循环（Loop）**：`<#list>`用于遍历集合，`<#foreach>`是其别名。
- **包含（Include）**：使用`<#include>`指令插入另一个模板。
- **函数（Methods）**：可以通过`.`操作符调用对象的方法，如`${user.getName()}`。
### 4. 数据模型构建
你可以创建一个Java对象并将其放入`Map`，然后设置为FreeMarker的`Configuration`对象的数据模型：
```java
Map<String, Object> dataModel = new HashMap<>();
dataModel.put("user", new User("John Doe"));
FreemarkerConfig freemarkerConfig = new FreemarkerConfig();
freemarkerConfig.setTemplateLoaderPath("classpath:/templates/");
freemarkerConfig.setDefaultEncoding("UTF-8");
Template template = freemarkerConfig.getTemplate("hello.ftl");
Writer out = new StringWriter();
template.process(dataModel, out);
```
### 5. FreeMarker与MVC框架
在Spring MVC中，FreeMarker作为视图解析器使用，配置如下：
```yaml
spring:
freemarker:
enabled: true
prefer-file-system-access: false
template-loader-path: classpath:/templates/
cache: true
suffix: .ftl
```
### 6. 性能优化
- 使用缓存：FreeMarker支持模板缓存，避免每次请求都重新解析模板。
- 避免复杂表达式：复杂的模板表达式可能导致性能下降，尽量保持模板简洁。
- 选择合适的模板加载策略：按需加载或预加载模板。
### 7. 开发工具与调试
使用IDE插件如IntelliJ IDEA的FreeMarker插件，可以进行模板语法高亮、错误检查和快速导航。此外，FreeMarker还提供了在线测试工具，方便在开发过程中调试模板。
### 8. 结论
FreeMarker因其简洁的语法和强大的功能，成为许多Java Web应用的首选模板引擎。理解其基本概念和语法，结合实际项目进行实践，将有助于提高开发效率并实现更好的代码分离。在学习过程中，参考官方文档和社区资源，可以帮助你更好地掌握FreeMarker的高级特性和最佳实践。
