오봉이와 함께하는 개발 블로그

스프링 MVC 1 - 타임리프 본문

BE/Thymeleaf

스프링 MVC 1 - 타임리프

오봉봉이 2022. 8. 15. 22:13
728x90

타임리프 간단히 알아보기

타임리프 사용 선언
<html xmlns:th="http://www.thymeleaf.org">

속성 변경 - th:href

th:href="@{/css/bootstrap.min.css}"

  • 기존 html의 href 속성을 th:href="value2"의 값으로 변경된다.
  • 타임리프 뷰 템플릿을 거치게 되면 원래 값을 th:xxx값으로 변경한다.
  • HTML을 그대로 볼 때는 href속성이 사용되고, 뷰 템플릿을 거치면 th:href의 값이 href로 대체되면서 동적으로 변경할 수 있다.
  • 대부분의 속성은 th:xxx로 변경할 수 있다.

타임리프 핵심

  • 핵심은 th:xxx가 붙은 부분은 서버사이드에서 렌더링 되고, 기존 것을 대체한다.
    • th:xxx이 없으면 기존 html의 xxx 속성이 그대로 사용된다.
  • HTML을 파일로 직접 열었을 때, th:xxx가 있어도 웹 브라우저는 th:속성을 알지 못하므로 무시한다.
    • 따라서 HTML을 파일 보기를 유지하면서 템플릿 기능도 할 수 있다.

URL 링크 표현식 - @{...}

th:href="@{/css/bootstrap.min.css}"

  • @{...} : 타임리프는 URL 링크를 사용하는 경우 @{...}를 사용한다.
    • 이것을 URL 링크 표현식이라 한다.
  • URL 링크 표현식을 사용하면 서블릿 컨텍스트를 자동으로 포함한다.

속성 변경 - th:onclick

th:onclick="location.href='addForm.html'"

  • th:onclick="|location.href='@{baisc/items/add}'|"
    • 여기에는 다음에 설명하는 리터럴 대체 문법이 사용되었다.

리터럴 대체 - |...|

|...| : 이렇게 사용하는 것이 리터럴 대체 문법이다.

  • 타임리프에서 문자와 표현식 등은 분리되어 있기 때문에 더해서 사용해야 한다.
    <span th:text="'Welcome to our application, ' + ${user.name} + '!'">
  • 다음과 같이 리터럴 대체 문법을 사용하면 더하기 없이 편리하게 사용할 수 있다.
    <span th:text="|Welcome to our application, ${user.name}!|">

location.href='/basic/items/add'
위 와 같은 결과를 타임리프로 만들어야 하는데 그냥 사용하면 각각 따로 더해서 사용해야 하므로 복잡해진다.
th:onclick="'location.href=' + '\'' + @{/basic/items/add} + '\''"

하지만 리터럴 대체 문법을 사용하면 다음과 같이 편리하게 사용할 수 있다.
th:onclick="|location.href='@{/basic/items/add}'|"

변수 표현식 - ${...}

<td th:text="${item.price}">10000</td>

  • 모델에 표함된 값이나, 타임림프 변수로 선언한 값을 조회할 수 있다.
  • 프로퍼티 접근법을 사용한다.
    • item.getPrice()

내용 변경 - th:text

<td th:text="${item.price}">10000</td>

  • 내용의 값을 th:text의 값으로 변경한다.
  • 여기서는 10000을 ${item.price}의 값으로 변경한다.

속성 변경 - th:value

th:value="${item.id}"

  • 모델(model)에 있는 item 정보를 획득하고 프로퍼티 접근법으로 출력한다.
    • item.getId()
  • value 속성을 th:value 속성으로 변경한다.

속성 변경 - th:action

th:action="/basic/items/add"

  • HTML Form에서 action에 값이 없으면 현재 URL에 데이터를 전송한다.
    • 현재 URL이 /basic/items/add일 때 th:action == th:action="/basic/items/add"
  • 상품 등록 폼의 URL과 실제 상품 등록을 처리하는 URL을 똑같이 맞추고 HTTP 메서드로 두 기능을 구분한다.
    • 상품 등록 폼 : GET -> /basic/items/add
    • 상품 등록 처리 : POST -> /basic/items/add
    • 이렇게 하면 하나의 URL로 등록 폼과 등록 처리를 깔끔하게 처리할 수 있다.

th:if

th:if는 해당 조건이 참이면 실행한다.
th:if="${param.status}"라고 하면 타임리프에서 쿼리 파라미터를 편리하게 조회할 수 있다.

  • param
    • 쿼리 파라미터 조회하겠다는 뜻
  • status
    • param(쿼리 파라미터)에서 status라는 값을 조회한다.
      원래는 컨트롤러에서 모델에 직접 담고 값을 꺼내야 하지만 쿼리 파라미터는 자주 사용하기 때문에 타임리프에서 직접 지원한다.

th:if="${param.status}"를 HTML에서 작성했을 때,
http://localhost:8080/basic/items/3?status=true를 들어가면 th:if가 참이 되어 해당 로직이 실행된다.

URL 링크 표현식2 - @{...}

th:href="@{/basic/items/{itemId}(itemId=${item.id})}"

  • (itemId=${item.id})를 통해 {itemId}의 값을 지정했다.
  • URL 링크 표현식을 사용하면 경로 템플릿을 편리하게 사용할 수 있다.
  • 경로 변수뿐만 아니라 쿼리 파라미터도 생성한다.

URL 링크 간단히

th:href="@{|/basic/items/${item.id}|}"

  • 리터럴 대체 문법을 활용해서 간단히 사용할 수도 있다.

참고

타임리프는 순수 HTML 파일을 웹 브라우저에서 열어도 내용을 확인할 수 있고, 서버를 통해 뷰 템플릿을 거치면 동적으로 변경된 결과를 확인할 수 있다.
JSP는 웹 브라우저에서 그냥 열면 JSP 소스코드와 HTML이 뒤죽박죽 되어 정상적인 확인이 불가능하다.
오직 서버를 통해 JSP를 열어야 한다.

순수 HTML을 그대로 유지하면서 뷰 템플릿도 사용할 수 있는 타임리프의 특징을 네츄럴 템플릿이라한다.

출처 : 인프런 김영한 지식 공유자님 강의 - 스프링 MVC 1편 백엔드 웹 개발 핵심 기술
728x90
Comments