SpringBoot集成Thymeleaf及Thymeleaf常见语法

一、Thymeleaf概述

1.1 Thymeleaf是一个流行的模板引擎,该模板引擎采用Java语言开发;
1.2 模板引擎是一个技术名词,是跨领域跨平台的概念,在Java语言体系下有模板引擎,在C#、PHP语言体系下也有模板引擎,甚至在JavaScript中也会用到模板引擎技术;
1.3 Java生态下的模板引擎有 Thymeleaf 、Freemaker、Velocity、Beetl(国产) 等;
1.4 Thymeleaf模板既能用于web环境下,也能用于非web环境下,在非web环境下,它能直接显示模板上的静态数据,在web环境下,它能像JSP一样从后台接收数据并替换掉模板上的静态数据;
1.5 Thymeleaf 它是基于HTML的,以HTML标签为载体,Thymeleaf 要寄托在HTML的标签下实现对数据的展示;
1.6 Spring boot 集成了thymeleaf模板技术,并且spring boot官方也推荐使用thymeleaf来替代JSP技术;

二、集成步骤

2.1 第一步:在Maven中引入Thymeleaf的依赖,加入以下依赖配置即可:


    org.springframework.boot
    spring-boot-starter-thymeleaf

2.2 第二步:在Spring boot的核心配置文件application.properties中对Thymeleaf进行配置:

#开发阶段,建议关闭thymeleaf的缓存
spring.thymeleaf.cache=false

#使用遗留的html5以去掉对html标签的校验
spring.thymeleaf.mode=LEGACYHTML5

ps:在使用springboot的过程中,如果使用thymeleaf作为模板文件,则要求HTML格式必须为严格的html5格式,
必须有结束标签,否则会报错;如果不想对标签进行严格的验证,使用spring.thymeleaf.mode=LEGACYHTML5
去掉验证,去掉该验证,则需要引入如下依赖,否则会报错:

    net.sourceforge.nekohtml
    nekohtml


    org.unbescape
    unbescape
    1.1.5.RELEASE

ps:NekoHTML是一个Java语言的 HTML扫描器和标签补全器 ,这个解析器能够扫描HTML文件并“修正”HTML文档
中的常见错误。NekoHTML能增补缺失的父元素、自动用结束标签关闭相应的元素,修复不匹配的内嵌元素标签等;

2.3 第三步:写一个Controller去映射到模板页面(和SpringMVC基本一致),比如:

@RequestMapping("/index")
public String index (Model model) {
    model.addAttribute("data", "恭喜,Spring boot集成 Thymeleaf成功!");
    //return 中就是你页面的名字(不带.html后缀)
    return "index";
}

2.4 第四步:在src/main/resources的templates下新建一个index.html页面用于展示数据:HTML页面的元素中加入以下属性:xmlns:th=“http://www.thymeleaf.org”





Spring boot集成 Thymeleaf


Spring boot集成 Thymeleaf

ps:Springboot使用thymeleaf作为视图展示,约定将模板文件放置在src/main/resource/templates目录下,静态资源放置在src/main/resource/static目录下

三、Thymeleaf 常用语法

3.1 变量输出与字符串操作
3.1.1 th:text

th:text
在页面中输出值

3.1.2 th:value

th:value
可以将一个值放入到 input 标签的 value 中

3.1.3 判断字符串

Thymeleaf 内置对象
注意语法:
1,调用内置对象一定要用#
2,大部分的内置对象都以 s 结尾 strings、numbers、dates

${#strings.isEmpty(key)}
判断字符串是否为空,如果为空返回 true,否则返回 false

${#strings.contains(msg,'T')}
判断字符串是否包含指定的子串,如果包含返回 true,否则返回 false

${#strings.startsWith(msg,'a')}
判断当前字符串是否以子串开头,如果是返回 true,否则返回 false

${#strings.endsWith(msg,'a')}
判断当前字符串是否以子串结尾,如果是返回 true,否则返回 false

${#strings.length(msg)}
返回字符串的长度

${#strings.indexOf(msg,'h')}
查找子串的位置,并返回该子串的下标,如果没找到则返回-1

${#strings.substring(msg,13)}
${#strings.substring(msg,13,15)}
截取子串,用户与 jdk String 类下 SubString 方法相同

${#strings.toUpperCase(msg)}
${#strings.toLowerCase(msg)}
字符串转大小写。

3.2 日期格式化处理

${#dates.format(key)}
格式化日期,默认的以浏览器默认语言为格式化标准

${#dates.format(key,'yyy/MM/dd')}
按照自定义的格式做日期转换

${#dates.year(key)}
${#dates.month(key)}
${#dates.day(key)}
year:取年
Month:取月
Day:取日

3.3 条件判断
3.3.1 th:if


性别:男


性别:女

3.3.2 th:switch

ID 为 1 ID 为 2 ID 为 3

3.4 迭代遍历
3.4.1 th:each

@RequestMapping("/show3")
public String showInfo3(Model model){
List list = new ArrayList<>();
	list.add(new Users(1,"张三",20));
	list.add(new Users(2,"李四",22));
	list.add(new Users(3,"王五",24));
	model.addAttribute("list", list);
	return "index3";
}

ID Name Age

3.4.2 ht:each 状态变量

@RequestMapping("/show3")
public String showInfo3(Model model){
	List list = new ArrayList<>();
	list.add(new Users(1,"张三",20));
	list.add(new Users(2,"李四",22));
	list.add(new Users(3,"王五",24));
	model.addAttribute("list", list);
	return "index3";
}
ID Name Age Index Count Size Even Odd First lase
状态变量属性 1,index:当前迭代器的索引 从 0 开始 2,count:当前迭代对象的计数 从 1 开始 3,size:被迭代对象的长度 4,even/odd:布尔值,当前循环是否是偶数/奇数 从 0 开始 5,first:布尔值,当前循环的是否是第一条,如果是返回 true 否则返回 false 6,last:布尔值,当前循环的是否是最后一条,如果是则返回 true 否则返回 false

3.4.3 th:each 迭代 Map

@RequestMapping("/show4")
public String showInfo4(Model model){
	Map map = new HashMap<>();
	map.put("u1", new Users(1,"张三",20));
	map.put("u2", new Users(2,"李四",22));
	map.put("u3", new Users(3,"王五",24));
	model.addAttribute("map", map);
	return "index4";
}

ID Name Age
ID Name Age

3.5 域对象操作
3.5.1 HttpServletRequest

request.setAttribute("req", "HttpServletRequest");
Request:

3.5.2HttpSession

request.getSession().setAttribute("sess", "HttpSession");
Session:

3.5.3ServletContext

request.getSession().getServletContext().setAttribute("app","Application");
Application:

你可能感兴趣的:(SpringBoot)