SpringBoot-整合Thymeleaf或FreeMarker框架

SpringBoot支持的前端模板技术有Thymeleaf、FreeMarker、Jsp等,一般标配为Thymeleaf(官方建议),也可用FreeMarker。不建议使用Jsp,因为有些功能不能使用。
Jsp局限:

  • 如果您使用 war 打包,在 Jetty 和 Tomcat 中可以正常工作,使用 java -jar 启动时,可执行的 war 可正常使用,并且还可以部署到任何标准容器。使用可执行 jar 时不支持 JSP。
  • Undertow 不支持 JSP。
  • 创建自定义的 error.jsp 页面不会覆盖默认错误处理视图,应该使用自定义错误页面来代替。

模板默认从 src/main/resources/templates获取。这里只介绍Thymeleaf和FreeMarker。

Thymeleaf

Thymeleaf是一个用于编写动态页面模板引擎,可以直接html文本,达到快速渲染页面的目的。

依赖

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

thymeleaf的配置

spring.thymeleaf.cache=true #启用模板缓存。 
spring.thymeleaf.check-template=true #在呈现模板之前检查模板是否存在。
spring.thymeleaf.check-template-location=true #检查模板位置是否存在。
spring.thymeleaf.content-type=text / html #Content-Type值。 
spring.thymeleaf.enabled=true #启用MVC Thymeleaf视图分辨率。 
spring.thymeleaf.encoding=UTF-8 #模板编码。 
spring.thymeleaf.excluded-view-names= #应该从解决方案中排除的视图名称的逗号分隔列表。 
spring.thymeleaf.mode=HTML5 #应用于模板的模板模式。另请参见StandardTemplateModeHandlers。 
spring.thymeleaf.prefix=classpath:/ templates / #在构建URL时预先查看名称的前缀。 
spring.thymeleaf.suffix=.html #构建URL时附加到查看名称的后缀。 
spring.thymeleaf.template-resolver-order= #链中模板解析器的顺序。 
spring.thymeleaf.view-names= #可以解析的视图名称的逗号分隔列表。/ templates / #在构建URL时先查看名称的前缀。 
spring.thymeleaf.suffix =.html #构建URL时附加到查看名称的后缀。 
spring.thymeleaf.template-resolver-order= #链中模板解析器的顺序。 
spring.thymeleaf.view-names= #可以解析的视图名称的逗号分隔列表。/ templates / #在构建URL时先查看名称的前缀。 
spring.thymeleaf.suffix= .html #构建URL时附加到查看名称的后缀。 
spring.thymeleaf.template-resolver-order= #链中模板解析器的顺序。 
spring.thymeleaf.view-names= #可以解析的视图名称的逗号分隔列表。

其中有值的则表示默认值。常见配置如下:

spring.thymeleaf.cache=true
spring.thymeleaf.encoding=UTF-8
spring.thymeleaf.mode=HTML5
spring.thymeleaf.prefix=classpath:/templates/
spring.thymeleaf.suffix=.html

demo案例

开发环境
- java版本:jdk1.8
- IDE:IntelliJ IDEA 2018.3.1
创建工程

1、用IDE创建springboot 项目,主要配置如下:



2、选择thymeleaf依赖。也可以不选,直接在pom文件中加依赖(FreeMarker同)



3、创建控制类及前端HTML文件
IndexController.java控制类,用来处理请求并返回
package com.example.demo.controller;

import org.springframework.stereotype.Controller;
import org.springframework.web.bind.annotation.RequestMapping;
import org.springframework.web.servlet.ModelAndView;

/**
 * 〈一句话功能简述〉<br> 
 * 〈〉
 *
 * @author Danny
 * @since 1.0.0
 */
@Controller
@RequestMapping("/v1.0")
public class IndexController {

  @RequestMapping("/index")
  public ModelAndView test(ModelAndView mv){
    mv.setViewName("index");
    mv.addObject("name","张三");
    return mv;
  }
}

index.html要访问的前端页面

<!DOCTYPE html>
<html lang="en" xmlns:th="http://www.w3.org/1999/xhtml">
<head>
    <meta charset="UTF-8">
    <title>Title</title>
</head>
<body>
    <p th:text="'欢迎'  +  ${name}"></p>
</body>
</html>
启动服务,访问 http://localhost:8080/v1.0/index

注意:这里没有去设置themeleaf模板相关配置,一切采用默认值,实际情况根据项目需求添加配置。

FreeMarker

FreeMarker 是一个基于模板生成文本输出的通用工具,使用纯 Java 编写,它被设计用来生成 HTML Web 页面。

依赖

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

freemarker的配置

#设置是否允许HttpServletRequest属性重写(隐藏)控制器生成同名的模型属性。
spring.freemarker.allow-request-override=false
#设置是否允许HttpSession属性重写(隐藏)控制器生成同名的模型属性。
spring.freemarker.allow-session-override=false
#启用模板缓存
spring.freemarker.cache=false
# 模板编码
spring.freemarker.charset=UTF-8
# 检查模板位置是否存在
spring.freemarker.check-template-location=true
# 内容类型值
spring.freemarker.content-type=text/html
# 启用mvc视图解决方案
spring.freemarker.enabled=true
# 是否将所有请求属性添加到与模板合并之前的模型中
spring.freemarker.expose-request-attributes=false
# 设置是否所有HttpSession属性应该与模板融合之前添加到模型
spring.freemarker.expose-session-attributes=false
# 设置是否公开一个由Spring的macro库使用RequestContext,在名为“springMacroRequestContext”。
spring.freemarker.expose-spring-macro-helpers=true
# 是否开启模板文件的热部署
spring.freemarker.prefer-file-system-access=true
# 视图前缀
spring.freemarker.prefix=
# Name of the RequestContext attribute for all views.
spring.freemarker.request-context-attribute=
# Well-known FreeMarker keys which will be passed to FreeMarker's Configuration.
spring.freemarker.settings.*=
# 视图的后缀
spring.freemarker.suffix=.ftlh
# 模板路径配置,多个模板路径用分号分割
spring.freemarker.template-loader-path=classpath:/templates/
# 视图解析的白名单
spring.freemarker.view-names=

