SpringBoot中web模板渲染的实现
作者:起床oO
模板
开发Web站点的本质,其实就是根据浏览器发起的请求(输入),生成HTML代码返回给浏览器(输出)。在之前的学习中,我们已经通过文件的形式存储起来而不是直接在Java代码中生成HTML代码。另一方面,博客站点是动态的,即不同的请求返回的内容可能不同。但是对于同一类请求,例如访问id分别为1和2的两篇文章,对应的URL分别为/blogs/1和/blogs/2,他们返回的HTML代码片段的结构几乎是一样的:
<!DOCTYPE html> <html xmlns="http://www.w3.org/1999/xhtml" xmlns:th="http://www.thymeleaf.org"> <div class="col-sm-8"> <div class="page-header"> <h2 th:text="${title}">Cum sociis(博客标题)</h2> <p class="blog-post-meta"><span th:text="${createdTime}">2015年2月3日</span> 标签:<a href="#" rel="external nofollow" rel="external nofollow" rel="external nofollow" >Web开发</a></p> </div> <div class="blog-post-content" th:text="${content}"> ... (这里是博客内容) </div> </div> </html>
th:text="${title}"就是告诉模板引擎,用title变量作为<h2>标签的内容(createdTime,content也是一样)。
注意为了显示博客创建时间,我们将时间放入了一个<span>标签中,用于和其他文字区分开。
Model
为了让模板引擎知道这些变量的值,我们需要再@Controller做一些工作:
@RequestMapping("/index/{id}") public String getIndex(@PathVariable("id") int id ,Model model) { // return "index"; //这里模拟一些数据 model.addAttribute("title","This is a blog with id = " + id); model.addAttribute("CreatedTime","2017-11-13"); model.addAttribute("content","This is content"); return "index"; }
在上面的代码中,index()方法增加了一个Model类型的参数。通过Spring MVC框架提供的Model,可以调用其addAttribute方法,这样Thymeleaf可以访问Model中的变量从而进行模板渲染。上述例子中可以看到,title变量的值是根据URL中的@PathVariable来确定的,虽然简单,但是这已经是一个动态页面了。
在Servlet编程中,如果希望在页面中动态渲染信息,一般需要往HTTPRequest中添加属性,然后再JSP中获取。其实Model的属性实际上也是放在HttpRequest的属性中,但是Spring MVC提供了更高层的抽象,帮你屏蔽了HttpRequest,你看到的只有直接以MVC中M(即Model)
如果你依然希望使用HttpRequest,HttpResponse和HttpSession等原生的Servlet API对象,往Controller方法中增加对应类型的参数即可,你在方法中就能直接使用了,Spring MVC会传递给你正确的对象。
运行结果:
Model中添加对象
在上面的例子中,我们已经将单篇文章的页面动态化,但是这个动态化只是一个例子,当我们真正拥有数百篇博文时,并且还会添加(或者删除,更新)。显然不能够直接在@Controller方法中这样来填充Model,另外如果需要渲染文章列表,那么这种方法显然也是不行的。
为了解决这个问题,我们需要使用参考代码JAR包中提供的Blog类:
package Entity; import java.util.Date; public class Blog { private int id; private String title; private String content; private Date createdTime; public int getId() { return id; } public void setId(int id) { this.id = id; } public String getTitle() { return title; } public void setTitle(String title) { this.title = title; } public String getContent() { return content; } public void setContent(String content) { this.content = content; } public Date getCreatedTime() { return createdTime; } public void setCreatedTime(Date createdTime) { this.createdTime = createdTime; } }
在单篇文章页面里,对于每一个属性,都需要调用一次Model.addAttribute()方法,属性如果很多就会很不方便。现在我们有了Blog对象,可以将它放入Model:
@RequestMapping("/index/{id}") public String getIndex(@PathVariable("id") int id ,Model model) { // return "index"; //这里模拟一些数据 // model.addAttribute("title","This is a blog with id = " + id); // model.addAttribute("CreatedTime","2017-11-13"); // model.addAttribute("content","This is content"); Blog blog = new Blog(); blog.setId(1); blog.setTitle("This is a blog with id = " + id); blog.setContent("This is content"); blog.setCreatedTime(new Date()); model.addAttribute("blog",blog); return "index"; }
根据URL中的id获取对应的Blog对象,然后交给模板引擎渲染blog,相应的在模板中的变量表达式也要发生变化:
<!DOCTYPE html> <html xmlns="http://www.w3.org/1999/xhtml" xmlns:th="http://www.thymeleaf.org"> <div class="col-sm-8"> <div class="page-header"> <h2 th:text="${blog.title}">Cum sociis(博客标题)</h2> <p class="blog-post-meta"><span th:text="${blog.createdTime}">2015年2月3日</span> 标签:<a href="#" rel="external nofollow" rel="external nofollow" rel="external nofollow" >Web开发</a></p> </div> <div class="blog-post-content" th:text="${blog.content}"> ... (这里是博客内容) </div> </div> </html>
运行结果:
提高:往Model中添加对象有两种方式:
- model.addAttribute("blog",blog);
- model.addAttribute(blog);
使用第二种时,对象在Model中的命名默认为类名的首字母小写形式,任何时候对于同一种类型,只可能存在一个这样的“匿名”对象。
日期格式化
文章页面经过模板渲染处理后,还存在一个小问题:日期格式。现在对于${blog.createdTime}的渲染结果是Mon Nov 13 16:18:08 GMT+08:00 2017 ,这是因为${blog.createdTime}是一个Date对象,模板引擎在渲染的时候直接调用它的toString()方法。格式化日期是一个非常常见的任务,为此Thymeleaf提供了内置的支持:
<p><span th:text="${#dates.format(blog.createdTime,'yyy-MM-dd')}">2015年2月3日</span> 标签:<a href="#" rel="external nofollow" rel="external nofollow" rel="external nofollow" >Web开发</a></p>
#dates是Thymeleaf内置的一个工具类,format()方法可以指定日期的格式。
运行结果:
到此这篇关于SpringBoot中web模板渲染的实现的文章就介绍到这了,更多相关SpringBoot 模板渲染内容请搜索脚本之家以前的文章或继续浏览下面的相关文章希望大家以后多多支持脚本之家!