当前位置：首页 > article >正文

[Java实战]Spring Boot 整合 Freemarker (十一)

article 2025/10/2 20:54:52

[Java实战]Spring Boot 整合 Freemarker (十一)

引言

Apache FreeMarker 作为一款高性能的模板引擎，凭借其简洁语法、卓越性能和灵活扩展性，在 Java Web 开发中占据重要地位。结合 Spring Boot 的自动化配置能力，开发者能快速构建动态页面、生成报表或定制代码。本文将系统讲解整合流程、实战技巧、性能优化方案，并针对企业级场景提供深度解决方案。

一、Freemarker 核心优势与适用场景

1. 为什么选择 Freemarker？

特性	说明
高性能	编译型模板引擎，执行效率优于传统 JSP
语法简洁	类似 Python 的直观语法，学习成本低
强类型支持	严格的类型检查，减少运行时错误
多场景适用	支持 HTML、XML、JSON、纯文本等多种输出格式

2. 与 Thymeleaf 对比

维度	Freemarker	Thymeleaf
模板类型	非自然模板（需渲染后查看）	自然模板（浏览器直接预览）
性能	更高（适合高并发场景）	中等
功能扩展	支持自定义指令、宏	依赖方言扩展
集成复杂度	简单	需额外配置布局方言

二、Spring Boot 整合 Freemarker 全流程

1. 环境准备

JDK 1.8+（推荐 LTS 版本）
Spring Boot 2.x（本文基于 2.1.8）
Maven/Gradle（本文使用 Maven）

2. 添加依赖

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

3. 基础配置（application.yml）

spring:freemarker:enabled: true                   # 启用 Freemarkertemplate-loader-path: classpath:/templates/  # 模板路径suffix: .ftl                    # 模板文件后缀charset: UTF-8                  # 编码格式cache: false                    # 开发环境关闭缓存settings:                       # Freemarker 全局配置classic_compatible: true      # 兼容旧版本语法number_format: 0.##           # 数字格式化datetime_format: yyyy-MM-dd HH:mm:ss

三、Freemarker 实战案例

案例 1：基础数据渲染

Controller

@Controller
public class ProductController {@GetMapping("/product")public String productDetail(Model model) {Product product = new Product("iPhone 15", 7999.00, 100);model.addAttribute("product", product);model.addAttribute("discount", 0.15);return "product";}
}

模板（product.ftl）

<!DOCTYPE html>
<html>
<head><title>商品详情</title>
</head>
<body><h1>${product.name}</h1><p>价格: ${product.price?string.currency}</p><p>库存: <#if product.stock &gt; 0><span style="color: green;">有货</span><#else><span style="color: red;">缺货</span></#if></p><p>折后价: ${(product.price * (1 - discount))?string.currency}</p>
</body>
</html>

在这里插入图片描述

案例 2：分页功能实现

分页工具类

public class Page<T> {private List<T> data;private int currentPage;private int totalPages;// Getter/Setter
}

分页模板（list.ftl）

<table><#list page.data as item><tr><td>${item.name}</td></tr></#list>
</table><div class="pagination"><#if page.currentPage &gt; 1><a href="/list?page=${page.currentPage - 1}">上一页</a></#if><span>${page.currentPage}/${page.totalPages}</span><#if page.currentPage < page.totalPages><a href="/list?page=${page.currentPage + 1}">下一页</a></#if>
</div>

四、高阶技巧与性能优化

1. 自定义指令（实现数据脱敏）

public class MaskDirective implements TemplateDirectiveModel {@Overridepublic void execute(Environment env, Map params, TemplateModel[] loopVars, TemplateDirectiveBody body) {String content = params.get("content").toString();int keepLength = Integer.parseInt(params.get("keep").toString());String masked = content.substring(0, keepLength) + "****";env.getOut().write(masked);}
}

注册指令

@Configuration
public class FreemarkerConfig {@Beanpublic FreeMarkerConfigurationFactoryBean getFreeMarkerConfiguration() {FreeMarkerConfigurationFactoryBean config = new FreeMarkerConfigurationFactoryBean();config.setTemplateLoaderPath("classpath:/templates");Map<String, Object> variables = new HashMap<>();variables.put("mask", new MaskDirective());config.setFreemarkerVariables(variables);return config;}
}

