随着Web应用的复杂度不断提升，静态HTML页面已经难以满足现代网站的需求。为了提供更加丰富、交互性强且易于维护的内容，许多开发者转向了模板引擎技术。FreeMarker是一个流行的Java模板引擎，它允许开发人员通过简单的语法来生成文本输出，如HTML网页、电子邮件、配置文件等。本文将详细介绍FreeMarker是什么以及如何在Spring Boot项目中集成和使用FreeMarker来创建动态内容。
什么是 FreeMarker？
FreeMarker 是一个用Java编写的模板引擎，主要用于生成HTML Web页面，但也可以用于生成其他类型的文本内容，比如XML、JSON或任何纯文本格式。FreeMarker 模板语言非常灵活，支持控制结构（如条件判断、循环）、宏定义、模板继承等功能，使得编写复杂的模板变得简单直观。
FreeMarker 的主要特点包括：
- 模板与逻辑分离：FreeMarker专注于表示层，不包含业务逻辑。
- 强大的表达式语言：支持多种数据类型的操作。
- 国际化支持：内置对多语言的支持。
- 高性能：高效的缓存机制确保快速渲染。
在 Spring Boot 中实现 FreeMarker
接下来，我们将逐步介绍如何在Spring Boot应用程序中集成FreeMarker，并创建一个简单的示例来展示其工作原理。
步骤 1: 添加依赖
首先，在pom.xml或build.gradle文件中添加FreeMarker相关的Maven或Gradle依赖。
对于Maven项目，可以添加如下依赖：
<dependency>
<groupId>org.springframework.boot</groupId>
<artifactId>spring-boot-starter-freemarker</artifactId>
</dependency>
步骤 2: 配置 FreeMarker
可以在application.properties或application.yml中配置FreeMarker的基本设置，例如模板目录、编码方式等。
# application.properties
spring.freemarker.template-loader-path=classpath:/templates/
spring.freemarker.cache=false
spring.freemarker.charset=UTF-8
spring.freemarker.check-template-location=true
这里设置了模板加载路径为src/main/resources/templates/，关闭了模板缓存以便于开发过程中实时查看修改效果。
步骤 3: 创建 FreeMarker 模板
在src/main/resources/templates/目录下创建一个名为hello.ftl的模板文件，内容如下：
<!DOCTYPE html>
<html>
<head>
<title>Welcome to FreeMarker!</title>
</head>
<body>
<h1>Hello, ${name}!</h1>
<p>This is a simple example of using FreeMarker in a Spring Boot application.</p>
</body>
</html>
这个模板中使用了${name}占位符，用来接收从控制器传递过来的数据。
步骤 4: 创建控制器
接下来，创建一个控制器来处理HTTP请求，并向模板传递数据。
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 sayHello(Model model) {
model.addAttribute("name", "World");
return "hello";
}
}
这里使用了Model对象来向视图传递属性值。
步骤 5: 运行应用并测试
启动Spring Boot应用后，访问http://localhost:8080/hello，应该能看到由FreeMarker渲染的页面，显示“Hello, World!”的信息。
使用 FreeMarker 的高级功能
除了基本的变量替换外，FreeMarker还提供了丰富的功能来增强模板的表现力：
条件语句：可以使用
<#if>标签来进行条件判断。<#if user.isAdmin> <p>You are an admin.</p> <#else> <p>You are a regular user.</p> </#if>循环：使用
<#list>标签遍历集合。<ul> <#list items as item> <li>${item}</li> </#list> </ul>宏定义：类似于函数，可以重复使用。
<#macro showTitle title> <h1>${title}</h1> </#macro> <@showTitle "Welcome to My Site" />模板继承：子模板可以继承父模板中的布局。
<!-- base.ftl --> <html> <head><title><#include "title.ftl"/></title></head> <body> <div id="header"><#include "header.ftl"/></div> <div id="content"> <#nested /> </div> <div id="footer"><#include "footer.ftl"/></div> </body> </html> <!-- child.ftl --> <#import "base.ftl" as layout> <@layout.base> <h2>This is the content of the child template.</h2> </@layout.base>
结论
通过上述步骤，您已经成功地在Spring Boot项目中集成了FreeMarker，并学会了如何利用它来生成动态的HTML页面。FreeMarker不仅提供了强大的模板语言，还具有良好的性能表现，非常适合用于构建复杂的Web应用。希望这篇文章能帮助您更好地理解和运用FreeMarker，从而提升您的Web开发体验。无论是简单的信息展示还是复杂的用户界面，FreeMarker都能提供一个高效而灵活的解决方案。
