Thymeleaf 之 内置对象、定义变量、URL参数及标签自定义属性

如标题所述，这篇文章主要讲述Thymeleaf中的内置对象（list解析、日期格式化、数字格式化等）、定义变量、获取URL的参数和在页面标签中自定义属性的应用。

如果对Thymeleaf的基本使用、maven依赖等不清楚的可以先阅读我的另一篇文章《Thymeleaf 之 初步使用》。

• Controller部份

@Controller
public class IndexController {

    @GetMapping(value = "index")
    public String index(Model model, HttpServletRequest request) {
        List<String> datas = new ArrayList<String>();
        datas.add("知识林");
        datas.add("http://www.zslin.com");
        datas.add("393156105");
        model.addAttribute("datas", datas);
        model.addAttribute("curDate", new Date());

        model.addAttribute("money", Math.random()*100);
        return "index";
    }
}

在这个控制器的Model中存放了这样几个数据：一个String类型的列表、一个日期对象和一个数值，这些东西在实际应用开发过程中应用非常广泛，下面具体看一下在Thymeleaf中是如何解析这些数据的。

• 日期格式化

<span th:text="${#dates.format(curDate, 'yyyy-MM-dd HH:mm:ss')}"></span>

说明： 使用内置对象dates的format函数即可对日期进行格式化，在format函数中，第一个参数是日期对象，对二两个参数为日期格式（规则跟SimpleDateFormat一样）

需要注意的是：

· 内置对象一般都以s结尾，如dates、lists、numbers等

· 在使用内置对象是在对象名前都需要加#号。

• 数字格式化

<span th:text="${#numbers.formatDecimal(money, 0, 2)}"></span>

说明： 此示例表示保留两位小数位，整数位自动；

<span th:text="${#numbers.formatDecimal(money, 3, 2)}"></span>

说明： 此示例表示保留两位小数位，3位整数位（不够的前加0）

• 获取列表长度

<span th:text="${#lists.size(datas)}"></span>

说明： 使用#lists.size来获取List的长度。

• 获取URL参数值

<span th:text="${#httpServletRequest.getParameter('page')}"></span>

说明： 当访问http://localhost:1105/index?page=5时页面将会得到page对应的值：5。

• 定义变量

<div th:with="curPage=${#httpServletRequest.getParameter('page')}">
    <h3>当前页码：<span th:text="${curPage}"></span></h3>
</div>

说明： 同样，当访问http://localhost:1105/index?page=5时，页面将显示：当前页码：5，说明用th:with来定义变量，多个用,号隔开，使用范围在当前标签内。

• 自定义标签属性

在Thymeleaf中可以使用th:加上标签的任何属性进行赋值，但有些时候会遇到自定义的属性，再用th:加自定义的属性则会无效。比如：需要对<span>标签增加objName和objId这样的属性，在非Thymeleaf情况下是这样：

<span objId="1" objName="知识林"></span>

变量情况是：

<span objId="${obj.id}" objName="${obj.name}"></span>

在Thymeleaf下则是：

<span th:attr="myDate=${#dates.format(curDate, 'yyyy-MM-dd')}, myMoney=${money}"></span>

说明： 在页面上查看源代码可以看到：<span myMoney="91.6059494319957" myDate="2016-31-02"></span>，说明自定义属性用：th:attr，多个属性用,隔开。

• 内置对象

上面简单描述了比较常用的dates、lists、numbers这几个内置对象，在Thymeleaf还有很多的内置对象，像strings也非常常用，用法跟java.lang.String类的用法一样。

在Thymeleaf中的内置对象有：

#dates：日期格式化内置对象，具体方法可以参照java.util.Date；

#calendars：类似于#dates，但是是java.util.Calendar类的方法；

#numbers： 数字格式化；

#strings：字符串格式化，具体方法可以参照java.lang.String，如startsWith、contains等；

#objects：参照java.lang.Object；

#bools：判断boolean类型的工具；

#arrays：数组操作的工具；

#lists：列表操作的工具，参照java.util.List；

#sets：Set操作工具，参照java.util.Set；

#maps：Map操作工具，参照java.util.Map；

#aggregates：操作数组或集合的工具；

#messages：操作消息的工具。