模板中使用

<p>手机号: <@mask content="13812345678" keep=3 /></p>

2. 性能优化策略

spring:freemarker:cache: true  # 生产环境开启缓存settings:template_update_delay: 3600  # 模板更新检查间隔（秒）localized_lookup: false      # 关闭本地化查找提升性能

3. 集成其他模板引擎（多引擎共存）

@Configuration
public class MultiTemplateConfig {@Beanpublic ViewResolver freeMarkerViewResolver() {FreeMarkerViewResolver resolver = new FreeMarkerViewResolver();resolver.setPrefix("");resolver.setSuffix(".ftl");resolver.setOrder(1);  # 优先级高于 Thymeleafreturn resolver;}
}

五、常见问题与解决方案

1. 模板文件未找到（404）

检查点：
- 文件是否位于 src/main/resources/templates
- 模板名是否与 Controller 返回的视图名一致
- 文件后缀是否为 .ftl

2. 变量解析失败

错误示例：Expression product.name is undefined
解决：
- 确保 Controller 中通过 model.addAttribute() 添加变量
- 检查变量名拼写（Freemarker 区分大小写）
- 使用 ?? 判空：${product.name!''}

3. 静态资源加载问题

正确引用方式：

<link href="/css/style.css" rel="stylesheet">
<script src="/js/app.js"></script>

确保路径配置：静态资源位于 src/main/resources/static

六、企业级应用扩展

1. 生成 PDF/Word 文档

利用 Freemarker 模板生成 HTML，再通过 Flying Saucer 或 Apache POI 转换为 PDF/Word：

Configuration cfg = new Configuration(Configuration.VERSION_2_3_31);
Template template = cfg.getTemplate("report.ftl");
String html = FreeMarkerTemplateUtils.processTemplateIntoString(template, model);
// 转换为 PDF
ITextRenderer renderer = new ITextRenderer();
renderer.setDocumentFromString(html);
renderer.layout();
renderer.createPDF(outputStream);

2. 集群环境模板热更新

结合 Spring Cloud Config 或 Nacos 实现模板动态加载：

@Scheduled(fixedRate = 60000)  # 每分钟检查更新
public void reloadTemplate() {configuration.clearTemplateCache();
}

七、总结

通过 Spring Boot 整合 Freemarker，开发者能够快速构建高效、灵活的动态页面系统。关键点包括：

快速整合：依赖配置与基础语法
高阶扩展：自定义指令与多引擎共存
性能优化：缓存策略与集群方案
企业级应用：文档生成与动态更新

扩展思考：如何结合 Freemarker 与前端框架（如 React）实现服务端渲染（SSR）？欢迎评论区交流！

附录

Freemarker 官方手册
Spring Boot 模板引擎配置指南

希望本教程对您有帮助，请点赞❤️收藏⭐关注支持！欢迎在评论区留言交流技术细节！

[Java实战]Spring Boot 整合 Freemarker (十一)

[Java实战]Spring Boot 整合 Freemarker (十一) 引言 Apache FreeMarker 作为一款高性能的模板引擎，凭借其简洁语法、卓越性能和灵活扩展性，在 Java Web 开发中占据重要地位。结合 Spring Boot 的自动化配置能力，开发者能快速构建动态页面、…...

编程日记 2025/9/28 21:19:38

LeetCode 高频题实战：如何优雅地序列化和反序列化字符串数组？

文章目录摘要描述题解答案题解代码分析编码方法解码方法示例测试及结果时间复杂度空间复杂度总结摘要在分布式系统中，数据的序列化与反序列化是常见的需求，尤其是在网络传输、数据存储等场景中。LeetCode 第 271 题“字符串的编码与解码”要求我们设…...

编程日记 2025/9/19 20:14:52

为什么拆分高低字节而不直接存入数组

您的代码片段是在将一个16位值（）拆分为高字节和低字节：IR_RF_Signal.length temp_low IR_RF_Signal.length & 0xFF; temp_high IR_RF_Signal.length >> 8; 虽然我在 PX4-Autopilot 仓库中没有找到这段确切的代码，…...

编程日记 2025/9/28 2:37:56

python打卡day22@浙大疏锦行

复习日仔细回顾一下之前21天的内容，没跟上进度的同学补一下进度。作业： 自行学习参考如何使用kaggle平台，写下使用注意点，并对下述比赛提交代码一、数据预处理 import pandas as pd import numpy as np import matplo…...

编程日记 2025/9/16 16:09:09

C#游戏开发中的注意事项

目录一、性能优化：提升游戏运行效率 1. 避免不必要的循环和迭代 2. 减少字符串拼接 3. 利用Unity的生命周期函数 4. 使用对象池（Object Pooling）二、内存管理：避免内存泄漏和资源浪费 1. 及时释放非托管资源 2. 避免空引用异常 3. 合理使用引用类型和值类型 4. …...

编程日记 2025/9/20 4:34:10

Spring Boot项目(Vue3+ElementPlus+Axios+MyBatisPlus+Spring Boot前后端分离)

下载地址： 前端：https://download.csdn.net/download/2401_83418369/90811402 后端：https://download.csdn.net/download/2401_83418369/90811405 一、前端vue部分的搭建这里直接看另一期刊的搭建Vue前端工程部分前端vue后端ssm项目_v…...

编程日记 2025/9/21 0:13:54

Spyglass：在batch/shell模式下运行目标的顶层是什么？

相关阅读 Spyglasshttps://blog.csdn.net/weixin_45791458/category_12828934.html?spm1001.2014.3001.5482 除了可以在图形用户界面(GUI)中运行目标外，使用Batch模式或Shell模式也可以运行目标，如下面的命令所示。 % spyglass -project test.prj -ba…...

编程日记 2025/9/19 4:19:15

没有Mac，我是怎么上传IPA到App Store的？

没有Mac，我是怎么上传IPA到App Store的？ 最近赶一个小项目上线，写的是一个Flutter做的App。安卓版本一晚上搞定，iOS上架却差点把人整崩。不是我技术菜，是实在太麻烦了。最关键的，是我这台Windows笔电根本…...

编程日记 2025/9/22 0:26:13

微服务架构中如何保证服务间通讯的安全

在微服务架构中，保证服务间通信的安全至关重要。服务间的通信通常是通过HTTP、gRPC、消息队列等方式实现的，而这些通信链路可能面临多种安全风险。为了应对这些风险，可以采取多种措施来保证通信安全。常见的服务间通信风险 1.数据泄露：在服务间通信过程中，敏感数据可能会…...

编程日记 2025/9/18 13:12:49

2025-05-11 项目绩效域记忆逻辑管理

好的，我们可以用一个故事来帮助记忆这些规划绩效域的要素，同时通过逻辑关系来串联它们。以下是一个故事化的版本： 《项目管理的奇幻之旅》在一个遥远的王国里，有一个勇敢的项目经理名叫小K。小K被国王赋予了一个艰巨的任务&…...

编程日记 2025/6/21 6:48:15

工具篇-Cherry Studio之MCP使用

一、添加MCP 打开Cherry Studio，如果没有可以到官网下载：Cherry Studio 官方网站 - 全能的AI助手按上面步骤打开同步服务器 1、先去注册ModelScope，申请令牌 2、再打开MCP广场，找到高德MCP 选择工具测试，这里有个高德的api key需要申请打开如下地址高德开放平…...

编程日记 2025/9/18 13:12:46

DeepSeek“智”造：解锁旅游行业新玩法

目录一、DeepSeek 简介1.1 DeepSeek 技术原理1.2 DeepSeek 在 AI 领域地位二、DeepSeek 在旅游攻略生成的应用2.1 生成流程展示2.2 优势分析2.3 实际案例剖析三、DeepSeek 助力旅游宣传文案创作3.1 文案创作模式3.2 效果评估3.3 创意亮点挖掘四、DeepSeek 优化游客咨询服务…...

编程日记 2025/8/7 23:07:23

LOJ 6346 线段树：关于时间 Solution

Description 给定序列 a ( a 1 , a 2 , ⋯ , a n ) a(a_1,a_2,\cdots,a_n) a(a1,a2,⋯,an)，另有一个存储三元组的列表 L L L. 有 m m m 个操作分两种： add ⁡ ( l , r , k ) \operatorname{add}(l,r,k) add(l,r,k)：将 ( l , r , …...

编程日记 2025/6/17 14:15:11

java 多核，多线程，分布式并发编程的现状 :从本身的jdk ,到 spring ,到其它第三方。

Java 在多核、多线程和高性能编程领域提供了丰富的现成框架和工具，既有标准库中的并发组件，也有第三方框架。以下是一些关键框架及其应用场景的总结：便于后面我们站在巨人的肩膀上，继续前行一、Java 标准库中的多线程框架 Execut…...

编程日记 2025/6/7 12:05:23

httpclient请求出现403

问题 httpclient请求对方服务器报403，用postman是可以的解决方案: request.setHeader( “User-Agent” ,“Mozilla/5.0 (Windows NT 6.1; Win64; x64; rv:50.0) Gecko/20100101 Firefox/50.0” ); // 设置请求头原因： 因为没有设置为浏览器形式&#…...

编程日记 2025/6/18 4:34:49

Python 运维脚本

1、备份文件 import os import shutil# 定义配置文件目录和备份目录的路径 config_dir "/root/python/to/config/files/" backup_dir "/root/python/to/backup/"# 遍历配置文件目录中的所有文件 for filename in os.listdir(config_dir):# 如果文件名以…...

编程日记 2025/9/18 13:12:54

MySQL数据库常见面试题之三大范式

写在前面此文章大部分不会引用最原始的概念，采用说人话的方式。面试题：三大范式是什么？目的是什么？必须遵循吗？ 假设有一张表（学号，姓名，课程，老师） 是…...

编程日记 2025/9/17 8:02:03

大模型项目：普通蓝牙音响接入DeepSeek，解锁语音交互新玩法

本文附带视频讲解【代码宇宙019】技术方案：蓝牙音响接入DeepSeek，解锁语音交互新玩法_哔哩哔哩_bilibili 目录效果演示核心逻辑技术实现大模型对话（技术： LangChain4j 接入 DeepSeek） 语音识别（…...

编程日记 2025/9/18 20:00:45

C/C++复习--C语言隐式类型转换

目录什么是隐式类型转换？整型提升规则与示例符号位扩展的底层逻辑算术转换类型层次与转换规则混合类型运算的陷阱隐式转换的实际应用与问题代码示例分析常见错误与避免方法总结与最佳实践 1. 什么是隐式类型转换？ 隐式类型转换是C语言在编译阶段…...

编程日记 2025/7/12 7:03:59

Pandas 时间处理利器：to_datetime() 与 Timestamp() 深度解析

Pandas 时间处理利器：to_datetime() 与 Timestamp() 深度解析在数据分析和处理中，时间序列数据扮演着至关重要的角色。Pandas 库凭借其强大的时间序列处理能力，成为 Python 数据分析领域的佼佼者。其中，to_datetime() 函数和 Ti…...

编程日记 2025/8/2 23:41:51

单链表设计与实现

01. 单链表简介在数据结构中，单链表的实现可以分为带头结点和不带头结点两种方式，这里我们讨论第二种方式。头结点：链表第一个节点不存实际数据，仅作为辅助节点指向首元节点（第一个数据节点）。头指…...

编程日记 2025/9/18 0:48:50

JDS-算法开发工程师-第9批

单选题 print(fn.__default__) 哪一个不是自适应学习率的优化算法 (选项：Adagrad，RMSprop，Adam，Momentum，动量法在梯度下降的基础上，加入了“惯性”概念，通过累积历史的梯度更新来加速收敛&…...

编程日记 2025/6/28 19:30:14

Git标签删除脚本解析与实践：轻松管理本地与远程标签

Git 标签删除脚本解析与实践：轻松管理本地与远程标签在 Git 版本控制系统中，标签常用于标记重要的版本节点，方便追溯和管理项目的不同阶段。随着项目的推进，一些旧标签可能不再需要，此时就需要对它们进行清理。本文将通过一个完整的脚本，详细介绍如何删除本地和远程的 …...

编程日记 2025/6/24 23:24:23

Python中，async和with结合使用，有什么好处？

在Python的异步编程中，async和with的结合使用（即async with）为开发者提供了一种优雅且高效的资源管理模式。这种组合不仅简化了异步代码的编写，还显著提升了程序的健壮性和可维护性。以下是其核心优势及典型应用场景的分析&#x…...

编程日记 2025/9/4 22:29:09

springboot生成二维码到海报模板上 QRCodeController package com.ruoyi.web.controller.app;import com.google.zxing.WriterException; import com.ruoyi.app.domain.Opportunity; import com.ruoyi.app.tool.QRCodeGenerator; import com.ruoyi.common.core.page.TableDat…...

编程日记 2025/9/19 6:15:03

SEO长尾关键词布局优化法则

内容概要在SEO优化体系中，长尾关键词的精准布局是突破流量瓶颈的关键路径。相较于竞争激烈的核心词，长尾词凭借其高转化率和低竞争特性，成为内容矩阵流量裂变的核心驱动力。本节将系统梳理长尾关键词布局的核心逻辑框架，涵盖从需…...

编程日记 2025/9/19 20:06:09

python：trimesh 用于 STL 文件解析和 3D 操作

python：trimesh 是一个用于处理三维模型的库，支持多种格式的导入导出，比如STL、OBJ等，还包含网格操作、几何计算等功能。 Python Trimesh 库使用指南安装依赖库 pip install trimesh Downloading trimesh-4.6.8-py3-none-any.w…...

编程日记 2025/9/19 2:30:50

应急响应基础模拟靶机-security2

PS:杰克创建的流量包(result.pcap)在root目录下，请根据已有信息进行分析 1、首个攻击者扫描端口使用的工具是？ 2、后个攻击者使用的漏洞扫描工具是？ 3、攻击者上传webshell的绝对路径及User-agent是什么？ 4、攻击者反弹shell的…...

编程日记 2025/9/20 2:07:45

ROS 2 FishBot PID控制电机代码

#include <Arduino.h> #include <Wire.h> #include <MPU6050_light.h> #include <Esp32McpwmMotor.h> #include <Esp32PcntEncoder.h>Esp32McpwmMotor motor; // 创建一个名为motor的对象，用于控制电机 Esp32PcntEncoder enco…...

编程日记 2025/9/21 14:20:32

Bash 字符串语法糖详解

Bash 作为 Linux 和 Unix 系统中最常用的 Shell 之一，其字符串处理能力是脚本开发者的核心技能之一。为了让字符串操作更高效、更直观，Bash 提供了丰富的语法糖（syntactic sugar）。这些语法糖通过简洁的语法形式，隐藏了…...

编程日记 2025/9/9 19:51:59

[Java实战]Spring Boot 整合 Freemarker (十一)

引言

一、Freemarker 核心优势与适用场景

1. 为什么选择 Freemarker？

2. 与 Thymeleaf 对比

二、Spring Boot 整合 Freemarker 全流程

1. 环境准备

2. 添加依赖

3. 基础配置（application.yml）

三、Freemarker 实战案例

案例 1：基础数据渲染

Controller

模板（product.ftl）

案例 2：分页功能实现

分页工具类

分页模板（list.ftl）

四、高阶技巧与性能优化

1. 自定义指令（实现数据脱敏）

注册指令

模板中使用

2. 性能优化策略

3. 集成其他模板引擎（多引擎共存）

五、常见问题与解决方案

1. 模板文件未找到（404）

2. 变量解析失败

3. 静态资源加载问题

六、企业级应用扩展

1. 生成 PDF/Word 文档

2. 集群环境模板热更新

七、总结

附录

相关文章：