Spring Boot整合FreeMarker全攻略

最新推荐文章于 2025-10-07 19:37:38 发布

原创最新推荐文章于 2025-10-07 19:37:38 发布 · 811 阅读

8 ·

CC 4.0 BY-SA版权

文章标签：

#spring boot #后端 #java

以下是 Spring Boot 集成 FreeMarker 模板引擎的完整实现方案：

一、环境准备与依赖配置

Maven 依赖
需添加 spring-boot-starter-freemarker 和 Web 基础依赖：

<dependency>
    <groupId>org.springframework.boot</groupId>
    <artifactId>spring-boot-starter-freemarker</artifactId>
</dependency>
<dependency>
    <groupId>org.springframework.boot</groupId>
    <artifactId>spring-boot-starter-web</artifactId>
</dependency>

配置文件
在 application.yml 中配置模板路径与开发模式参数：

spring:
  freemarker:
    template-loader-path: classpath:/templates/
    cache: false  # 开发时关闭缓存
    charset: UTF-8
    suffix: .ftl  # 模板文件扩展名

二、核心实现步骤

模板文件存放
在 resources/templates/ 下创建 .ftl 文件（如 hello.ftl）：

<!DOCTYPE html>
<html>
<body>
    <h1>Hello ${userName}!</h1>
</body>
</html>

控制器编写
使用 @Controller 注解（非 @RestController）返回模板名称：

@Controller
public class DemoController {
    @GetMapping("/greet")
    public String greet(Model model) {
        model.addAttribute("userName", "FreeMarker");
        return "hello"; // 对应模板文件名（无后缀）
    }
}

三、高级配置与优化

静态资源处理
静态文件（CSS/JS）需放在 resources/static/ 目录，模板中通过相对路径引用。

全局变量注入
通过配置类添加共享变量：

@Configuration
public class FreeMarkerConfig implements FreeMarkerConfigurer {
    @Override
    public void postProcessConfiguration(Configuration config) {
        config.setSharedVariable("appVersion", "1.0.0");
    }
}