Spring Boot Thymeleaf

Thymeleaf 是一个基于 Java 的库,用于创建 Web 应用程序。 它为在 Web 应用程序中提供 XHTML/HTML5 提供了良好的支持。 在本章中,我们将详细了解 Thymeleaf。


Thymeleaf 模板

Thymeleaf 将我们的文件转换为格式良好的 XML 文件。 它包含 6 种类型的模板,如下所示

  • XML
  • Valid XML
  • XHTML
  • Valid XHTML
  • HTML5
  • Legacy HTML5

除旧版 HTML5 外,所有模板都引用格式正确的有效 XML 文件。 旧版 HTML5 允许我们在网页中呈现 HTML5 标签,包括非封闭标签。


Web Application

我们可以使用 Thymeleaf 模板在 Spring Boot 中创建 Web 应用程序。 你必须按照以下步骤使用 Thymeleaf 在 Spring Boot 中创建 Web 应用程序。

使用以下代码创建一个 @Controller 类文件来将请求 URI 重定向到 HTML 文件

package com.study.controller;

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

/**
 * @author jiyik.com
 */
@Controller
public class WebController {
    @RequestMapping(value = "/index")
    public String index() {
        return "index";
    }
}

在上面的例子中,请求 URI 是 /index,控件被重定向到 index.html 文件中。 注意 index.html 文件应该放在 templates 目录下,所有 JS 和 CSS 文件应该放在 classpath 中的 static 目录下。 在显示的示例中,我们使用 CSS 文件来更改文本的颜色。

我们可以使用以下代码并在单独的文件夹 css 中创建一个 CSS 文件并将该文件命名为 styles.css

h4 {
   color: red;
}

index.html 文件的代码如下

<!DOCTYPE html>
<html>
   <head>
      <meta charset = "ISO-8859-1" />
      <link href = "css/styles.css" rel = "stylesheet"/>
      <title>Spring Boot Application - 迹忆客(jiyik.com)</title>
   </head>
   <body>
      <h4>欢迎来到 Thymeleaf Spring Boot Web 应用程序</h4>
   </body>
</html>

项目资源管理器如下面的屏幕截图所示

spring boot thymeleaf 模板

现在,我们需要在构建配置文件中添加 Spring Boot Starter Thymeleaf 依赖项。

Maven 用户可以在 pom.xml 文件中添加如下依赖

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

Gradle 用户可以在 build.gradle 文件中添加如下依赖

compile group: 'org.springframework.boot', name: 'spring-boot-starter-thymeleaf'

主 Spring Boot 应用程序类文件的代码如下所示

package com.study;

import org.springframework.boot.SpringApplication;
import org.springframework.boot.autoconfigure.SpringBootApplication;
import org.springframework.context.annotation.Bean;
import org.springframework.web.client.RestTemplate;

/**
 * @author jiyik.com
 */
@SpringBootApplication
public class MyApplication {
    public static void main(String[] args) {
        SpringApplication.run(MyApplication.class, args);
    }

    @Bean
    public RestTemplate getRestTemplate() {
        return new RestTemplate();
    }
}

Maven - pom.xml 的代码如下所示

<?xml version="1.0" encoding="UTF-8"?>
<project xmlns="http://maven.apache.org/POM/4.0.0"
         xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
         xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd">
    <modelVersion>4.0.0</modelVersion>

    <groupId>com.spring</groupId>
    <artifactId>springBootProject</artifactId>
    <version>1.0-SNAPSHOT</version>

    <parent>
        <groupId>org.springframework.boot</groupId>
        <artifactId>spring-boot-starter-parent</artifactId>
        <version>2.6.6</version>
    </parent>

    <dependencies>
        <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>
        <dependency>
            <groupId>org.springframework.boot</groupId>
            <artifactId>spring-boot-starter-thymeleaf</artifactId>
        </dependency>
    </dependencies>

    <build>
        <plugins>
            <plugin>
                <groupId>org.springframework.boot</groupId>
                <artifactId>spring-boot-maven-plugin</artifactId>
            </plugin>
        </plugins>
    </build>

</project>

Gradle 的代码 - build.gradle 如下所示

buildscript {
   ext {
      springBootVersion = '1.5.8.RELEASE'
   }
   repositories {
      mavenCentral()
   }
   dependencies {
      classpath("org.springframework.boot:spring-boot-gradle-plugin:${springBootVersion}")
   }
}

apply plugin: 'java'
apply plugin: 'eclipse'
apply plugin: 'org.springframework.boot'

group = 'com.study'
version = '0.0.1-SNAPSHOT'
sourceCompatibility = 1.8

repositories {
   mavenCentral()
}
dependencies {
   compile('org.springframework.boot:spring-boot-starter-web')
   compile group: 'org.springframework.boot', name: 'spring-boot-starter-thymeleaf'
   testCompile('org.springframework.boot:spring-boot-starter-test')
}

这里我们使用 IDEA 来启动服务(读者也可以使用 mvn clean install 或者 gradle clean build 生成可执行jar包)

spring boot 异常处理 IDEA启动服务

在浏览器中访问 URL http://localhost:8080/index ,我们可以看到如下所示的输出

Spring Boot Thymeleaf 运行结果

查看笔记

扫码一下
查看教程更方便