T()関数

JavaのMathクラスにあるstaticなリソース（ここではフィールドやメソッドを指しています）に対して、Thymeleafからアクセスしてみましょう。

sample.html

<!-- staticフィールドにアクセス -->
<input type="number" th:value="${T(java.lang.Math).PI}" />

<!-- staticメソッドにアクセス -->
<p th:text="${T(java.lang.Math).random()}">Random Number</p>

Math.java

/**
Mathクラスを一部抜粋
*/
public final class Math {
    // staticフィールド
    public static final double E = 2.7182818284590452354;
    public static final double PI = 3.14159265358979323846;

    // staticメソッド
    public static double random() {
        return RandomNumberGeneratorHolder.randomNumberGenerator.nextDouble();
    }
}

ここからわかるように、thタグにおいて、"${T(クラスパス).staticフィールド名}"もしくは"${T(クラスパス).staticメソッド名（）}"としてあげることで、ThymeleafテンプレートからJavaのStaticリソースにアクセスすることができます！

他のthタグの例も見てみましょう。

sample.html

<!DOCTYPE html>
<html xmlns:th="http://www.thymeleaf.org">
<body>
<!-- th:text -->
<p th:text="${T(java.lang.Math).random()}">Random Number</p>

<!-- th:utext -->
<p th:utext="${T(java.lang.Math).random()}">Random Number</p>

<!-- th:if -->
<p th:if="${T(java.lang.Math).random() > 0.5}">Random number is greater than 0.5</p>

<!-- th:unless -->
<p th:unless="${T(java.lang.Math).random() <= 0.5}">Random number is less or equal to 0.5</p>

<!-- th:switch and th:case -->
<div th:switch="${T(java.lang.Math).PI}">
  <p th:case="${T(java.lang.Math).PI}">PI is equal to PI</p>
  <p th:case="${T(java.lang.Math).E}">PI is equal to E</p>
  <p th:case="*">PI is not equal to any known constants</p>
</div>

<!-- th:href -->
<a th:href="@{'/' + ${T(java.lang.Math).random()}}">Random Link</a>

<!-- th:each -->
<ul>
  <li th:each="item : ${T(java.util.Arrays).asList('Apple', 'Banana', 'Cherry')}">
    <span th:text="${item}">Item</span>
  </li>
</ul>

<!-- th:value -->
<input type="number" th:value="${T(java.lang.Math).PI}" />

<!-- th:with -->
<div th:with="randomNumber=${T(java.lang.Math).random()}">
  <p th:text="${randomNumber}">Random Number</p>
</div>

</body>
</html>

これを画面で表示してみると、こんな感じできちんとエラーなく表示されます。

注意せよ

Thymeleafのバージョンによって、T()関数が使えないthタグが存在するので注意が必要です！

私の調べた感じだと、thymeleaf-spring5ライブラリのバージョン3.0.12.RELEASEとバージョン3.0.13.RELEASEが境界地でした。（org.springframework.bootでいうと、2.6.1と2.6.2）

thタグ	3.0.12以前	3.0.13以後
th:text	T()関数使える	T()関数使える
th:utext	T()関数使える	T()関数使えない
th:if	T()関数使える	T()関数使える
th:unless	T()関数使える	T()関数使える
th:switch	T()関数使える	T()関数使える
th:case	T()関数使える	T()関数使える
th:href	T()関数使える	T()関数使えない
th:each	T()関数使える	T()関数使える
th:value	T()関数使える	T()関数使える
th:with	T()関数使える	T()関数使える

もし、thymeleaf-spring5ライブラリのバージョン3.0.13.RELEASE以降において、th:href内でT()関数を使おうものなら、下記のようなエラーが発生するのでご注意ください。

java.lang.IllegalAccessError: 
class org.thymeleaf.spring5.dialect.SpringStandardDialect tried to access private field org.thymeleaf.standard.StandardDialect.conversionService

以上ですー。