유틸리티 객체

유틸리티 객체(Utility Objects)?

타임리프 템플릿에서 사용할 수 있는 유용한 기능을 제공해주는 객체입니다.

표현식에서 # 뒤에 오는 이름으로 호출합니다.

객체명	설명
#dates	날짜/시간 포맷 및 조작
#strings	문자열 조작
#numbers	숫자 포맷팅
#calendars	Calendar 관련 기능
#lists	List 컬렉션 관련
#sets	Set 컬렉션 관련
#maps	Map 컬렉션 관련
#bools	Boolean 관련
#ids	HTML id 생성
#uris	URI 빌드
#vars	지역 변수 관련
#objects	객체 검사 (null 등)

내장 객체 (Built-in)

Thymeleaf 내부에서 기본 제공되는 객체들:

객체	예시	설명
${#ctx}	${#ctx.locale}	전체 컨텍스트 정보
${#http}	${#httpServletRequest.contextPath}	HTTP 관련 정보
${#session}	${#session.user}	세션 정보
${#request}	${#request.param.name}	Request 정보
${#response}	-	Response 관련

자주 쓰는 유틸 예시

문자열 처리 – #strings

<span th:text="${#strings.toUpperCase(user.name)}"></span>
HTML
복사

함수	설명
toUpperCase()	대문자
toLowerCase()	소문자
contains(str, part)	포함 여부
substring(str, start, end)	부분 문자열

숫자 포맷팅 – #numbers

<p th:text="${#numbers.formatDecimal(price, 2, 'POINT')}"></p>
HTML
복사

함수	설명
formatInteger()	정수 포맷
formatDecimal()	소수점 포맷
round()	반올림

날짜/시간 – #dates

<p th:text="${#dates.format(order.date, 'yyyy-MM-dd')}"></p>
HTML
복사

함수	설명
format(java.util.Date, pattern)	날짜 포맷팅
parse(string, pattern)	날짜 파싱

리스트/컬렉션 – #lists, #sets, #maps

<ul>
  <li th:each="item : ${#lists.sort(products, 'price')}">
    <span th:text="${item.name}"></span>
  </li>
</ul>
HTML
복사

기능	예
리스트 정렬	#lists.sort(list, 'field')
Set 변환	#sets.newHashSet(...)
Map 값 호출	${#maps.get(map, 'key')}

조건/객체 검사 – #objects, #bools

<p th:if="${#objects.nonNull(user)}">Hello!</p>
HTML
복사

함수	설명
nonNull(obj)	Null 아닌지
isEmpty(obj)	비어있는지
isTrue(expr)	Boolean 검사

ID 유일 생성 – #ids

<input th:id="${#ids.next('input_')}" />
HTML
복사

유니크한 id 값 자동 생성

URI 빌드 – #uris

<a th:href="${#uris.uri('/posts/{id}', id=post.id)}">View</a>
HTML
복사

REST API, 링크 빌드에 유용

실전 예제 – 종합

<!DOCTYPE html>
<html lang="ko" xmlns:th="http://www.thymeleaf.org">
<head>
  <meta charset="UTF-8" />
  <title>Example List</title>
</head>
<body>

<h2 th:text="${#strings.toUpperCase('상품 목록')}"></h2>

<table>
  <tr><th>이름</th><th>가격</th><th>등록일</th></tr>
  <tr th:each="p : ${products}">
    <td th:text="${p.name}"></td>
    <td th:text="${#numbers.formatDecimal(p.price,2,'POINT')}"></td>
    <td th:text="${#dates.format(p.createdAt, 'yyyy-MM-dd')}"></td>
  </tr>
</table>

</body>
</html>
HTML
복사

주요 범주

범주	주 사용 기능
문자열	대/소문자, 포함, 자르기
숫자	포맷, 반올림
날짜	포맷, 파싱
컬렉션	정렬, 필드 접근
객체	null/empty 검사
URI/ID	링크 생성, 유니크 ID