3、SpringBoot整合Thymeleaf视图

时间 2019-11-16

标签 springboot 整合 thymeleaf 视图栏目 Spring 繁體版

原文原文链接

目录html

3.1 Thymeleaf视图介绍

先看下官网的介绍：
==Thymeleaf是适用于Web和独立环境的现代服务器端Java模板引擎。
Thymeleaf的主要目标是为您的开发工做流程带来优雅的天然模板 -HTML能够在浏览器中正确显示，也能够做为静态原型工做，从而能够在开发团队中增强协做。
Thymeleaf拥有适用于Spring Framework的模块，与您喜欢的工具的大量集成以及插入您本身的功能的能力，对于现代HTML5 JVM Web开发而言，Thymeleaf是理想的选择。==
在SpringBoot中，SpringBoot对Thymeleaf提供了良好的支持，同时也提供了自动化配置，所以在SpringBoot中使用Thymeleaf很是快捷方便。java

3.2 建立SpringBoot项目

建立方法建议使用IDEA快速建立SpringBoot项目，并选择web、Thymeleaf依赖：

建立完成后，IDEA自动在pom中加入了web和Thymeleaf依赖管理，pom.xml:web

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

        <dependency>
            <groupId>org.springframework.boot</groupId>
            <artifactId>spring-boot-starter-test</artifactId>
            <scope>test</scope>
        </dependency>
    </dependencies>

项目架构：
spring

3.2 配置Thymeleaf

SpringBoot为Thymeleaf提供了自动化配置类ThymeleafAutoConfiguration，源码：后端

@Configuration
@EnableConfigurationProperties({ThymeleafProperties.class})
@ConditionalOnClass({TemplateMode.class, SpringTemplateEngine.class})
@AutoConfigureAfter({WebMvcAutoConfiguration.class, WebFluxAutoConfiguration.class})
public class ThymeleafAutoConfiguration {...}

能够看出相关的配置信息是从ThymeleafProperties类中得到的，进一步查看ThymeleafProperties的源码：浏览器

@ConfigurationProperties(
    prefix = "spring.thymeleaf"
)
public class ThymeleafProperties {
    private static final Charset DEFAULT_ENCODING;
    public static final String DEFAULT_PREFIX = "classpath:/templates/";
    public static final String DEFAULT_SUFFIX = ".html";
    private boolean checkTemplate = true;
    private boolean checkTemplateLocation = true;
    private String prefix = "classpath:/templates/";
    private String suffix = ".html";
    private String mode = "HTML";
    //省略
}

从该配置能够看出默认的Thymeleaf存放位置是classpath:/templates/，即resources/templates/下，刚刚咱们使用IDEA建立项目时，已经自动生成了该目录。
咱们若是须要对Thymeleaf的配置进行更改，可直接在application.properties中配置：缓存

#是否开启缓存,默认为true
spring.thymeleaf.cache=false
#检查模板文件是否存在
spring.thymeleaf.check-template=true
#检查模本目录是否存在
spring.thymeleaf.check-template-location=true
#模板文件编码
spring.thymeleaf.encoding=UTF-8
#模板位置
spring.thymeleaf.prefix=classpath:/templates/
#模板文件后缀名
spring.thymeleaf.suffix=.html
#Content-type
spring.thymeleaf.servlet.content-type=text/html

3.3 编写Demo

一、新建User和UserController：
User.java:springboot

package com.gongsir.springboot02.pojo;

public class User {
    private String name;
    private String major;
    private String grade;

    public String getName() {
        return name;
    }

    public void setName(String name) {
        this.name = name;
    }

    public String getMajor() {
        return major;
    }

    public void setMajor(String major) {
        this.major = major;
    }

    public String getGrade() {
        return grade;
    }

    public void setGrade(String grade) {
        this.grade = grade;
    }
}

UserController.java:服务器

@Controller
public class UserController {
    @GetMapping(path = "/users")
    public ModelAndView getUsers(){
        List<User> list = new ArrayList<>();
        User u1 = new User();
        u1.setName("龚涛");
        u1.setMajor("计算机");
        u1.setGrade("2017");
        list.add(u1);
        User u2 = new User();
        u2.setName("李诗雅");
        u2.setMajor("网络工程");
        u2.setGrade("2017");
        list.add(u2);
        //视图模板文件的名字，需在template目录下建立同名模板文件
        ModelAndView mv = new ModelAndView("users");
        mv.addObject("users",list);
        return mv;
    }
}

二、在模板目录下新建users.html模板文件，显示数据：网络

<!DOCTYPE html>
<html lang="en" xmlns:th="http://www.thymeleaf.org">
<head>
    <meta charset="UTF-8">
    <title>用户列表</title>
</head>
<body>
    <table border="1px sold black">
        <tr>
            <td>姓名</td>
            <td>专业</td>
            <td>年级</td>
        </tr>
        <tr th:each="user:${users}">
            <td th:text="${user.name}"></td>
            <td th:text="${user.major}"></td>
            <td th:text="${user.grade}"></td>
        </tr>
    </table>
</body>
</html>

三、启动项目，访问http://localhost:8080/users，如图：

3.4 小结

本文主要介绍SpringBoot整合Thymeleaf视图技术，并给了一个简单demo演示，想学习更多Thymeleaf知识？看官网吧：https://www.thymeleaf.org/. 不过当前流行先后端分离技术，大多数开发不须要在后端整合视图技术，后端只须要提供接口便可，待续.....