Spring Boot学习笔记-Thymeleaf模板引擎的配置

写在前面

  在开发过程中,使用模板引擎是很有必要的。我之前学习SSM框架,一直是使用Freemarker作为模板引擎,现在学习了Spring Boot之后,知道Spring Boot推荐使用的模板引擎是Thymeleaf,那么,对于我这种有点轻微强迫症的人来说,肯定是想赶快配置一个Thymeleaf模板引擎。经过查阅资料,配置好后,来发一篇博客记录一下配置过程。


我的Spring Boot版本

   <parent>
	<groupId>org.springframework.boot</groupId>
	<artifactId>spring-boot-starter-parent</artifactId>
	<version>1.5.1.RELEASE</version>
	<relativePath/>
</parent>

添加依赖

  在项目的pom.xml添加如下依赖:

<!-- 添加thymeleaf依赖 -->
<dependency>
 	<groupId>org.springframework.boot</groupId>
 	<artifactId>spring-boot-starter-thymeleaf</artifactId>
</dependency>
<!-- 注意,这里不需要版本号,因为如果是按照我之前的方法创建的项目,pom.xml文件里会自动添加parent结点。-->


配置thymeleaf

  Thymeleaf的配置可以在项目的application.ymlapplication.properties中配置,我这里是选择在application.yml中配置。它的默认配置就已经满足我的需求了,我在这里主要是关闭了缓存,因为在开发过程中,如果开启缓存的话,你即使给Spring Boot配置了热部署(下篇博客记录怎么配置热部署),你修改html之后,仍然需要重启服务,才能看到修改后的页面,所以,强烈建议在开发过程中关闭缓存。

  spring:
  thymeleaf:
    cache: false
#    prefix: classpath:/templates/
#    suffix: .html
#    mode: HTML5
#    encoding: UTF-8
#    content-type: text/html
#    注释的部分是Thymeleaf默认的配置,如有其它需求可以自行更改


测试模板引擎

  首先,我们在src/main/resources下的templates文件夹下新建hello.html,内容如下:

<!DOCTYPE html>
<html>
<head>
<meta charset="UTF-8" />
<title>Insert title here</title>
</head>
<body>
    <font color="red">Hello Thymeleaf.</font>
</body>
</html>

  我在使用STSEclipse创建这个文件的时候,默认meta标签没有闭合,访问可能会报错。如果报错,请手动闭合未闭合标签。
  报错信息如下:

org.xml.sax.SAXParseException: The element type “meta” must be terminated by the matching end-tag “</meta>”.

  在我的参考资料中,说:Thymeleaf 3.0之前要求强制闭合,3.0+版本则不要求强制闭合。
  新建一个HelloController的控制器类,代码如下:

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

/**
 * 这里使用@Controller,而不是@RestController注解
 * 因为@RestController,表示同时使用@Controller@ResponseBody,所以会返回hello
 * 而不是返回hello.html的内容。
 * @author howieli
 *
 */
@Controller
public class HelloController {

    @GetMapping(value = "/hello")
    public String helloGet() {
        return "hello";
    }

}

  启动应用,访问http://localhost:8080/hello,显示如下页面,表示配置成功。
配置成功


传值

  传值这一块只做简单的记录,因为现在流行前后端分离。
  HelloController控制器修改如下:

import java.util.Map;

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

@Controller
public class HelloController {

    @GetMapping(value = "/hello")
    public String helloGet(Map<String, Object> map) {
        map.put("name", "HowieLi");
        return "hello";
    }

}

修改hello.html,通过EL表达式取值:
<!DOCTYPE html>
<html>
<head>
<meta charset="UTF-8" />
<title>Insert title here</title>
</head>
<body>
    <font color="red">Hello Thymeleaf.</font>
    <hr />
    Welcome,<span th:text="${name}"></span>
</body>
</html>

重新启动应用,访问http://localhost:8080/hello,可以看到如下页面:
hello


小结

  其实配置很简单,知道一种模板引擎配置方法,就可以照猫画虎的配置其它模板引擎,如:Freemarker。不过,不管配置哪个模板引擎,建议都关闭缓存,这样修改页面代码,就无需重新启动Spring Boot,省时省力。至于修改代码等等关于热部署的配置,我的下一篇博客会记录我的配置过程。
  个人博客:https://www.howieli.cn 和个人CSDN博客: http://blog.csdn.net/howieli_1995


参考资料

  林祥纤的博客