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

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

• 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:加自定义的属性则会无效。比如：需要对标签增加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>
  

  说明： 在页面上查看源代码可以看到：，说明自定义属性用：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：操作消息的工具。