본문 바로가기
Mechanic: IT 인터넷/Mechanic, M-Tech

Spring Boot에서 Apache Tiles 적용하기 - ViewResolver 우선순위가 핵심

by M-LOG : 엠로그 2018. 10. 23.
반응형

원본 작성일: 2018.10.23
보완 작성일: 2026.02.14

Spring Boot Tiles ViewResolver 설정

Spring Boot에서 Apache Tiles 레이아웃을 적용했을 때, JSP가 Tiles 레이아웃을 무시하고 직접 렌더링되는 문제를 해결한 기록이다.

2026년 기준: Apache Tiles는 사실상 개발이 멈춘 상태다. 신규 프로젝트라면 Thymeleaf Layout Dialect를 쓰는 게 맞다. 이 글은 레거시 프로젝트를 유지보수하거나, Tiles가 적용된 프로젝트를 이해해야 할 때 참고용으로 남겨둔다.

문제 상황

Spring Boot + JSP 환경에서 Tiles를 설정했는데, 컨트롤러에서 반환하는 뷰 이름이 tiles.xml의 definition을 거치지 않고 JSP 파일로 직접 매핑됐다.

원인: Spring Boot의 기본 InternalResourceViewResolver가 TilesViewResolver보다 먼저 동작해서, Tiles 레이아웃을 적용할 기회가 없었다.

해결: ViewResolver에 order 설정

@Bean(name = "viewResolver")
public TilesViewResolver tilesViewResolver() {
    TilesViewResolver resolver = new TilesViewResolver();
    resolver.setViewClass(TilesView.class);
    resolver.setOrder(1);  // 이게 핵심
    return resolver;
}

setOrder(1)로 TilesViewResolver의 우선순위를 높이면, 뷰 이름이 먼저 Tiles definition과 매칭을 시도한다.

전체 설정

pom.xml

<dependency>
    <groupId>org.apache.tiles</groupId>
    <artifactId>tiles-core</artifactId>
    <version>3.0.8</version>
</dependency>
<dependency>
    <groupId>org.apache.tiles</groupId>
    <artifactId>tiles-servlet</artifactId>
    <version>3.0.8</version>
</dependency>
<dependency>
    <groupId>org.apache.tiles</groupId>
    <artifactId>tiles-jsp</artifactId>
    <version>3.0.8</version>
</dependency>
<dependency>
    <groupId>org.apache.tiles</groupId>
    <artifactId>tiles-el</artifactId>
    <version>3.0.8</version>
</dependency>

application.properties

spring.mvc.view.prefix=/WEB-INF/jsp/
spring.mvc.view.suffix=.jsp

TilesConfig.java

@Configuration
public class TilesConfig {

    @Bean(name = "tilesConfigure")
    public TilesConfigurer tilesConfigurer() {
        final TilesConfigurer configurer = new TilesConfigurer();
        configurer.setDefinitions(new String[]{"/WEB-INF/tiles/tiles.xml"});
        configurer.setCheckRefresh(true);
        return configurer;
    }

    @Bean(name = "viewResolver")
    public TilesViewResolver tilesViewResolver() {
        TilesViewResolver resolver = new TilesViewResolver();
        resolver.setViewClass(TilesView.class);
        resolver.setOrder(1);
        return resolver;
    }
}

tiles.xml

<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE tiles-definitions PUBLIC
    "-//Apache Software Foundation//DTD Tiles Configuration 3.0//EN"
    "http://tiles.apache.org/dtds/tiles-config_3_0.dtd">

<tiles-definitions>
    <definition name="layout-tiles"
                template="/WEB-INF/tiles/layout/default-layout.jsp">
        <put-attribute name="include"  value="/WEB-INF/jsp/common/include.jsp" />
        <put-attribute name="header"   value="/WEB-INF/jsp/common/header.jsp" />
        <put-attribute name="nav"      value="/WEB-INF/jsp/common/nav.jsp" />
        <put-attribute name="jumbotron" value="/WEB-INF/jsp/common/jumbotron.jsp" />
        <put-attribute name="content"  value="" />
        <put-attribute name="footer"   value="/WEB-INF/jsp/common/footer.jsp" />
        <put-attribute name="bootstrapjs" value="/WEB-INF/jsp/common/bootstrapjs.jsp" />
    </definition>

    <!-- */* 패턴: 컨트롤러가 "user/myPage" 반환 → /WEB-INF/jsp/user/myPage.jsp -->
    <definition name="*/*" extends="layout-tiles">
        <put-attribute name="content" value="/WEB-INF/jsp/{1}/{2}.jsp" />
    </definition>
</tiles-definitions>

default-layout.jsp

<%@ page language="java" contentType="text/html; charset=UTF-8" pageEncoding="UTF-8"%>
<%@ taglib uri="http://tiles.apache.org/tags-tiles" prefix="tiles"%>
<!DOCTYPE html>
<html>
<head>
    <tiles:insertAttribute name="include" />
    <tiles:insertAttribute name="header" />
</head>
<body>
    <tiles:insertAttribute name="nav" />
    <tiles:insertAttribute name="jumbotron" />
    <div class="container">
        <tiles:insertAttribute name="content" />
        <hr>
        <tiles:insertAttribute name="footer" />
    </div>
    <tiles:insertAttribute name="bootstrapjs" />
</body>
</html>

정리

설정 역할
TilesConfigurer tiles.xml 위치 지정, Tiles 엔진 초기화
TilesViewResolver 뷰 이름을 Tiles definition과 매칭
setOrder(1) 기본 ViewResolver보다 먼저 동작하게 우선순위 설정
*/* definition 모든 "경로/파일" 패턴에 레이아웃 자동 적용

핵심은 ViewResolver 간 우선순위다. 이 한 줄(setOrder(1)) 빠지면 Tiles가 아무리 잘 설정돼 있어도 무시된다.

반응형
저작자표시 비영리 변경금지 (새창열림)

'Mechanic: IT 인터넷 > Mechanic, M-Tech' 카테고리의 다른 글

Spring Boot Security 커스텀 로그인 (2) - AOP로 사용자 정보 자동 바인딩  (0) 2018.11.07
Spring Boot Security 커스텀 로그인 구현 - 기본편  (0) 2018.10.26
CentOS 7 SSH 포트 변경 - SELinux와 방화벽까지 한 번에  (0) 2018.10.12
리눅스 노트북 덮개 닫아도 전원 유지하는 방법 - logind.conf 설정  (0) 2018.10.12
bash: setlocale LC_CTYPE 경고 해결 - macOS에서 리눅스 서버 SSH 접속 시  (1) 2018.10.05

관련글

티스토리툴바