<think>首先，用户的问题是：“我想学习如何在Spring Boot中
使用FreeMarker模板引擎 请问Spring Boot整合
FreeMarker模板引擎教程”。这是一个请求教程的问题，所以我需要提供一个结构清晰、逐步的指南。
系统级指令：
- 所有行内数学表达式必须
使用$...$格式，但在这个上下文中，数学表达式可能不相关。用户的问题是关于Spring Boot和
FreeMarker的，所以数学表达式可能不需要。如果有涉及数学的地方，我会
使用指定格式。
- 独立公式必须
使用$$...$$格式并单独成段。同样，可能不适用。
- LaTeX语法正确：确保任何LaTeX
使用正确。
-
使用中文回答：整个回答要用中文。
- 生成相关问题：在回答末尾，生成相关问题。
- 回答中引用的段落末尾自然地添加引用标识：用户提供了引用[^1]到[^5]，我需要自然地引用它们。引用是来自站内内容，关于Spring Boot整合
FreeMarker的教程点。
用户提供的引用：
- [^1]: 添加
FreeMarker依赖的代码片段。
- [^2]: 介绍
FreeMarker模板引擎。
- [^3]: 添加
FreeMarker和Web依赖。
- [^4]:
FreeMarker的自动化配置类。
- [^5]: 添加依赖和配置
FreeMarker。
这些引用是示例，我需要自然地引用它们来支持我的回答。用户说“上述引用仅供参考”，所以我应该基于这些内容构建回答。
回答结构：
- 帮助用户逐步解决问题：提供清晰的步骤。
- 保证回答真实可靠：基于我的知识和引用内容。
主题：Spring Boot整合
FreeMarker模板引擎。
关键步骤：
1. 添加依赖：
使用Maven添加Spring Boot Starter
FreeMarker。
2. 配置
FreeMarker：在application.properties或application.yml中配置设置。
3. 创建模板：在src/main/resources/templates中创建.ftl文件。
4. 创建控制器：
使用@Controller注解处理请求并返回视图。
5. 运行和测试：启动应用并访问端点。
参考引用：
- [^1]和[^3]提到添加依赖：<dependency> for spring-boot-starter-
freemarker。
- [^5]提到添加依赖和配置。
- [^4]提到自动化配置类。
- [^2]介绍
FreeMarker。
在回答中自然地引用这些，例如，当讨论依赖时引用[^1]，当讨论配置时引用[^5]。
完整回答结构：
- 引言：简要介绍
FreeMarker和为什么在Spring Boot中
使用它。
- 步骤1：添加依赖（引用[^1]或[^3]）。
- 步骤2：配置
FreeMarker（引用[^5]或[^4]）。
- 步骤3：创建模板文件。
- 步骤4：创建控制器。
- 步骤5：运行和测试。
- 结论：总结。
最后，生成相关问题。
确保
使用中文。
生成相关问题：
- 基于主题，生成2-3个相关问题。
- 例如：如何自定义
FreeMarker配置？如何处理
FreeMarker中的错误？与其他模板引擎的比较。
最终输出：
- 回答部分。
- §§相关问题§§部分。</think>### Spring Boot整合
FreeMarker模板引擎教程
FreeMarker是一个强大的Java模板引擎，常用于生成动态HTML页面、电子邮件内容等。在Spring Boot中整合
FreeMarker非常
简单，得益于其自动化配置特性。Spring Boot提供了`spring-boot-starter-
freemarker`依赖，能快速集成并简化配置。下面我将一步步指导你完成整合过程，确保教程清晰可靠。整个流程包括添加依赖、配置参数、创建模板和控制器、测试运行等。
#### 步骤1: 添加
FreeMarker依赖
首先，在你的Spring Boot项目的`pom.xml`文件中添加
FreeMarker的起步依赖。Spring Boot会自动处理版本兼容性问题。
```xml
<dependencies>
<!--
FreeMarker依赖 -->
<dependency>
<groupId>org.springframework.boot</groupId>
<artifactId>spring-boot-starter-
freemarker</artifactId>
</dependency>
<!-- 如果需要Web功能，添加Web依赖 -->
<dependency>
<groupId>org.springframework.boot</groupId>
<artifactId>spring-boot-starter-web</artifactId>
</dependency>
</dependencies>
```
这一步确保
FreeMarker的核心库被引入。Spring Boot的起步依赖简化了依赖管理，避免手动处理版本冲突[^1][^3][^5]。
#### 步骤2: 配置
FreeMarker参数
Spring Boot为
FreeMarker提供了默认配置，但你可以通过`application.properties`或`application.yml`文件自定义设置。关键配置包括模板路径、文件后缀和缓存设置。
- 在`src/main/resources/application.properties`中添加以下配置：
```properties
# 设置模板文件存放目录（默认是classpath:/templates/）
spring.
freemarker.template-loader-path=classpath:/templates/
# 设置模板文件后缀（默认是.ftl）
spring.
freemarker.suffix=.ftl
# 禁用缓存，开发时方便调试（生产环境应启用）
spring.
freemarker.cache=false
# 设置字符编码
spring.
freemarker.charset=UTF-8
```
Spring Boot的自动化配置类`
FreeMarkerAutoConfiguration`会基于这些属性初始化
FreeMarker，无需手动编码[^4][^5]。如果需要高级配置，可以参考Spring Boot官方文档覆盖默认Bean。
#### 步骤3: 创建
FreeMarker模板文件
在`src/main/resources/templates/`目录下创建你的模板文件（例如`hello.ftl`）。
FreeMarker使用简单语法嵌入动态内容。
- 示例模板`hello.ftl`：
```html
<!DOCTYPE html>
<html>
<head>
<title>
FreeMarker示例</title>
</head>
<body>
<h1>欢迎
使用FreeMarker！</h1>
<p>当前用户: ${user.name}</p>
<p>时间: ${.now?string("yyyy-MM-dd HH:mm:ss")}</p>
</body>
</html>
```
这里，`${user.name}`是动态变量，控制器会传递数据填充它。模板文件后缀默认为`.ftl`，但你可以通过配置修改[^2][^5]。
#### 步骤4: 创建控制器处理请求
编写一个Spring MVC控制器，
使用`@Controller`注解将请求映射到模板视图。通过`Model`对象传递数据给模板。
- 示例控制器`HelloController.java`：
```java
import org.springframework.stereotype.Controller;
import org.springframework.ui.Model;
import org.springframework.web.bind.annotation.GetMapping;
@Controller
public class HelloController {
@GetMapping("/hello")
public String hello(Model model) {
// 向模板传递数据
model.addAttribute("user", new User("张三")); // 假设User是一个
简单的POJO类
return "hello"; // 返回模板文件名（不带后缀）
}
//
简单的User类
public static class User {
private String name;
public User(String name) {
this.name = name;
}
public String getName() {
return name;
}
}
}
```
控制器返回视图名`hello`，Spring Boot会自动查找`hello.ftl`模板并渲染[^2][^3]。
#### 步骤5: 运行和测试应用
启动Spring Boot应用（
使用`mvn spring-boot:run`或IDE运行主类），然后访问`http://localhost:8080/hello`。如果一切正常，你会看到渲染后的HTML页面，显示动态内容。
- **常见问题排查**：
- 如果模板未找到，检查`spring.
freemarker.template-loader-path`配置是否正确。
- 如果数据未显示，确保控制器正确添加了Model属性。
- 开发时禁用缓存（`spring.
freemarker.cache=false`）便于实时更新模板。
#### 总结
通过以上步骤，你已成功在Spring Boot中整合
FreeMarker模板引擎。整个过程只需添加依赖、
简单配置、
编写模板和控制器，Spring Boot的自动化配置大大简化了集成工作[^4]。
FreeMarker适合生成动态Web页面，尤其在邮件模板或报表系统中应用广泛。如果你遇到问题，建议参考Spring Boot官方文档或社区资源。
本文介绍如何使用STS工具创建SpringBoot项目并整合Freemarker模板引擎，包括下载安装STS、配置项目、生成依赖坐标及创建模板文件等步骤。
扫一扫
1828
被折叠的 条评论
为什么被折叠?
到【灌水乐园】发言
