竹笋

首页 » 问答 » 问答 » SpringBoot整合FreeMark
TUhjnbcbe - 2025/7/31 19:30:00
公益中科 http://www.kstejiao.com/

1前言

在之前的文章SpringBoot整合Thymeleaf[1]中,我们学习了如何将模板Thymeleaf整合到SpringBoot中,那今天我们就来看看,另一个老牌的开源免费模板引擎-FreeMarker!

2FreeMarker简介

FreeMarker是一款模板引擎:即一种基于模板和要改变的数据,并用来生成输出文本(HTML网页,电子邮件,配置文件,源代码等)的通用工具。它不是面向最终用户的,而是一个Java类库,是一款程序员可以嵌入他们所开发产品的组件。

以上就是出自FreeMarker的官方定义,我们通过使用FreeMarker,可以将我们所需的模板和数据渲染成HTML,从而实现我们想要的效果。通过将模板与数据分开,让分工更加明确,模板方面则专注于如何将数据进行展现,而在数据方面,我们就可以专注于展示何种数据,下图就是我们以上所描述的FreeMarker的功能。

那接下来,我们就来看看,如何将FreeMarker像Thymeleaf一样整合到我们的SpringBoot中,让我们的开发更加简单。

3准备工作环境准备

正式开始之前,依然给出本文所基于的环境,避免环境问题可能给大家带来的影响。

JDK17(理论上推荐不低于1.8版本)IDEASpringBoot2.x添加FreeMarker依赖

开始之前,我们需要添加FreeMarker的相关依赖,同样这里我们可以选择两种方式。一种是在创建项目时就添加上,另一种则是创建项目后在项目pom.xml文件中手动添加,接下来我们分别来看看两种不同的方式应该如何添加。如果还不清楚如何创建SpringBoot项目,可以参照我之前的一篇文章:创建SpringBoot项目的3种方式[2]。

第一种

在使用IDEA创建SpringBoot新项目时,添加依赖时将模板引擎中的ApacheFreeMarker勾选上。

2.第二种

如果在创建时未添加FreeMarker模板引擎依赖,或者在项目开始创建之初并未有此需求,但后续过程中又增加了该需求,则此时可以直接在项目pom.xml中手动添加FreeMarker依赖即可。

dependencygroupIdorg.springframework.boot/groupIdartifactIdspring-boot-starter-freemarker/artifactId/dependency添加FreeMarker相关配置

添加依赖后,我们需要在项目配置文件application.yml中添加FreeMarker的相关配置。

spring:freemarker:#模板后缀名suffix:.ftl#文档类型content-type:text/html#页面编码charset:UTF-8#页面缓存cache:false#模板路径template-loader-path:classpath:/templates/4编写实体类和Controller编写实体类

创建一个User类,并将其各种setter、getter、构造方法等完成,这里我依然使用了Lombok插件,以便简化我们的代码。关于该插件的更多用法,可以参照我之前的文章:Lombok的安装及使用指南[3]。

package

1
查看完整版本: SpringBoot整合FreeMark