其中有值的则表示默认值。常见配置如下:

spring.freemarker.template-loader-path=classpath:/templates/
spring.freemarker.prefix=
spring.freemarker.suffix=.ftlh
spring.freemarker.charset=UTF-8
spring.freemarker.cache=false

demo案例

同thymeleaf案例一样,区别在于依赖、配置文件和前端文件,依赖不再多说

配置文件
 spring:
    freemarker:
    suffix: .ftl
index.ftl前端文件
<!DOCTYPE html>
<html lang="en">
<head>
    <meta charset="UTF-8">
    <title>Title</title>
</head>
<body>
    欢迎${name}
</body>
</html>

启动服务,访问 http://localhost:8080/v1.0/index

©著作权归作者所有,转载或内容合作请联系作者
  • 序言:七十年代末,一起剥皮案震惊了整个滨河市,随后出现的几起案子,更是在滨河造成了极大的恐慌,老刑警刘岩,带你破解...
    沈念sama阅读 194,088评论 5 459
  • 序言:滨河连续发生了三起死亡事件,死亡现场离奇诡异,居然都是意外死亡,警方通过查阅死者的电脑和手机,发现死者居然都...
    沈念sama阅读 81,715评论 2 371
  • 文/潘晓璐 我一进店门,熙熙楼的掌柜王于贵愁眉苦脸地迎上来,“玉大人,你说我怎么就摊上这事。” “怎么了?”我有些...
    开封第一讲书人阅读 141,361评论 0 319
  • 文/不坏的土叔 我叫张陵,是天一观的道长。 经常有香客问我,道长,这世上最难降的妖魔是什么? 我笑而不...
    开封第一讲书人阅读 52,099评论 1 263
  • 正文 为了忘掉前任,我火速办了婚礼,结果婚礼上,老公的妹妹穿的比我还像新娘。我一直安慰自己,他们只是感情好,可当我...
    茶点故事阅读 60,987评论 4 355
  • 文/花漫 我一把揭开白布。 她就那样静静地躺着,像睡着了一般。 火红的嫁衣衬着肌肤如雪。 梳的纹丝不乱的头发上,一...
    开封第一讲书人阅读 46,063评论 1 272
  • 那天,我揣着相机与录音,去河边找鬼。 笑死,一个胖子当着我的面吹牛,可吹牛的内容都是我干的。 我是一名探鬼主播,决...
    沈念sama阅读 36,486评论 3 381
  • 文/苍兰香墨 我猛地睁开眼,长吁一口气:“原来是场噩梦啊……” “哼!你这毒妇竟也来了?” 一声冷哼从身侧响起,我...
    开封第一讲书人阅读 35,175评论 0 253
  • 序言:老挝万荣一对情侣失踪,失踪者是张志新(化名)和其女友刘颖,没想到半个月后,有当地人在树林里发现了一具尸体,经...
    沈念sama阅读 39,440评论 1 290
  • 正文 独居荒郊野岭守林人离奇死亡,尸身上长有42处带血的脓包…… 初始之章·张勋 以下内容为张勋视角 年9月15日...
    茶点故事阅读 34,518评论 2 309
  • 正文 我和宋清朗相恋三年,在试婚纱的时候发现自己被绿了。 大学时的朋友给我发了我未婚夫和他白月光在一起吃饭的照片。...
    茶点故事阅读 36,305评论 1 326
  • 序言:一个原本活蹦乱跳的男人离奇死亡,死状恐怖,灵堂内的尸体忽然破棺而出,到底是诈尸还是另有隐情,我是刑警宁泽,带...
    沈念sama阅读 32,190评论 3 312
  • 正文 年R本政府宣布,位于F岛的核电站,受9级特大地震影响,放射性物质发生泄漏。R本人自食恶果不足惜,却给世界环境...
    茶点故事阅读 37,550评论 3 298
  • 文/蒙蒙 一、第九天 我趴在偏房一处隐蔽的房顶上张望。 院中可真热闹,春花似锦、人声如沸。这庄子的主人今日做“春日...
    开封第一讲书人阅读 28,880评论 0 17
  • 文/苍兰香墨 我抬头看了看天上的太阳。三九已至,却和暖如春,着一层夹袄步出监牢的瞬间,已是汗流浃背。 一阵脚步声响...
    开封第一讲书人阅读 30,152评论 1 250
  • 我被黑心中介骗来泰国打工, 没想到刚下飞机就差点儿被人妖公主榨干…… 1. 我叫王不留,地道东北人。 一个月前我还...
    沈念sama阅读 41,451评论 2 341
  • 正文 我出身青楼,却偏偏与公主长得像,于是被迫代替她去往敌国和亲。 传闻我的和亲对象是个残疾皇子,可洞房花烛夜当晚...
    茶点故事阅读 40,637评论 2 335

推荐阅读更多精彩内容