springboot(二)：thymeleaf模板开发

时间 2019-11-06

标签 springboot thymeleaf 模板开发栏目 Spring 繁體版

原文原文链接

概述

Thymeleaf是一款用于渲染XML/XHTML/HTML5内容的模板引擎。相似JSP，Velocity，FreeMaker等，它也能够轻易的与Spring MVC等Web框架进行集成做为Web应用的模板引擎。与其它模板引擎相比，Thymeleaf最大的特色是可以直接在浏览器中打开并正确显示模板页面，而不须要启动整个Web应用。html

好了，大家说了咱们已经习惯使用了什么 velocity,FreMaker，beetle之类的模版，那么到底好在哪里呢？比一比吧 Thymeleaf是不同凡响的，由于它使用了天然的模板技术。这意味着Thymeleaf的模板语法并不会破坏文档的结构，模板依旧是有效的XML文档。模板还能够用做工做原型，Thymeleaf会在运行期替换掉静态值。Velocity与FreeMarker则是连续的文本处理器。java

thymeleaf开发

访问 http://start.spring.io 填写项目基本信息，而后选择thymeleaf依赖
下载zip包，而后导入eclipse
新建index.html

<!DOCTYPE html>
<html xmlns="http://www.w3.org/1999/xhtml" xmlns:th="http://www.thymeleaf.org"
      xmlns:sec="http://www.thymeleaf.org/thymeleaf-extras-springsecurity3">
    <head>
        <title>Hello World!</title>
    </head>
    <body>
        <h1 th:inline="text">Hello springboot v.2</h1>
        <p th:text="${hello}"></p>
    </body>
<html>

编写controller

@Controller
publicclass TemplateController {
    @RequestMapping("/")
    public String helloHtml(Map<String,Object> map){
       map.put("hello","from TemplateController.helloHtml");
       return"/index";
    }
}

运行Application.java，浏览器输入http://127.0.0.1:8080/ 就能看到页面上输出的from TemplateController.helloHtml

springboot资源文件的约定目录结构

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

thymeleaf的相关配制

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

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

thymeleaf中的默认这是能够查看org.springframework.boot.autoconfigure.thymeleaf.ThymeleafProperties这个类的属性spring

Spring-boot使用thymeleaf时默认是有缓存的，即你把一个页面代码改了不会刷新页面的效果，你必须从新运行spring-boot的main()方法才能看到页面更改的效果。咱们能够把thymeleaf的缓存关掉，用于支持页面修改后从新发布到spring-boot内嵌的tomcat中去。在application.properties配置文件中加入如下配置。

# Allow Thymeleaf templates to be reloaded at dev time  
spring.thymeleaf.cache: false
server.tomcat.access_log_enabled: true
server.tomcat.basedir: target/tomcat

thymeleaf经常使用基础知识点

在html页面中引入thymeleaf命名空间，即 <html xmlns:th=http://www.thymeleaf.org></html>,此时在html模板文件中动态的属性使用th:命名空间修饰。浏览器
引用静态资源文件，好比CSS和JS文件，语法格式为@{}，如@{/js/user/user.js}会引入/static目录下的/js/user/user.js文件。spring-mvc
访问spring-mvc中model的属性，语法格式为${}，如${user.id}能够获取model里的user对象的id属性。缓存
循环，在html的标签中，加入th:each="value:${list}"形式的属性，如能够迭代users的数据。tomcat
判断，在html标签中，加入th:if="表达式"能够根据条件显示html元素   以上代码表示若blog.publishTime时间不为空，则显示时间springboot
时间的格式化，${#dates.format(blog.publishTime,'yyyy-MM-dd HH:mm:ss')} 表示将时间格式化为yyyy-MM-dd HH:mm:ss格式化写法与Java格式化Date的写法是一致的。mvc
字符串拼接有两种形式好比拼接这样一个URL:/blog/delete/{blogId}app

第一种：th:href="'/blog/delete/' + ${blog.id }"
第二种：th:href="${'/blog/delete/' + blog.id }"