springBoot搭建通用mvc后台项目（三）springBoot对thymeleaf的基本使用

1、thymeleaf简介

曾经对于java web的学习，jsp是一个绕不过去的知识点。虽然有el表达式与jstl的一些简化，但jsp并没有真正意义上的做到动静分离。这样的尴尬，常常造成切静态网页的和写java渲染的互撕。这也是我们springboot渐渐放弃jsp的一个原因。随着前端技术的长足发展与完善，jsp也与java web渐行渐远。
对于jsp的替代品，油然而生。而thymeleaf就是一个可以完全替代jsp的模板引擎。最重要的是thymeleaf真正做到了动静分离，也就是，同一个渲染文件可以让美工在浏览器查看和调试页面的静态效果，也可以让程序员在服务器查看和调试带数据的动态页面效果。thymeleaf也是springboot推荐的渲染模板。

2、springBoot使用thymeleaf与说明

2.1、引入thymeleaf的坐标

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

2.2、创建存放视图的目录

视图默认的位置是存放在：src/main/resources/templates
templates（注意名称要一样，不能少s）类似于以前WEB-INF的目录，是访问安全的，也就是说，该目录下的内容是不允许外界直接访问的。

2.3、测试用例

创建controller，这里还是在application上写测试用例，增加一个index的url：

package com.ruiyi;

import org.slf4j.Logger;
import org.slf4j.LoggerFactory;
import org.springframework.boot.SpringApplication;
import org.springframework.boot.autoconfigure.SpringBootApplication;
import org.springframework.stereotype.Controller;
import org.springframework.ui.ModelMap;
import org.springframework.web.bind.annotation.GetMapping;
import org.springframework.web.bind.annotation.ResponseBody;

@SpringBootApplication 
@Controller
public class Application {
	
	private Logger logger = LoggerFactory.getLogger(getClass());
	
	public static void main(String[] args) {
		SpringApplication.run(Application.class, args);
	}
	
	@GetMapping("/hello")
	@ResponseBody
	public String hello() {
		logger.info("logback in hello");
		return "hello spring boot";
	}
	
	@GetMapping("/index")
	public String index(ModelMap modelMap) {
		modelMap.put("msg", "hello thymeleaf");
		return "/index";
	}
	
}

创建html

如图：

thymeleaf基本语法
关于thymeleaf的基本语法，这里不加以详细说明，网上有许多的博客，也有很详细的API。
这里只演示个简单的例子，在以后项目的实现过程中会就用到的语法与标签一一详细说明。如上面html中的th:text="${msg}"，就是将后台变量msg渲染到h3作为内容。

3、thymeleaf的注意事项

在上面的逻辑中，我们报了一个异常，如图：

它要求我们对html要有严谨的语法。不能做任何的省略。
那么我们怎么来处理这种异常呢？
1）就是严格按照html的语法书写。这种方式在元素多的情况下比较麻烦，并不是很常用。
2）更新thymeleaf的jar到高版本，具体是：
thymeleaf.jar:更新为 3.0 以上的版本
thymeleaf-layout-dialect.jar： 更新为 2.0 以上的版本
thymeleaf默认的版本是较低的，如图：

更新过程非常简单，只需要在项目的pom中指定坐标的版本变量即可，如图：

再去查看下Effective POM选项中的版本，看是否已经变化。如果没有，使用maven update下项目，结果如图：

重启刷新页面后，结果如下：

到目前为止，系列博文一直是在写一些简单的测试用例来说明知识点。严格来说，与项目无关。从下一篇开始，会按照项目的设计来实现。下一篇我们来学习在thymeleaf的基础上集成H-ui