一、Thymeleaf简介

• Thymeleaf是用来开发Web和独立环境项目的服务器端的Java模版引擎
• Spring官方支持的服务的渲染模板中，并不包含jsp。而是Thymeleaf和Freemarker等，而Thymeleaf与SpringMVC的视图技术，及SpringBoot的自动化配置集成非常完美，几乎没有任何成本，你只用关注Thymeleaf的语法即可。

二、Thymeleaf的特点

• 动静结合：Thymeleaf 在有网络和无网络的环境下皆可运行，即它可以让美工在浏览器查看页面的静态效果，也可以让程序员在服务器查看带数据的动态页面效果。这是由于它支持 html 原型，然后在 html 标签里增加额外的属性来达到模板+数据的展示方式。浏览器解释 html 时会忽略未定义的标签属性，所以 thymeleaf 的模板可以静态地运行；当有数据返回到页面时，Thymeleaf 标签会动态地替换掉静态内容，使页面动态显示。
• 开箱即用：它提供标准和spring标准两种方言，可以直接套用模板实现JSTL、 OGNL表达式效果，避免每天套模板、该jstl、改标签的困扰。同时开发人员也可以扩展和创建自定义的方言。
• 多方言支持：Thymeleaf 提供spring标准方言和一个与 SpringMVC 完美集成的可选模块，可以快速地实现表单绑定、属性编辑器、国际化等功能。
• 与SpringBoot完美整合，SpringBoot提供了Thymeleaf的默认配置，并且为Thymeleaf设置了视图解析器，我们可以像以前操作jsp一样来操作Thymeleaf。代码几乎没有任何区别，就是在模板语法上有区别。

三.ssm中添加thymeleaf

1.导入jar包

  org.thymeleaf
  thymeleaf
  3.0.9.RELEASE



  org.thymeleaf
  thymeleaf-spring4
  3.0.9.RELEASE

2.在springmvc.xml文件中设置视图解析器为thymeleaf解析

3.删除之前视图解析器为jsp的配置信息,如果两个都配置，谁在前面，用谁

4.配置web.xml文件中thymeleaf部分

 
  
    contextConfigLocation
    classpath:applicationContext-ioc.xml
  
  
  
    org.springframework.web.context.ContextLoaderListener
  
 
 
  springMVC
  org.springframework.web.servlet.DispatcherServlet

  

  
    contextConfigLocation
    classpath:springmvc.xml
  

  1



  springMVC
  / 






  springMVC

  *.html

5.创建控制器

package com.test.action;

import org.springframework.stereotype.Controller;
import org.springframework.ui.Model;
import org.springframework.web.bind.annotation.RequestMapping;

@Controller
@RequestMapping("thymeleaf")
public class ThymeleafAction {

    @RequestMapping("/testThymeleaf")
    public String testThymeleaf(Model model)
    {
        model.addAttribute("uname","zhangsan");

        return "testThymeleaf";// WEB-INF/views/testThymeleaf.html
    }
}

6.创建html页面

根据之前设置的前缀

在web-inf/views/文件夹下创建html文件

访问传递过来的数据，注意声明Thymeleaf命名空间

    
    


aaaa

7.测试

http://localhost:8080/testssm/thymeleaf/testThymeleaf

成功

张三

四.常用th属性解读

html有的属性，Thymeleaf基本都有，而常用的属性大概有七八个。其中th属性执行的优先级从1~8，数字越低优先级越高。

一、th:text ：设置当前元素的文本内容，相同功能的还有th:utext，两者的区别在于前者不会转义html标签，后者会。优先级不高：order=7

二、th:value：设置当前元素的value值，类似修改指定属性的还有th:src，th:href。优先级不高：order=6

三、th:each：遍历循环元素，和th:text或th:value一起使用。注意该属性修饰的标签位置，详细往后看。优先级很高：order=2

四、th:if：条件判断，类似的还有th:unless，th:switch，th:case。优先级较高：order=3

五、th:insert：代码块引入，类似的还有th:replace，th:include，三者的区别较大，若使用不恰当会破坏html结构，常用于公共代码块提取的场景。优先级最高：order=1

六、th:fragment：定义代码块，方便被th:insert引用。优先级最低：order=8

