Spring Boot——使用Thymeleaf模板

在视图设计中，一般情况下都会采用Thymeleaf模板，那Thymeleaf模板有什么功能呢？
Thymeleaf是Web和独立环境的现代服务器端Java模板引擎，能够处理HTML，XML，JavaScript，CSS甚至纯文本。它具有丰富的标签语言和函数，主要目标是提供一种优雅和高度可维护的创建模板的方式。

Thymeleaf 是新一代的模板引擎，在spring4.0中推荐使用thymeleaf来做前端模版引擎，因为Springboot默认是不支持JSP的，所以使用Spring Boot 框架进行界面设计，一般都会用Thymeleaf 模板。

链接：https://www.cnblogs.com/ityouknow/p/5833560.html

http://www.cnblogs.com/chenlove/p/9375756.html

二、Spring Boot使用Thymeleaf

1、引入Thymeleaf依赖

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

2、配置Thymeleaf

#thymelea模板配置
spring.thymeleaf.prefix=classpath:/templates/
spring.thymeleaf.suffix=.html
spring.thymeleaf.mode=HTML5
spring.thymeleaf.encoding=UTF-8
spring.thymeleaf.content-type=text/html
spring.thymeleaf.cache=false
spring.resources.chain.strategy.content.enabled=true
spring.resources.chain.strategy.content.paths=/**

PS:说明一下，这些配置不是必须的，如果配置了会覆盖默认的。
在开发时建议将spring.thymeleaf.cache设置为false，否则会有缓存，导致页面没法及时看到更新后的效果。比如你修改了一个文件，已经update到tomcat，但刷新页面还是之前的页面，就是因为缓存引起的。
3、编写模板文件src/main/resouces/templates/helloHtml.html

    
        
        
    
        
    
Hello.v.2
        
    
    

4、编写访问路径（controller）

package com.guxf.demo.controller;
 
import java.util.Map;
import org.springframework.stereotype.Controller;
import org.springframework.web.bind.annotation.RequestMapping;
 
 
 
@Controller
 
public class TemplateController {
    /**
     * 返回html模板.
     */
 
    @RequestMapping("/helloHtml")
    public String helloHtml(Map map){
 
       map.put("hello","from TemplateController.helloHtml----就問你簡不簡單？");
       return"/helloHtml";
    }
}

5、启动Application，默认输入：http://127.0.0.1:8080/helloHtml

结果.png

三、补充——Spring Boot使用freemarker
使用freemarker也很简单，在pom.xml加入freemarker的依赖：

        org.springframework.boot
        spring-boot-starter-freemarker

剩下的编码部分都是一样的，说下application.properties文件：

########################################################
###FREEMARKER (FreeMarkerAutoConfiguration)
########################################################
spring.freemarker.allow-request-override=false
spring.freemarker.cache=true
spring.freemarker.check-template-location=true
spring.freemarker.charset=UTF-8
spring.freemarker.content-type=text/html
spring.freemarker.expose-request-attributes=false
spring.freemarker.expose-session-attributes=false
spring.freemarker.expose-spring-macro-helpers=false
#spring.freemarker.prefix=
#spring.freemarker.request-context-attribute=
#spring.freemarker.settings.*=
#spring.freemarker.suffix=.ftl
#spring.freemarker.template-loader-path=classpath:/templates/#comma-separatedlist
#spring.freemarker.view-names= #whitelistofviewnamesthatcanberesolved

剩余的代码，基本都一样，thymeleaf和freemarker是可以共存的。
本文记录一下几点：
一、资源文件的约定目录结构
二、Maven配置
三、开发时修改thymeleaf模板自动重新加载配置
四、thymeleaf常用基础知识点

一、资源文件的约定目录结构
Maven的资源文件目录：/src/java/resources
spring-boot项目静态文件目录：/src/java/resources/static
spring-boot项目模板文件目录：/src/java/resources/templates
spring-boot静态首页的支持，即index.html放在以下目录结构会直接映射到应用的根目录下：

classpath:/META-INF/resources/index.html  
classpath:/resources/index.html  
classpath:/static/index.html  
calsspath:/public/index.html  

如果将index.html模板文件直接放到了/src/java/resources/templates目录下，那么需配置下才可以访问到首页文件，因为目录并不是首页文件的默认目录：

@RequestMapping("/")  
    public String index(){  
        return "index";  
  } 

在spring-boot下，默认约定了Controller试图跳转中thymeleaf模板文件的前缀prefix是”classpath:/templates/”,后缀suffix是”.html”
这个在application.properties配置文件中是可以修改的:

spring.thymeleaf.prefix: /templates/  
spring.thymeleaf.suffix: .html