[Freemarker] No TLD was found for the "http://tiles.apache.org/tags-tiles" JSP taglib URI 오류 조치

Freemarker를 사용하며 tiles 및 spring과 같이 taglib가 필요한 경우가 있다. 그냥 Jsp에서 사용하던대로 

<%@taglib prefix="tiles" uri="http://tiles.apache.org/tags-tiles"%>
<%@taglib prefix="spring" uri="http://www.springframework.org/tags"%>

이런식으로 url을 매핑하여 작성하면

<#assign tiles=JspTaglibs["http://tiles.apache.org/tags-tiles"]>
<#assign spring=JspTaglibs["http://www.springframework.org/tags"]>

이렇게 ftl 파일에서 taglib를 사용하기 위해 다음과 같이 작성을 하였는데 다음과 같은 오류가 발생하였다. 

FreeMarker template error (HTML_DEBUG mode; use RETHROW in production!)

Error while looking for TLD file for "http://tiles.apache.org/tags-tiles"; see cause exception.

----
FTL stack trace ("~" means nesting-related):
	- Failed at: #assign tiles = JspTaglibs["http://ti...  [in template "WEB-INF/freemarker/auigrid/layout/main.ftl" at line 1, column 1]
----

Java stack trace (for programmers):
----
freemarker.template.TemplateModelException: [... Exception message was already printed; see it above ...]
	at freemarker.ext.jsp.TaglibFactory.get(TaglibFactory.java:249)
    
... 중략 ...

Caused by: freemarker.ext.jsp.TaglibFactory$TaglibGettingException: No TLD was found for the "http://tiles.apache.org/tags-tiles" JSP taglib URI. (TLD-s are searched according the JSP 2.2 specification. In development- and embedded-servlet-container setups you may also need the "MetaInfTldSources" and "ClasspathTlds" freemarker.ext.servlet.FreemarkerServlet init-params or the similar system properites.)
	at freemarker.ext.jsp.TaglibFactory.get(TaglibFactory.java:223)

No TLD was found 이게 오류의 핵심이다. 

tld 파일을 못찾는다는건데 시도해본 방법중 되는건 다음 두가지이다.

(참고로 필자는 freemarker와 tiles를 같이 사용중이다. 만드는 샘플은 여기를 눌러보자. )

 

방안 1. tld 파일을 위치시키는 방법

freemarker tld 파일

위의 그림과 같이 resources/META-INF/tld 폴더를 만들고 필요한 tld 파일을 이곳으로 가지고 온다. tld 파일을 가지고 오는 요령은 예를들면 tiles-jsp.tld를 가지고 오고 싶다 하면 다음과 같이 tiles-jsp.jar 에서 가지고 올 수 있다. 

 

tiles-jsp.tld

마찬가지로 spring.tld도 spring-webmvc.jar에서 가지고 올 수 있다. 

이 위치에 필요한 tld 파일을 가지고 오면 taglib을 사용할 수 있게 된다. 하지만 jar 안에도 엄연히 존재하는 tld를 꺼내와서 직접 참조 시키는 방안은 적절하지 않다고 본다. 

 

방안 2. FreemarkerRendererBuilder 를 이용하는 방법

필자는 freemarker를 tiles와 같이 쓰다보니 여러가지 문제가 발생하였고 이를 해결하기 위한 방법중 하나가 TilesConfigurer 정의시에 tiles가 init 되는 시점에 필요한 정보를 집어넣는 것이었다. 

@Bean
public TilesConfigurer tilesConfigurer() {
    TilesConfigurer tilesConfigurer = new TilesConfigurer();
    tilesConfigurer.setCompleteAutoload(true);
    tilesConfigurer.setDefinitions("classpath*:/META-INF/resources/freemarker/layout-definition/tiles-layout.xml");
    tilesConfigurer.setTilesInitializer(new CompleteAutoloadTilesInitializer() {
        @Override
        protected AbstractTilesContainerFactory createContainerFactory(ApplicationContext context) {
            return new CompleteAutoloadTilesContainerFactory() {
                @Override
                protected void registerAttributeRenderers(BasicRendererFactory rendererFactory, ApplicationContext applicationContext, TilesContainer container, AttributeEvaluatorFactory attributeEvaluatorFactory) {
                    super.registerAttributeRenderers(rendererFactory, applicationContext, container, attributeEvaluatorFactory);
                    FreemarkerRendererBuilder freemarkerRenderer = FreemarkerRendererBuilder.createInstance();
                    freemarkerRenderer.setApplicationContext(applicationContext);
                    freemarkerRenderer.setParameter("ContentType", "text/html;charset=UTF-8");
                    freemarkerRenderer.setParameter("default_encoding", "UTF-8");
                    freemarkerRenderer.setParameter("ClasspathTlds", "/META-INF/tld/tiles-jsp.tld, /META-INF/spring.tld");
                    rendererFactory.registerRenderer("freemarker", freemarkerRenderer.build());
                }
            };
        }
    });
    return tilesConfigurer;
}

init 되는 시점에 FreemarkerRendererBuilder를 통해 여러가지 정보를 넣을 수 있고 그중 17번째 라인을 보면 ClasspathTlds 라는 param을 통해 각 jar안에 있는 tld 파일들을 명시할 수 있다. 복수의 tld면 , 로 구분해서 하나의 String으로 넣어주면 된다. 이렇게 하면 방안 1과 같이 직접 tld 파일들을 관리하지 않고 jar안에 있는 tld를 이용할 수 있다. 

 

끝!