七、th:object：声明变量，一般和*{}一起配合使用，达到偷懒的效果。优先级一般：order=4

八、th:attr：修改任意属性，实际开发中用得较少，因为有丰富的其他th属性帮忙，类似的还有th:attrappend，th:attrprepend。优先级一般：order=5

五.基础使用语法

1.创建HTML

由上文也可以知道需要在html中添加：

这样，下文才能正确使用th:*形式的标签！

2.获取变量值${…}

通过**${…}进行取值，这点和ONGL表达式语法一致！**

选择变量表达式*{…}

    
产品名
    
产品名

至于p里面的原有的值只是为了给前端开发时做展示用的.这样的话很好地做到了前后端分离。

这也是Thymeleaf非常好的一个特性：在无网络的情况下也能运行，也就是完全可以前端先写出页面，模拟数据展现效果，后端人员再拿此模板修改即可！

3.链接表达式: @{…}

用来配合link src href使用的语法，类似的标签有:th:href和th:src

链接表达式结构

无参：@{/xxx}

有参：@{/xxx(k1=v1,k2=v2)} 对应url结构：xxx?k1=v1&k2=v2

引入本地资源：@{/项目本地的资源路径}

引入外部资源：@{/webjars/资源在jar包中的路径}

列举：第三部分的实战引用会详细使用该表达式

中文
English
view
    

4.${…}变量表达式

变量表达式有丰富的内置方法，使其更强大，更方便。

变量表达式功能

一、可以获取对象的属性和方法

二、可以使用ctx，vars，locale，request，response，session，servletContext内置对象

三、可以使用dates，numbers，strings，objects，arrays，lists，sets，maps等内置方法（重点介绍）

常用的内置对象

一、ctx ：上下文对象。

二、vars ：上下文变量。

三、locale：上下文的语言环境。

四、request：（仅在web上下文）的 HttpServletRequest 对象。

五、response：（仅在web上下文）的 HttpServletResponse 对象。

六、session：（仅在web上下文）的 HttpSession 对象。

七、servletContext：（仅在web上下文）的 ServletContext 对象

这里以常用的Session举例，用户刊登成功后，会把用户信息放在Session中，Thymeleaf通过内置对象将值从session中获取。

// java 代码将用户名放在session中
session.setAttribute("userinfo",username);
// Thymeleaf通过内置对象直接获取
th:text="${session.userinfo}"

常用的内置方法

一、strings：字符串格式化方法，常用的Java方法它都有。比如：equals，equalsIgnoreCase，length，trim，toUpperCase，toLowerCase，indexOf，substring，replace，startsWith，endsWith，contains，containsIgnoreCase等

二、numbers：数值格式化方法，常用的方法有：formatDecimal等

三、bools：布尔方法，常用的方法有：isTrue，isFalse等

四、arrays：数组方法，常用的方法有：toArray，length，isEmpty，contains，containsAll等

五、lists，sets：集合方法，常用的方法有：toList，size，isEmpty，contains，containsAll，sort等

六、maps：对象方法，常用的方法有：size，isEmpty，containsKey，containsValue等

七、dates：日期方法，常用的方法有：format，year，month，hour，createNow等

文章底部提供了对应的官网链接

    
    


    
ITDragon Thymeleaf 内置方法
    
#strings 
    

        
Old Str : 
        
toUpperCase : 
        
toLowerCase : 
        
equals : 
        
equalsIgnoreCase : 
        
indexOf : 
        
substring : 
        
replace : 
        
startsWith : 
        
contains : 
    

    
#numbers 
    

        
formatDecimal 整数部分随意，小数点后保留两位，四舍五入: 
        
formatDecimal 整数部分保留五位数，小数点后保留两位，四舍五入: 
    

    
#bools 
    

        

    

    
#arrays 
    

        
length : 
        
contains : 
        
containsAll : 
    
    
#lists 
    

        
size : 
        
contains : 
        
sort : 
    
    
#maps 
    

        
size : 
        
containsKey : 
        
containsValue : 
    
    
#dates 
    

        
format : 
        
custom format : 
        
day : 
        
month : 
        
monthName : 
        
year : 
        
dayOfWeekName : 
        
hour : 
        
minute : 
        
second : 
        
createNow : 
    

