Thymeleaf 3.1 release note

💡 이번 포스팅에서는 타임리프 3.1 버전의 변경사항에 대해 정리해 보도록 하겠습니다.

 

Spring 6.0 그리고 Spring Boot가 3.0 각각 메이저 버전이 올라감에 따라 타임리프 또한 호환성을 맞추기 위해 버전을 3.1로 올렸습니다.

 

자세한 내용은 공식 문서를 참고하시면 좋을 것 같습니다.

 

 

먼저 위 3개의 변경 사항은 Spring과 관련이 있는 부분입니다. Spring에서 6.0와의 호환성을 맞추기 위해 javax.\* 패키지 대신 jakarta.\* 패키지가 사용되고, Spring Security 5.X 에서는 타임리프와 연동하기 위해 thymeleaf-extras-springsecurity5 의존성을 사용했는데 이젠 thymeleaf-extras-springsecurity6 의존성을 사용해야 한다고 합니다.

 

// before - Spring Security 5.X
implementation 'org.thymeleaf.extras:thymeleaf-extras-springsecurity5'

// after - Spring Security 6.X
implementation 'org.thymeleaf.extras:thymeleaf-extras-springsecurity6'

 

 

 

그리고 thymeleaf-extras-java8time 이라는 별도의 모듈이 이제 thymeleaf 코어에 추가됨으로써 #temporals라는 표현식을 기본적으로 사용할 수 있다고 합니다.

Spring 6부터 JDK 17이 최소 요구사항으로 변경함에 따라 타임리프도 3.1 이후부터는 JDK 17 이상이 요구됩니다.

 

 

3.1부터는 보안을 더 강화하기 위한 이유로 더 이상 web 기반의 유틸 객체들을 사용할 수 없다고 합니다. 이제는 사용하려는 값들을 아래 마이그레이션 가이드와 같이 직접 @ModelAttribute를 통해 데이터를 전달해야 합니다.

 

@ModelAttribute("contextPath")
public String contextPath(final HttpServletRequest request) {
    return request.getContextPath();
}

 

 

표현식에서 클래스 사용에 대해 더 엄격하게 제한을 두었다고 합니다. 이 항목은 사실 실제로 사용해 본 적이 없었던 것 같아서 정확히 어떤 내용인지 파악이 안 됩니다.

 

📢 이 부분은 추후 알게 되면 추가해 놓겠습니다.

 

 

th:include가 deprecated 되었습니다. 대신 th:insert를 사용해야 합니다.

그리고 fragment 문법을 사용할 때 ~{}로 감싸줘야 합니다.

 

// code
<div id="main" th:include="~{::frag}">...</div>
...
<p th:fragment="frag" class="content">
    something
</p>

// result
<div id="main">
      something
</div>

// code
<div id="main" th:insert="~{::frag}">...</div>
...
<p th:fragment="frag" class="content">
    something
</p>

// result
<div id="main">
  <p class="content">
      something
  </p>
</div>

 

th:include를 사용하게 되면 fragment 안의 내용만 추가되는데, th:insert를 사용하게 되면 fragment의 태그까지 전부 추가됩니다.

 

이제는 th:insert를 사용해야 하는데 만약 태그 내용까지 추가되는 것이 싫다면 th:remove와 함께 사용하거나 fragment의 태그를 th:block으로 설정하면 th:include와 같은 결과를 낼 수 있습니다.

 

// code
<div id="main" th:insert="~{::frag}">...</div>
...
<p th:fragment="frag" th:remove="tag" class="content">
    something
</p>

// result
<div id="main">
      something
</div>

// code
<div id="main" th:insert="~{::frag}">...</div>
...
<th:block th:fragment="frag">
    something
</th:block>

// result
<div id="main">
      something
</div>

 

그리고 위에서 이미 작성했지만 fragment 문법을 사용할 때 ~{}를 사용해서 감싸줘야 합니다.

 

// before
<div id="top" th:insert="common :: header">...</div>

// after
<div id="top" th:insert="~{common :: header}">...</div>