SpringBoot-模板渲染

模板

开发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="#">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="#">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 class="blog-post-meta"><span th:text="${#dates.format(blog.createdTime,'yyy-MM-dd')}">2015年2月3日</span> 标签：<a href="#">Web开发</a></p>

#dates是Thymeleaf内置的一个工具类，format()方法可以指定日期的格式。

运行结果：