后台给负责给变量赋值，和跳转页面。

@RequestMapping("varexpressions")
public String varexpressions(ModelMap map) {
  map.put("itdragonStr", "itdragonBlog");
  map.put("itdragonBool", true);
  map.put("itdragonArray", new Integer[]{1,2,3,4});
  map.put("itdragonList", Arrays.asList(1,3,2,4,0));
  Map itdragonMap = new HashMap();
  itdragonMap.put("thName", "${#...}");
  itdragonMap.put("desc", "变量表达式内置方法");
  map.put("itdragonMap", itdragonMap);
  map.put("itdragonDate", new Date());
  map.put("itdragonNum", 888.888D);
  return "grammar/varexpressions";
}

5.运算符

数学运算

• 二元操作：+, - , * , / , %
• 一元操作: - （负）

逻辑运算

• 一元 : and or
• 二元 : !,not

比较运算（为避免转义尴尬，可以使用括号中的英文进行比较运算！）

• 比较：> , <>= , <= ( gt , lt , ge , le )
• 等于：== , != ( eq , ne )

条件运算

• If-then: (if) ? (then)
• If-then-else: (if) ? (then) : (else)
• Default: (value) ?: (defaultvalue)

6.选择

if/unless

使用th:if和th:unless属性进行条件判断，th:unless于th:if恰好相反，只有表达式中的条件不成立，才会显示其内容。

 精品
 
 次品

switch

  
aaaaaaaaa
  
bbbbbbb
  
cccccccc

7.循环

th:each

thymeleaf的th:each常见用法
一.th:eath迭代集合用法:

    

        
是否选中
        
编号
        
姓名
        
年龄
    
    

        

        
编号
        
姓名
        
年龄
    

二.迭代下标变量用法：
状态变量定义在一个th:每个属性和包含以下数据:

1.当前迭代索引,从0开始。这是索引属性。index

2.当前迭代索引,从1开始。这是统计属性。count

3.元素的总量迭代变量。这是大小属性。　size

4.iter变量为每个迭代。这是目前的财产。　current

5.是否当前迭代是奇数还是偶数。这些even/odd的布尔属性。

6.是否第一个当前迭代。这是first布尔属性。

7.是否最后一个当前迭代。这是last布尔属性。

用法实例：


    

        
是否选中
        
编号
        
姓名
        
年龄
    
    

        

        

        
编号
        
姓名
        
年龄
    

控制器端代码:

package com.test.action;

import com.test.pojo.Items;
import org.springframework.stereotype.Controller;
import org.springframework.ui.Model;
import org.springframework.web.bind.annotation.RequestMapping;

import java.util.ArrayList;
import java.util.Date;
import java.util.List;

@Controller
@RequestMapping("thymeleaf")
public class ThymeleafAction {

    @RequestMapping("/testThymeleaf")
    public String testThymeleaf(Model model)
    {
        model.addAttribute("uname","zhangsan");

        Items items=new Items();

        items.setId(1);

        items.setName("iphone");

        items.setDetail("9999");

        items.setPrice(6000);

        model.addAttribute("items",items);

        List itemsList=new ArrayList();

        itemsList.add(new Items(101,"aa",1000,"aaa","1.jpg",new Date()));
        itemsList.add(new Items(102,"bb",1000,"aaa","1.jpg",new Date()));
        itemsList.add(new Items(103,"cc",1000,"aaa","1.jpg",new Date()));

        model.addAttribute("itemsList",itemsList);



        return "testThymeleaf";
    }

    @RequestMapping("/showItemsById")
    public String showItemsById(Model model,int id)
    {
        model.addAttribute("id",id);

         return "showItemsById";

    }



}

tems);

    List itemsList=new ArrayList();

    itemsList.add(new Items(101,"aa",1000,"aaa","1.jpg",new Date()));
    itemsList.add(new Items(102,"bb",1000,"aaa","1.jpg",new Date()));
    itemsList.add(new Items(103,"cc",1000,"aaa","1.jpg",new Date()));

    model.addAttribute("itemsList",itemsList);



    return "testThymeleaf";
}

@RequestMapping("/showItemsById")
public String showItemsById(Model model,int id)
{
    model.addAttribute("id",id);

     return "showItemsById";

}

}