springboot-thymeleaf
Thymeleaf 是一个跟 Velocity、FreeMarker 类似的模板引擎,它可以完全替代 JSP 。相较与其他的模板引擎,它有如下三个极吸引人的特点:
- Thymeleaf 在有网络和无网络的环境下皆可运行,即它可以让美工在浏览器查看页面的静态效果,也可以让程序员在服务器查看带数据的动态页面效果。
- Thymeleaf 开箱即用的特性。它提供标准和spring标准两种方言,可以直接套用模板实现JSTL、 OGNL表达式效果,避免每天套模板、该jstl、改标签的困扰。
- Thymeleaf 提供spring标准方言和一个与 SpringMVC 完美集成的可选模块,可以快速的实现表单绑定、属性编辑器、国际化等功能。
在SpringBoot中集成Thymeleaf构建Web应用步骤:
pom依赖:
1 <dependencies> 2 <dependency> 3 <groupId>org.springframework.boot</groupId> 4 <artifactId>spring-boot-starter-web</artifactId> 5 <exclusions> 6 <exclusion> 7 <groupId>org.springframework.boot</groupId> 8 <artifactId>spring-boot-starter-tomcat</artifactId> 9 </exclusion> 10 </exclusions> 11 </dependency> 12 <dependency> 13 <groupId>org.springframework.boot</groupId> 14 <artifactId>spring-boot-starter-jetty</artifactId> 15 </dependency> 16 17 <dependency> 18 <groupId>org.springframework.boot</groupId> 19 <artifactId>spring-boot-starter-test</artifactId> 20 <scope>test</scope> 21 </dependency> 22 <dependency> 23 <groupId>org.springframework.boot</groupId> 24 <artifactId>spring-boot-starter-thymeleaf</artifactId> 25 </dependency> 26 </dependencies>
资源目录
Spring Boot默认提供静态资源目录位置需置于classpath下,目录名需符合如下规则:
- /static
- /public
- /resources
- /META-INF/resources
举例:我们可以在src/main/resources/
目录下创建static,在该位置放置一个图片文件pic.jpg
。 启动程序后,尝试访问http://localhost:8080/pic.jpg
。如能显示图片,配置成功。
SpringBoot的默认模板路径为:src/main/resources/templates
添加页面
在src/main/resources/templates
下面添加一个index.html
首页,同时引用到一些css、js文件,看看Thymeleaf 3的语法:
1 <!DOCTYPE html> 2 <html xmlns="http://www.w3.org/1999/xhtml" 3 xmlns:th="http://www.thymeleaf.org"> 4 <head> 5 <meta charset="utf-8"> 6 <meta name="viewport" content="width=device-width, initial-scale=1.0"> 7 <meta name="renderer" content="webkit"> 8 <title>首页</title> 9 <link rel="shortcut icon" th:href="@{/favicon.ico}"/> 10 <link th:href="@{/static/css/bootstrap.min.css}" rel="stylesheet"/> 11 <link th:href="@{/static/css/font-awesome.min.css}" rel="stylesheet"/> 12 </head> 13 <body class="fixed-sidebar full-height-layout gray-bg" style="overflow:hidden"> 14 <div id="wrapper"> 15 <h1 th:text="${msg}"></h1> 16 </div> 17 <script th:src="@{/static/js/jquery.min.js}"></script> 18 <script th:src="@{/static/js/bootstrap.min.js}"></script> 19 20 </body> 21 </html>
说明:
<html xmlns="http://www.w3.org/1999/xhtml" xmlns:th="http://www.thymeleaf.org">
加上这个命名空间后就能在页面中使用Thymeleaf自己的标签了,以th:
开头。
连接语法 th:href="@{/static/css/bootstrap.min.css}"
访问Model中的数据语法 th:text="${msg}"
在页面里显示的是一个键为msg
的消息,需要后台传递过来。
编写Controller
接下来编写控制器类,将URL /
和 /index
都返回index.html页面:
1 @Controller 2 public class IndexController { 3 4 private static final Logger _logger = LoggerFactory.getLogger(IndexController.class); 5 6 /** 7 * 主页 8 * 9 * @param model 10 * @return 11 */ 12 @RequestMapping({"/", "/index"}) 13 public String index(Model model) { 14 model.addAttribute("msg", "welcome you!"); 15 return "index"; 16 } 17 18 }
在model里面添加了一个属性,key=msg
,值为welcome you!
。
接下来启动应用后,打开首页看看效果如何。消息正确显示,成功!。