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文档。私信博主(资料)领取,祝大家更上一层楼!!!