Spring Boot 集成 FreeMarker 详解案例

“年轻就不应该让自己过得太舒服” – From yong

一、Springboot 那些事

SpringBoot 很方便的集成 FreeMarker ,DAO 数据库操作层依旧用的是 Mybatis,本文将会一步一步到来如何集成 FreeMarker 以及配置的详解:

Springboot 那些事:

系类文章:

《Spring Boot 之 RESRful API 权限控制》 《Spring Boot 之 HelloWorld 详解》 《Springboot 整合 Mybatis 的完整 Web 案例》 《Springboot 实现 Restful 服务,基于 HTTP / JSON 传输》 《Springboot 集成 FreeMarker》

二、运行 springboot-freemarker 工程

git clone 下载工程 springboot-learning-example ,项目地址见 GitHub – https://github.com/JeffLi1993/springboot-learning-example。下面开始运行工程步骤(Quick Start):

1. 数据库准备

a. 创建数据库 springbootdb:

b. 创建表 city :(因为我喜欢徒步)

c. 插入数据

2. 项目结构介绍

项目结构如下图所示:

org.spring.springboot.controller – Controller 层 org.spring.springboot.dao – 数据操作层 DAO org.spring.springboot.domain – 实体类 org.spring.springboot.service – 业务逻辑层 Application – 应用启动类 resources/application.properties – 应用配置文件,应用启动会自动读取配置 resources/web – *.ftl 文件,是 FreeMarker 文件配置路径。在 application.properties 配置 resources/mapper – DAO Maper XML 文件

3. 改数据库配置

打开 application.properties 文件, 修改相应的数据源配置,比如数据源地址、账号、密码等。(如果不是用 MySQL,pom 自行添加连接驱动依赖,然后修改驱动名配置。)

4. 编译工程

在项目根目录 springboot-learning-example,运行 maven 指令:

mvn clean install

5. 运行工程

右键运行 springboot-freemarker 工程 Application 应用启动类的 main 函数,然后在浏览器访问:

获取 ID 编号为 1 的城市信息页面:

获取城市列表页面:

6. 补充

运行环境:JDK 7 或 8,Maven 3.0+

技术栈:SpringBoot、Mybatis、FreeMarker

三、 springboot-freemarker 工程配置详解

具体代码见 GitHub – https://github.com/JeffLi1993/springboot-learning-example

1.pom.xml 依赖

pom.xml 代码如下:

2. 配置 FreeMarker

然后在 application.properties 中加入 FreeMarker 相关的配置:

这是我这块的配置,如果需要更多的 FreeMarker 配置,可以查看下面的详解:

3. 展示层 Controller 详解

a. 这里不是走 HTTP + JSON 模式,使用了 @Controller 而不是先前的 @RestController

b. 方法返回值是 String 类型,和 application.properties 配置的 Freemarker 文件配置路径下的各个 *.ftl 文件名一致。这样才会准确地把数据渲染到 ftl 文件里面进行展示。

c. 用 Model 类,向 Model 加入数据,并指定在该数据在 Freemarker 取值指定的名称。

四、小结

FreeMarker 是常用的模板引擎,很多开发 Web 的必选。

最后给大家分享Spring系列的学习笔记和面试题,包含spring面试题、spring cloud面试题、spring boot面试题、spring教程笔记、spring boot教程笔记、最新阿里巴巴开发手册(63页PDF总结)、2022年Java面试手册。一共整理了1184页PDF文档。私信博主(资料)领取,祝大家更上一层楼!!!

经验分享 程序员 微信小程序 职场和发展