spring-boot-starter-thymeleaf 避坑指南

2023-03-02,,,,

第一步:pom配置环境 先不要管包是做什么的 总之必须要有 否则进坑

<!--避坑包-->
<dependency>
<groupId>net.sourceforge.nekohtml</groupId>
<artifactId>nekohtml</artifactId>
<version>1.9.22</version>
</dependency>
<!--解析html包-->
<dependency>
<groupId>org.springframework.boot</groupId>
<artifactId>spring-boot-starter-thymeleaf</artifactId>
</dependency>

第二步:配置application.properties

注意 1.结尾一定要有------ #thymeleaf end --------- 否则掉坑

2.#模板编码 spring.thymeleaf.mode=LEGACYHTML5

要想使用LEGACYHTML5这个编码格式必须引入 上面pom中‘避坑包’ 否则用不了

肯定有人要问为什么不用HTML5 ,你可以试试

因为你可能会发现在默认配置下,thymeleaf对.html的内容要求很严格,比如<meta charset=”UTF-8″ />,

如果少最后的标签封闭符号/,就会报错而转到错误页。也比如你在使用Vue.js这样的库,然后有<div v-cloak></div>这样的html代码,

也会被thymeleaf认为不符合要求而抛出错误。因此,建议增加下面这段:

spring.thymeleaf.mode = LEGACYHTML5

spring.thymeleaf.mode的默认值是HTML5,其实是一个很严格的检查,改为LEGACYHTML5可以得到一个可能更友好亲切的格式要求。

需要注意的是,LEGACYHTML5需要搭配一个额外的库NekoHTML才可用 也就时上文的避坑包

#<!-- 关闭thymeleaf缓存 开发时使用 否则没有实时画面-->
spring.thymeleaf.cache=false
## 检查模板是否存在,然后再呈现
spring.thymeleaf.check-template-location=true
#Content-Type值
spring.thymeleaf.content-type=text/html
#启用MVC Thymeleaf视图分辨率
spring.thymeleaf.enabled=true
## 应该从解决方案中排除的视图名称的逗号分隔列表
##spring.thymeleaf.excluded-view-names=
#模板编码
spring.thymeleaf.mode=LEGACYHTML5
# 在构建URL时预先查看名称的前缀
spring.thymeleaf.prefix=classpath:/templates/
# 构建URL时附加查看名称的后缀.
spring.thymeleaf.suffix=.html
# 链中模板解析器的顺序
#spring.thymeleaf.template-resolver-order= o
# 可以解析的视图名称的逗号分隔列表
#spring.thymeleaf.view-names=
#thymeleaf end

这是我的静态网页结构

第三步:controller层

注入的时候一定要是Controller 不要是RestController 因为它是rest接口(json格式) 是解析不到html

@Controller 注意不要是RestController

@RequestMapping(value = "/")
public class MainController { @Autowired
MainService mainService; @GetMapping(value = "/home")
public String homePage(){ return "test";
}
}

实在没有那么多需求 就用原生态 随便玩想跳哪里跳哪里

@GetMapping(value = "/home")
public void homePage(HttpServletResponse response)throws IOException{
response.sendRedirect("index.html");
// return "index";
}

需要传值的话,java界面使用正常的方法就可

model.addAttribute("yu","Hello world Thymeleaf");

在html 界面需在html 标签里引用地址 。thymeleaf 使用的是OGNL 标签,和jstl 标签差不多个人感觉,例如:

<html lang="en" xmlns:th="http://www.thymeleaf.org">
<!--/*@thymesVar id="yu" type="java"*/-->
<p th:text="${yu}"></p>

我是用的是IDEA 编译 使用标签的话 会报错 只有添加<!--/*@thymesVar id="yu" type="java"*/--> 注释才不会报错

标签的话不需要自己写,点击左边报错的小红点会提示标签注释,自动生成

最后收工,这么简单的东西也是走过腥风血雨过来的!!!

spring-boot-starter-thymeleaf 避坑指南的相关教程结束。